> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unlingo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Translations

> Retrieve translations for your application

## Overview

This is the primary endpoint for fetching translations from Unlingo. It returns ready-to-use translation data that can be directly integrated with any i18n library.

## Authentication

You can authenticate using either method:

<ParamField header="x-api-key" type="string">
  Your API key passed in the header `x-api-key: YOUR_API_KEY`
</ParamField>

<ParamField header="Authorization" type="string">
  Bearer token with your API key `Authorization: Bearer YOUR_API_KEY`
</ParamField>

## Required Parameters

<ParamField query="release" type="string" required>
  The release tag to fetch translations from **Examples**: `1.0.0`, `staging`, `production`
</ParamField>

<ParamField query="namespace" type="string" required>
  The namespace containing your translations **Examples**: `translation`, `auth`, `dashboard`
</ParamField>

<ParamField query="lang" type="string" required>
  The language code for the translations **Examples**: `en`, `es`, `fr`, `de`, `zh`
</ParamField>

## Example Request

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.unlingo.com/v1/translations?release=1.0.0&namespace=translation&lang=en" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```bash cURL (Bearer) theme={null}
  curl -X GET "https://api.unlingo.com/v1/translations?release=1.0.0&namespace=translation&lang=en" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.unlingo.com/v1/translations?release=1.0.0&namespace=translation&lang=en', {
      headers: {
          'x-api-key': 'YOUR_API_KEY',
      },
  });

  const translations = await response.json();
  ```
</RequestExample>

## Response

The endpoint returns translation data as a JSON object ready for use with i18n libraries. No nested objects - just your translations exactly as they should be used.

<ResponseExample>
  ```json Response theme={null}
  {
      "welcome": "Welcome to our application",
      "login": "Sign In",
      "logout": "Sign Out",
      "nav": {
          "home": "Home",
          "about": "About",
          "contact": "Contact"
      },
      "buttons": {
          "save": "Save",
          "cancel": "Cancel",
          "delete": "Delete"
      },
      "messages": {
          "success": "Operation completed successfully",
          "error": "An error occurred"
      }
  }
  ```
</ResponseExample>