---
title: "List all translation requests"
method: GET
path: "/translation-requests"
tags: ["TranslationRequests"]
---

# List all translation requests

`GET /translation-requests`

## Request

- Base URL: `https://enterprise.knak.io/api/published/v1`
- URL: `https://enterprise.knak.io/api/published/v1/translation-requests`
- Auth: none declared
- TypeScript: <https://skmtc.dev/knak/apis/knak-enterprise-api/docs/translation-requests/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve all [translation requests](#tag/translation_request) that the API user has access to based on their brand scopes.

  **NOTE:** Only translation requests created from custom translation integrations will be visible. Steps to set up a custom translation integration can be found [here](https://help.knak.io/en/articles/9687639-knak-custom-translation-integration-setup-guide).

## Query parameters

- `page` integer
- `per_page` integer
- `filter[status]` string
- `filter[asset_id]` string
- `filter[created_at_before]` string
- `filter[created_at_after]` string
- `sort` string

## Response `200`

OK

- TranslationRequestList
  - `data` TranslationRequestItem[]
    - `type` string
    - `id` string
    - `attributes` TranslationRequestItemAttributes
      - `id` string
      - `language_code` string: The language code of the translation target
      - `source_language_code` string, nullable: The language code of the translation source. If not set, the value will be null
      - `status` 'cancelled' | 'completed' | 'deleted' | 'failed' | 'manually_translating' | 'processing' | 'reopened' | 'requested' | 're_requested'
      - `base_asset_id` string: The ID of the Asset that should be translated
      - `asset_version_id` string: The ID of the Asset Version that should be translated
      - `integration_id` string: The ID of the integration that was used to request the translation
      - `creator_id` string: The ID of the user who requested the translation
      - `notes` string, nullable: Any notes or context relating to the translation request. If not set, the value will be null
      - `due_date` string, nullable: The date the translation is due. If not set, the value will be null
      - `created_at` string
      - `updated_at` string
  - `links` object
    - `first` string
    - `last` string
    - `prev` string, nullable
    - `next` string, nullable
  - `meta` object
    - `current_page` integer
    - `from` integer
    - `last_page` integer
    - `links` object[]
      - `url` string, nullable
      - `label` string
      - `active` boolean
    - `path` string
    - `per_page` integer
    - `to` integer
    - `total` integer

## Other responses

- `401`: Unauthenticated
- `403`: Unauthorized

---

[API](https://skmtc.dev/knak/apis/knak-enterprise-api.md) - [All operations](https://skmtc.dev/knak/apis/knak-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knak/apis/knak-enterprise-api/revisions/31d2c94edfcc?raw)