---
title: "Lists all locales"
method: GET
path: "/locales"
tags: ["Definitions"]
---

# Lists all locales

`GET /locales`

## Request

- Base URL: `https://api.cint.com/v1`
- URL: `https://api.cint.com/v1/locales`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cint/apis/demand-api/docs/locales/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all available locales (a combination of country and language) that are well-supported on the platform. You can use this endpoint to discover which locales are recommended for the best performance and panelist availability. The output will include ISO 3166-1 alpha-2 country codes and associated ISO 639-2/T three-letter language codes. You will use this to form a valid locale string where you specify the three-letter language code, an underscore, and the two-letter country code e.g., eng_us. Use this locale when browsing profile library or creating a target group.

## Response `200`

A list of locales was retrieved successfully.

- Locales: Contains a list of suggested countries and their supported languages.
  - `locales` object[]: A list of suggested locales.
    - `country` object: Contains details for a single country based on the locale.
      - `code` string: The ISO 3166-1 alpha-2 country code.
      - `name` string: The name of the country.
    - `languages` object[]: A list of supported country languages.
      - `is_preferred` boolean: Indicates whether the country language is preferred for the country.
      - `name` string: A human-readable name for the country language.
      - `code` string: The ISO 639-2 (3-letter) language code.

## Other responses

- `400`: A request is not valid and can't be processed.
- `401`: A request is unauthorized.
- `403`: A requested is forbidden.
- `500`: A request failed due to an internal error.

---

[API](https://skmtc.dev/cint/apis/demand-api.md) - [All operations](https://skmtc.dev/cint/apis/demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cint/apis/demand-api/revisions/077a4bdda5cb?raw)
