---
title: "Import translations from file"
method: POST
path: "/api/v2/import"
tags: ["File import & export"]
---

# Import translations from file

`POST /api/v2/import`

## Request

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

Import translations to file

## Query parameters

- `uploadFormat` 'android' | 'android-strings' | 'android-xml' | 'csv-translations' | 'tsv' | 'excel' | 'java-properties' | 'localizable-xcstrings' | 'localizable-strings' | 'localizable-strings-dict' | 'po-pot' | 'php-array' | 'string-resources' | 'simplelocalize-json' | 'single-language-json' | 'multi-language-json' | 'javascript' | 'module-exports' | 'yaml' | 'qt-linguist' | 'resx', required
- `importOptions` string[]
- `languageKey` string
- `customerId` string
- `namespace` string
- `tags` string[]

## Headers

- `X-SimpleLocalize-Token` string, required

## Request body `multipart/form-data`

- string, binary

## Response `200`

OK

- object
  - `msg` string
  - `status` integer
  - `data` ImportFileResponseV2
    - `numberOfKeysFound` integer
    - `numberOfUniqueKeysFound` integer
    - `foundLanguages` Language[]
      - `key` string
      - `name` string
      - `isDefault` boolean
      - `order` integer
      - `flag` string
      - `access` 'WRITE_READ' | 'READ' | 'HIDDEN'
      - `translationProvider` 'GOOGLE_TRANSLATE' | 'DEEPL' | 'OPEN_AI' | 'OPEN_ROUTER' | 'CUSTOM_AI' | 'ANTHROPIC' | 'GEMINI' | 'SIMPLELOCALIZE_AI' | 'EXTERNAL_API' | 'SYSTRAN' | 'PSEUDO_TRANSLATE' | 'TRANSLATION_MEMORY' | 'DISABLED'
      - `providerLanguage` string
      - `sourceLanguage` string
      - `deeplFormality` string
      - `isLocked` boolean
      - `attributes` object
      - `context` string
      - `fallbackLanguage` string

## 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`: 5 warning, 4 info
  - added the new `ANTHROPIC` enum value to the `data/foundLanguages/items/translationProvider` response property for the response status `200`
  - added the new `CUSTOM_AI` enum value to the `data/foundLanguages/items/translationProvider` response property for the response status `200`
  - added the new `GEMINI` enum value to the `data/foundLanguages/items/translationProvider` response property for the response status `200`
  - added the new `PSEUDO_TRANSLATE` enum value to the `data/foundLanguages/items/translationProvider` response property for the response status `200`
  - …5 more
- **2025-11-20** `6ed553100cd5`: 1 warning
  - added the new `TRANSLATION_MEMORY` enum value to the `data/foundLanguages/items/translationProvider` response property for the response status `200`
- **2025-11-12** `0329534cd557`: 2 warning, 18 info
  - added the new `DISABLED` enum value to the `data/foundLanguages/items/translationProvider` response property for the response status `200`
  - added the new `OPEN_ROUTER` enum value to the `data/foundLanguages/items/translationProvider` response property for the response status `200`
  - api operation id `importFromApi` removed and replaced with `importTranslations`
  - the endpoint scheme security `Project API Key` was added to the API
  - …16 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/changes/api/v2/import/post.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)