---
title: "Get supported languages"
method: GET
path: "/translate/languages"
tags: ["Media AI — Translation"]
---

# Get supported languages

`GET /translate/languages`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/translate/languages`
- Auth: HTTP bearer

Translation language catalog: GET /translate/languages. Returns 35 language codes with names, target_locale variants (de-DE/AT/CH, en-US/GB/AU/CA, es-ES/419/MX, fr-*, pt-*, nl-*, it-*, zh-*, ar-*), tiers (basic/premium/ultra)...

## Response `200`

Success

- object
  - `_billing` object
    - `credits` object
      - `total_monthly` integer
      - `remaining_monthly` integer
      - `credit_source` string
      - `api_handler` string
      - `tier_info` object
        - `tier` string
        - `name` string
        - `initial_credits` integer
        - `price_monthly` integer
        - `price_overage_per_credit` integer
      - `notice` string
      - `renewal_days` integer
      - `subscription_status` string
    - `job` object
      - `api_job_name` string
      - `app` string
      - `action` string
      - `default_credits` integer
      - `credits_billed` integer
      - `pricing` object
        - `credits_per_unit` integer
        - `unit` string
        - `unit_count` integer
        - `addons` string
    - `requests` object
      - `limits` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `current` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `remaining` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `next_possible_request_seconds` integer
    - `remaining_credits` integer
    - `total_monthly` integer
    - `account_id` integer
    - `plan` object
      - `tier` string
      - `name` string
    - `credits_billed` integer
  - `data` object
    - `languages` object
      - `de` object
        - `name` string
        - `flag` string
        - `native` string
      - `en` object
        - `name` string
        - `flag` string
        - `native` string
      - `es` object
        - `name` string
        - `flag` string
        - `native` string
      - `fr` object
        - `name` string
        - `flag` string
        - `native` string
      - `it` object
        - `name` string
        - `flag` string
        - `native` string
      - `pt` object
        - `name` string
        - `flag` string
        - `native` string
      - `nl` object
        - `name` string
        - `flag` string
        - `native` string
      - `pl` object
        - `name` string
        - `flag` string
        - `native` string
      - `cs` object
        - `name` string
        - `flag` string
        - `native` string
      - `ru` object
        - `name` string
        - `flag` string
        - `native` string
      - `zh` object
        - `name` string
        - `flag` string
        - `native` string
      - `ja` object
        - `name` string
        - `flag` string
        - `native` string
      - `ko` object
        - `name` string
        - `flag` string
        - `native` string
      - `ar` object
        - `name` string
        - `flag` string
        - `native` string
      - `tr` object
        - `name` string
        - `flag` string
        - `native` string
      - `sv` object
        - `name` string
        - `flag` string
        - `native` string
      - `da` object
        - `name` string
        - `flag` string
        - `native` string
      - `no` object
        - `name` string
        - `flag` string
        - `native` string
      - `fi` object
        - `name` string
        - `flag` string
        - `native` string
      - `hu` object
        - `name` string
        - `flag` string
        - `native` string
      - `ro` object
        - `name` string
        - `flag` string
        - `native` string
      - `uk` object
        - `name` string
        - `flag` string
        - `native` string
      - `th` object
        - `name` string
        - `flag` string
        - `native` string
      - `vi` object
        - `name` string
        - `flag` string
        - `native` string
      - `id` object
        - `name` string
        - `flag` string
        - `native` string
      - `hi` object
        - `name` string
        - `flag` string
        - `native` string
      - `he` object
        - `name` string
        - `flag` string
        - `native` string
      - `sk` object
        - `name` string
        - `flag` string
        - `native` string
      - `sl` object
        - `name` string
        - `flag` string
        - `native` string
      - `bg` object
        - `name` string
        - `flag` string
        - `native` string
      - `hr` object
        - `name` string
        - `flag` string
        - `native` string
      - `sr` object
        - `name` string
        - `flag` string
        - `native` string
      - `et` object
        - `name` string
        - `flag` string
        - `native` string
      - `lv` object
        - `name` string
        - `flag` string
        - `native` string
      - `lt` object
        - `name` string
        - `flag` string
        - `native` string
    - `default_base` string
    - `total` integer
    - `tiers` unknown[]
      - unknown
    - `default_tier` string
    - `max_input_chars` integer
    - `preserve_terms` object
      - `type` string
      - `max_items` integer
      - `max_chars` integer
      - `description` string
      - `example` unknown[]
        - unknown
    - `preserve_terms_preset` object
      - `type` string
      - `description` string
      - `available_presets` unknown[]
        - unknown
      - `example` string
      - `notes` string
    - `target_locale` object
      - `type` string
      - `description` string
      - `bases` unknown[]
        - unknown
      - `variants` object
        - `ar` object[]
          - `code` string
          - `label` string
          - `instruction` string
        - `de` object[]
          - `code` string
          - `label` string
          - `instruction` string
        - `en` object[]
          - `code` string
          - `label` string
          - `instruction` string
        - `es` object[]
          - `code` string
          - `label` string
          - `instruction` string
        - `fr` object[]
          - `code` string
          - `label` string
          - `instruction` string
        - `it` object[]
          - `code` string
          - `label` string
          - `instruction` string
        - `nl` object[]
          - `code` string
          - `label` string
          - `instruction` string
        - `pt` object[]
          - `code` string
          - `label` string
          - `instruction` string
        - `zh` object[]
          - `code` string
          - `label` string
          - `instruction` string
      - `example` string
    - `style` object
      - `type` string
      - `description` string
      - `supported` unknown[]
        - unknown
      - `default` string
    - `tone` object
      - `type` string
      - `supported` unknown[]
        - unknown
      - `default` string
    - `mode` object
      - `type` string
      - `supported` unknown[]
        - unknown
      - `aliases` object
        - `rewrite` string
      - `default` string
      - `description` string
    - `error_codes` object
      - `AUTH_REQUIRED` string
      - `INVALID_REQUEST` string
      - `INVALID_TARGET_LANGUAGE` string
      - `INVALID_SOURCE_LANGUAGE` string
      - `INVALID_TARGET_LOCALE` string
      - `CORRECT_REQUIRES_SOURCE` string
      - `INVALID_PRESET` string
      - `EMPTY_TEXT` string
      - `INPUT_TOO_LARGE` string
      - `ARRAY_TOO_LARGE` string
      - `JSON_STRUCTURE_TOO_LARGE` string
      - `TRANSLATE_RATE_LIMITED` string
      - `TRANSLATION_FAILED` string
      - `TRANSLATION_EMPTY` string
      - `TRANSLATION_TIMEOUT` string
      - `UNKNOWN_COMMAND` string
    - `version` string
  - `processing_time` string
  - `status` string

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)
