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

# Get Organisation Languages

> Retrieve the list of languages supported by an organisation, including full locale metadata for each language code.

## Overview

The `/v2/org-languages` endpoint returns the full language configuration for an organisation. Use it to discover which languages are available before making localised content requests (e.g. passing `lang` to guide-search or listing-search).

When `translationEnabled` is `false`, only the default language is available and the `languages` array will be empty.

## Request

```http theme={null}
GET /v2/orgs/{orgId}/org-languages
```

### Required parameters

| Parameter | Type   | Description           |
| --------- | ------ | --------------------- |
| `orgId`   | string | Your organisation ID. |

## Examples

### Retrieve supported languages

```bash Retrieve supported languages theme={null}
curl "https://api.obvlo.com/v2/orgs/YOUR_ORG_ID/org-languages?key=YOUR_API_KEY"
```

### Example response — translations enabled

```json Example response (translations enabled) expandable theme={null}
{
  "translationEnabled": true,
  "defaultLanguage": {
    "languageCode": "en-GB",
    "languageName": "English",
    "dialect": "British",
    "nativeName": "English",
    "isDefault": true,
    "isEnabled": true,
    "flagIconUrl": "https://cdn.obvlo.com/flags/gb.svg",
    "rtl": false,
    "currencyCode": "GBP",
    "currencySymbol": "£",
    "hour12": true,
    "measurement": "metric",
    "temperatureMetric": "celsius",
    "isLatinAlphabet": true
  },
  "languages": [
    {
      "languageCode": "en-GB",
      "languageName": "English",
      "dialect": "British",
      "nativeName": "English",
      "isDefault": true,
      "isEnabled": true,
      "flagIconUrl": "https://cdn.obvlo.com/flags/gb.svg",
      "rtl": false,
      "currencyCode": "GBP",
      "currencySymbol": "£",
      "hour12": true,
      "measurement": "metric",
      "temperatureMetric": "celsius",
      "isLatinAlphabet": true
    },
    {
      "languageCode": "fr-FR",
      "languageName": "French",
      "dialect": "Standard",
      "nativeName": "Français",
      "isDefault": false,
      "isEnabled": true,
      "flagIconUrl": "https://cdn.obvlo.com/flags/fr.svg",
      "rtl": false,
      "currencyCode": "EUR",
      "currencySymbol": "€",
      "hour12": false,
      "measurement": "metric",
      "temperatureMetric": "celsius",
      "isLatinAlphabet": true
    }
  ]
}
```

### Example response — translations disabled

```json Example response (translations disabled) theme={null}
{
  "translationEnabled": false,
  "defaultLanguage": {
    "languageCode": "en-GB",
    "languageName": "English",
    "dialect": "British",
    "nativeName": "English",
    "isDefault": true,
    "isEnabled": true,
    "flagIconUrl": "https://cdn.obvlo.com/flags/gb.svg",
    "rtl": false,
    "currencyCode": "GBP",
    "currencySymbol": "£",
    "hour12": true,
    "measurement": "metric",
    "temperatureMetric": "celsius",
    "isLatinAlphabet": true
  },
  "languages": []
}
```

## Response fields

### Top-level

| Field                | Type    | Description                                                                                 |
| -------------------- | ------- | ------------------------------------------------------------------------------------------- |
| `translationEnabled` | boolean | Whether this organisation has multilingual content enabled.                                 |
| `defaultLanguage`    | object  | Full locale metadata for the organisation's default language. Always present.               |
| `languages`          | array   | Full locale metadata for each enabled language. Empty when `translationEnabled` is `false`. |

### Language object

| Field               | Type    | Description                                                     |
| ------------------- | ------- | --------------------------------------------------------------- |
| `languageCode`      | string  | BCP 47 language code (e.g. `en-GB`, `fr-FR`).                   |
| `languageName`      | string  | English name of the language.                                   |
| `dialect`           | string  | Regional dialect label (e.g. `British`, `Standard`).            |
| `nativeName`        | string  | Language name in its own script (e.g. `Français`).              |
| `isDefault`         | boolean | `true` for the organisation's default language.                 |
| `isEnabled`         | boolean | Whether this language is enabled in the platform.               |
| `flagIconUrl`       | string  | URL to a flag icon representing the language's region.          |
| `rtl`               | boolean | `true` if the language is right-to-left (e.g. Arabic, Hebrew).  |
| `currencyCode`      | string  | ISO 4217 currency code associated with the locale (e.g. `GBP`). |
| `currencySymbol`    | string  | Display symbol for the currency (e.g. `£`).                     |
| `hour12`            | boolean | `true` if the locale uses a 12-hour clock.                      |
| `measurement`       | string  | Unit system: `metric` or `imperial`.                            |
| `temperatureMetric` | string  | `celsius` or `fahrenheit`.                                      |
| `isLatinAlphabet`   | boolean | `true` if the language uses the Latin alphabet.                 |


## OpenAPI

````yaml GET /v2/orgs/{orgId}/org-languages
openapi: 3.0.3
info:
  title: Obvlo Content Engine
  description: Obvlo Content Engine API
  version: 4.0.0
servers:
  - url: https://api.obvlo.com
security: []
paths:
  /v2/orgs/{orgId}/org-languages:
    get:
      tags:
        - V2 Multilingual
      description: >-
        Returns the list of languages supported by the organization. When
        translationEnabled is false, only the default language is returned.
      operationId: v2GetOrgLanguages
      parameters:
        - name: orgId
          in: path
          required: true
          description: Organization Account Number
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  translationEnabled:
                    type: boolean
                  defaultLanguage:
                    type: object
                    properties:
                      languageCode:
                        type: string
                      languageName:
                        type: string
                      dialect:
                        type: string
                      nativeName:
                        type: string
                      isDefault:
                        type: boolean
                      isEnabled:
                        type: boolean
                      flagIconUrl:
                        type: string
                      rtl:
                        type: boolean
                      currencyCode:
                        type: string
                      currencySymbol:
                        type: string
                      hour12:
                        type: boolean
                      measurement:
                        type: string
                      temperatureMetric:
                        type: string
                      isLatinAlphabet:
                        type: boolean
                    required:
                      - languageCode
                      - languageName
                      - dialect
                      - nativeName
                      - isDefault
                      - isEnabled
                      - flagIconUrl
                      - currencyCode
                      - currencySymbol
                      - hour12
                      - measurement
                      - temperatureMetric
                      - isLatinAlphabet
                    additionalProperties: false
                  languages:
                    type: array
                    items:
                      type: object
                      properties:
                        languageCode:
                          type: string
                        languageName:
                          type: string
                        dialect:
                          type: string
                        nativeName:
                          type: string
                        isDefault:
                          type: boolean
                        isEnabled:
                          type: boolean
                        flagIconUrl:
                          type: string
                        rtl:
                          type: boolean
                        currencyCode:
                          type: string
                        currencySymbol:
                          type: string
                        hour12:
                          type: boolean
                        measurement:
                          type: string
                        temperatureMetric:
                          type: string
                        isLatinAlphabet:
                          type: boolean
                      required:
                        - languageCode
                        - languageName
                        - dialect
                        - nativeName
                        - isDefault
                        - isEnabled
                        - flagIconUrl
                        - currencyCode
                        - currencySymbol
                        - hour12
                        - measurement
                        - temperatureMetric
                        - isLatinAlphabet
                      additionalProperties: false
                required:
                  - translationEnabled
                  - defaultLanguage
                  - languages
                additionalProperties: false
        '400':
          description: No matches
      security:
        - api_key: []
components:
  securitySchemes:
    api_key:
      type: apiKey
      name: key
      in: query

````