---
title: "Import Lokalise"
method: POST
path: "/v1/projects/{project_id}/lokalise/import"
tags: ["lokalise"]
---

# Import Lokalise

`POST /v1/projects/{project_id}/lokalise/import`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/projects/{project_id}/lokalise/import`
- Auth: none declared

## Path parameters

- `project_id` string, required

## Request body

- LokaliseImportIn
  - `lokalise_api_token` string, required: The caller's Lokalise API token. Used once; never stored, never logged.
  - `lokalise_project_id` string, required: Lokalise project id to pull from
  - `namespace_slug` string: Sonenta namespace all imported keys land in (V1: single bucket)
  - `language_map` object, nullable: Optional override mapping `{lokalise_iso: sonenta_code}`. Lokalise languages not in the map default to exact-code match against the Sonenta project; unmatched languages are skipped with a warning.
  - `version` string, nullable: Sonenta version slug to write into (default: production)
  - `status` 'draft' | 'translated': Status applied to imported translation rows
  - `dry_run` boolean: Fetch + plan but don't write — useful to preview the mapping

## Response `200`

Successful Response

- LokaliseImportReport
  - `project_uuid` string, required
  - `lokalise_project` object, required
  - `namespace_slug` string, required
  - `version_slug` string, nullable, required
  - `languages_seen` string[], required
  - `languages_imported` string[], required
  - `languages_skipped` object[], required
  - `keys_created` integer, required
  - `keys_reused` integer, required
  - `keys_skipped` integer, required
  - `translations_created` integer, required
  - `translations_updated` integer, required
  - `translations_unchanged` integer, required
  - `plural_keys_marked` integer, required
  - `per_language` LokaliseLanguageReport[], required
    - `lokalise_iso` string, required
    - `sonenta_code` string, nullable, required
    - `keys` integer, required
    - `translations_created` integer, required
    - `translations_updated` integer, required
    - `translations_unchanged` integer, required
  - `warnings` string[], required
  - `dry_run` boolean, required

## Other responses

- `422`: Validation Error

---

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