---
title: "Get Locales"
method: GET
path: "/v2.0/locales"
tags: ["Locales"]
---

# Get Locales

`GET /v2.0/locales`

Gets [Locales](https://docs.cognigy.com/ai/resources/manage/localization/) in a Project. By default, 25 Locales are returned. To change this value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.

## Query parameters

- `projectId` string
- `filter` string
- `limit` integer
- `skip` integer
- `sort` string
- `next` string
- `previous` string

## Headers

- `Accept` 'application/json' | 'application/hal+json' | 'application/xml' | 'text/xml' | 'text/csv'

## Response `200`

Paginated array of Locales retrieved.

- object
  - `items` object[]
    - `name` string — The name of the Locale
    - `nluLanguage` 'ge-GE' | 'da-DK' | 'en-AU' | 'en-CA' | 'en-IN' | 'en-GB' | 'en-US' | 'de-DE' | 'ja-JP' | 'ko-KR' | 'es-ES' | 'nl-NL' | 'ar-AE' | 'fi-FI' | 'fr-FR' | 'it-IT' | 'nn-NO' | 'pl-PL' | 'sv-SE' | 'th-TH' | 'zh-CN' | 'vi-VN' | 'pt-BR' | 'ru-RU' | 'pt-PT' | 'tr-TR' | 'hi-IN' | 'bn-IN' | 'ta-IN' — A supported BCP 47 language tag for NLU.
    - `primary` boolean
    - `fallbackLocaleReference` string
    - `_id` string
    - `createdAt` integer — Unix-timestamp
    - `lastChanged` integer — Unix-timestamp
    - `createdBy` string
    - `lastChangedBy` string
  - `total` integer
  - `nextCursor` string, nullable
  - `previousCursor` string, nullable

## Other responses

- `400` — The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)
- `401` — The request has not been applied because it lacks valid authentication credentials for the target resource.
- `402` — Upgrade your Plan to increase your Quota.
- `403` — The server understood the request but refuses to authorize it.
- `404` — The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.
- `405` — The method received in the request-line is known by the origin server but not supported by the target resource.
- `409` — The request conflicts with current state of the server.
- `413` — The request entity is larger than limits defined by server.
- `500` — The server encountered an unexpected condition that prevented it from fulfilling the request.
- `501` — The server does not support the functionality required to fulfill the request.
- `502` — The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.
- `503` — The server is not ready to handle the request.
- `504` — The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.

---

[API](https://skmtc.net/cognigy/apis/simulator-openapi-rest-ful-api-reference.md) · [All operations](https://skmtc.net/cognigy/apis/simulator-openapi-rest-ful-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cognigy/simulator-openapi-rest-ful-api-reference/revisions/85b2872bdfb7/schema)
