---
title: "Get translations"
method: GET
path: "/api/v2/translations"
tags: ["Translations"]
---

# Get translations

`GET /api/v2/translations`

## Request

- Base URL: `https://api.simplelocalize.io`
- URL: `https://api.simplelocalize.io/api/v2/translations`
- Auth: API key in header `X-SimpleLocalize-Token`
- TypeScript: <https://skmtc.dev/simplelocalize/apis/simplelocalize-api/docs/api/v2/translations/get.ts> (a function with typed inputs; its response is checked against the schema)

Get translations for a project

## Query parameters

- `key` string: Filter by translation key
- `namespace` string: Filter by namespace
- `language` string: Filter by language key
- `text` string: Search by translation text (case-insensitive, uses 'contains'). Minimum length: 3 characters. Limits results to 10.
- `query` string: Search by translation text or translation key (case-insensitive, uses 'contains'). Minimum length: 3 characters. Limits results to 10.
- `textStatus` 'EMPTY' | 'NOT_EMPTY' | '': Filter by translation text status
- `customerId` string: Filter by customer id (Business plan only)
- `baseOnly` boolean: Use `true` to get translations without customer translations, default value is `false` (Business plan only)
- `reviewStatus` 'REVIEWED' | 'NOT_REVIEWED' | '': Filter by review status
- `page` integer: Page number
- `size` integer: Page size
- `sortBy` '' | 'lastModifiedAt': Sort by field
- `sortOrder` 'asc' | 'desc': Sort order
- `version` 'REVIEWED': Use `REVIEWED` to get last reviewed version of translations if exists, otherwise it returns empty text

## Response `200`

OK

- object
  - `msg` string
  - `status` integer
  - `data` union
    - PagedModelApiTranslationResponseV2
      - `content` ApiTranslationResponseV2[]
        - `key` string: Translation key
        - `namespace` string: Namespace
        - `language` string: Language key
        - `customerId` string: Customer ID (Business Plan only)
        - `text` string: Translation text
        - `reviewStatus` 'NOT_REVIEWED' | 'REVIEWED': Status of the translation review
        - `review` ReviewDetails
          - `by` string: Email of the user who set reviewStatus to REVIEWED
          - `at` string: When reviewStatus was set to REVIEWED
        - `lastModifiedAt` string: When translation was last modified
      - `page` PageMetadata
        - `size` integer
        - `number` integer
        - `totalElements` integer
        - `totalPages` integer
    - PagedTranslationsV2RestResponse
      - `msg` string: Message
      - `status` integer: Status code
      - `data` ApiTranslationResponseV2[]: Response data
        - `key` string: Translation key
        - `namespace` string: Namespace
        - `language` string: Language key
        - `customerId` string: Customer ID (Business Plan only)
        - `text` string: Translation text
        - `reviewStatus` 'NOT_REVIEWED' | 'REVIEWED': Status of the translation review
        - `review` ReviewDetails
          - `by` string: Email of the user who set reviewStatus to REVIEWED
          - `at` string: When reviewStatus was set to REVIEWED
        - `lastModifiedAt` string: When translation was last modified
      - `pageDetails` PageDetails
        - `totalElements` integer
        - `totalPages` integer
        - `currentPage` integer
        - `hasNext` boolean
        - `first` boolean
        - `last` boolean

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-11-07** `67a25a25863a`: 4 warning, 2 info
  - added the new `NOT_REVIEWED` enum value to the `data/oneOf[#/components/schemas/PagedModelApiTranslationResponseV2]/content/items/reviewStatus` response property for the response status `200`
  - added the new `NOT_REVIEWED` enum value to the `data/oneOf[#/components/schemas/PagedTranslationsV2RestResponse]/data/items/reviewStatus` response property for the response status `200`
  - added the new `REVIEWED` enum value to the `data/oneOf[#/components/schemas/PagedModelApiTranslationResponseV2]/content/items/reviewStatus` response property for the response status `200`
  - added the new `REVIEWED` enum value to the `data/oneOf[#/components/schemas/PagedTranslationsV2RestResponse]/data/items/reviewStatus` response property for the response status `200`
  - …2 more
- **2025-11-12** `0329534cd557`: 5 breaking, 2 warning, 24 info
  - for the `query` request parameter `reviewStatus`, default value `` was added
  - for the `query` request parameter `textStatus`, default value `` was added
  - the response's body type changed from `object` to no type for status `200`
  - added `#/components/schemas/PagedModelApiTranslationResponseV2, #/components/schemas/PagedTranslationsV2RestResponse` to the `data` response property `oneOf` list for the response status `200`
  - …27 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/changes/api/v2/translations/get.md)

---

[API](https://skmtc.dev/simplelocalize/apis/simplelocalize-api.md) - [All operations](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/llms.txt) - [OpenAPI document](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/revisions/67a25a25863a?raw)