> For the complete documentation index, see [llms.txt](https://docs.adaptria.locaria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptria.locaria.com/client-api/reference/languages.md).

# 🌍 Languages

### Languages

Languages are used for LINGUISTICS services (translation, localization).

#### Language Categories

Languages are organized into:

* **Suggested Languages**: Based on your company's previous projects and preferences
* **Other Languages**: All other supported languages

#### Using Languages in RFQs

When creating an RFQ with LINGUISTICS services, you'll need:

* **sourceLanguageId**: The language of your source content
* **targetLanguageIds**: Array of languages to translate into

#### Language Codes

We use ISO 639-1 (2-character) codes where available, falling back to ISO 639-3 (3-character) for languages without a 2-character code.

Get available languages from the endpoints below.

## 🌍 Get Available Languages

> \## Get Languages for Translation Services\
> \
> Retrieve available languages for your company's translation and localization projects.\
> \
> \### Language Categories\
> \
> Languages are returned in two groups:\
> \
> 1\. \*\*Suggested Languages\*\*: Languages your company frequently uses, based on:\
>    \- Previous project history\
>    \- Company language preferences\
>    \- Most common translation pairs\
> \
> 2\. \*\*Other Languages\*\*: All other supported languages\
> \
> \### Using Languages in RFQs\
> \
> When creating an RFQ, use the \`id\` field from the language objects:\
> \
> \- \`sourceLanguageId\`: The \`id\` of the source language (e.g., \`"3ebf026a-578b-46cb-b4a5-de4b54bab575"\`)\
> \- \`targetLanguageIds\`: Array of \`id\` values for target languages (e.g., \`\["7da3f046-8d67-4cdc-beea-8e9afdaeaf30"]\`)\
> \
> \*\*Example\*\*:\
> \`\`\`json\
> {\
>   "serviceId": "...",\
>   "type": "LINGUISTICS",\
>   "sourceLanguageId": "3ebf026a-578b-46cb-b4a5-de4b54bab575",  ← Use the 'id' field\
>   "targetLanguageIds": \["7da3f046-8d67-4cdc-beea-8e9afdaeaf30"]  ← Use the 'id' field\
> }\
> \`\`\`\
> \
> \### Response Fields\
> \
> Each language object includes:\
> \- \`id\`: \*\*Use this in RFQ creation\*\* - Unique language identifier (UUID)\
> \- \`name\`: Human-readable language name (e.g., "Danish", "English (UK)")\
> \- \`iso639Code\`: ISO 639 language code (can be numeric or alphanumeric)\
> \- \`isActive\`: Whether the language is currently active\
> \- \`createdAt\`: Timestamp when the language was created\
> \- \`updatedAt\`: Timestamp when the language was last updated

````json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Client","version":"1.0.0"},"tags":[{"name":"🌍 Languages","description":"## Languages\n\nLanguages are used for LINGUISTICS services (translation, localization).\n\n### Language Categories\n\nLanguages are organized into:\n- **Suggested Languages**: Based on your company's previous projects and preferences\n- **Other Languages**: All other supported languages\n\n### Using Languages in RFQs\n\nWhen creating an RFQ with LINGUISTICS services, you'll need:\n- **sourceLanguageId**: The language of your source content\n- **targetLanguageIds**: Array of languages to translate into\n\n### Language Codes\n\nWe use ISO 639-1 (2-character) codes where available, falling back to ISO 639-3 (3-character) for languages without a 2-character code.\n\nGet available languages from the endpoints below.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"## Auth0 Bearer Token\n\nFor first-party clients that already authenticate against Auth0, send the JWT in\nthe `Authorisation` header as `Bearer <token>`."}},"schemas":{"GetLanguagesResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"suggestedLanguages":{"type":"array","items":{"$ref":"#/components/schemas/PublicLanguage"},"description":"Languages commonly used by your company.\n\nThese are prioritized based on your previous projects and company preferences."},"otherLanguages":{"type":"array","items":{"$ref":"#/components/schemas/PublicLanguage"},"description":"All other available languages not in the suggested list"}},"required":["suggestedLanguages","otherLanguages"],"description":"Categorized language lists"}},"required":["success","data"]},"PublicLanguage":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"**Language ID - Use this in RFQ creation!** Unique identifier for the language."},"name":{"type":"string","description":"English name of the language"},"iso639Code":{"type":"string","description":"ISO 639 language code (can be 2 or 3 characters, or numeric)"},"isActive":{"type":"boolean","description":"Whether the language is currently active"},"createdAt":{"type":"string","description":"ISO timestamp when the language was created"},"updatedAt":{"type":"string","description":"ISO timestamp when the language was last updated"}},"required":["id","name","iso639Code","isActive","createdAt","updatedAt"]}}},"paths":{"/api/public/v1/client/languages":{"get":{"summary":"🌍 Get Available Languages","description":"## Get Languages for Translation Services\n\nRetrieve available languages for your company's translation and localization projects.\n\n### Language Categories\n\nLanguages are returned in two groups:\n\n1. **Suggested Languages**: Languages your company frequently uses, based on:\n   - Previous project history\n   - Company language preferences\n   - Most common translation pairs\n\n2. **Other Languages**: All other supported languages\n\n### Using Languages in RFQs\n\nWhen creating an RFQ, use the `id` field from the language objects:\n\n- `sourceLanguageId`: The `id` of the source language (e.g., `\"3ebf026a-578b-46cb-b4a5-de4b54bab575\"`)\n- `targetLanguageIds`: Array of `id` values for target languages (e.g., `[\"7da3f046-8d67-4cdc-beea-8e9afdaeaf30\"]`)\n\n**Example**:\n```json\n{\n  \"serviceId\": \"...\",\n  \"type\": \"LINGUISTICS\",\n  \"sourceLanguageId\": \"3ebf026a-578b-46cb-b4a5-de4b54bab575\",  ← Use the 'id' field\n  \"targetLanguageIds\": [\"7da3f046-8d67-4cdc-beea-8e9afdaeaf30\"]  ← Use the 'id' field\n}\n```\n\n### Response Fields\n\nEach language object includes:\n- `id`: **Use this in RFQ creation** - Unique language identifier (UUID)\n- `name`: Human-readable language name (e.g., \"Danish\", \"English (UK)\")\n- `iso639Code`: ISO 639 language code (can be numeric or alphanumeric)\n- `isActive`: Whether the language is currently active\n- `createdAt`: Timestamp when the language was created\n- `updatedAt`: Timestamp when the language was last updated","tags":["🌍 Languages"],"parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Filter languages by name or code"},{"name":"companyId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"description":"Company ID to filter languages. Required to scope results to a specific company."}],"responses":{"200":{"description":"Languages retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetLanguagesResponse"}}}},"401":{"description":"Authentication required"},"403":{"description":"Access denied"}}}}}}
````