Languages endpoints

Manage which languages are active for a project.

Overview

Languages must be registered before translation values can be served for them. The set of active languages for a project is stored in the project_languages table and is separate from the actual translation values.

---

GET /v1/languages

List all languages registered for the project.

Request

GET https://sapi.i18nme.com/v1/languages

Header	Required	Description
X-API-Key	✅	Your project API key

Response

200 OK

{
  "project_id": "3fa85f64-...",
  "languages": [
    { "code": "en", "added_at": "2026-01-10T09:00:00Z" },
    { "code": "pl", "added_at": "2026-01-10T09:00:00Z" },
    { "code": "de", "added_at": "2026-02-01T14:30:00Z" }
  ],
  "count": 3
}

---

POST /v1/languages

Add a language to the project.

Plan limits

The number of active languages depends on your subscription plan. The API returns 402 Payment Required when the limit is reached.

Plan	Languages per project
Free	2
Solo / Team / Business	Unlimited

Request

POST https://sapi.i18nme.com/v1/languages
Content-Type: application/json

Header	Required	Description
X-API-Key	✅	Your project API key

{
  "code": "de"
}

Language codes must use BCP-47 format: two or three lowercase letters, optionally followed by a hyphen and a two-to-four letter region subtag (e.g. en, en-US, zh-Hant).

Response

201 Created

{
  "project_id": "3fa85f64-...",
  "code": "de",
  "added": true
}

402 Payment Required — language limit reached for your plan.

---

DELETE /v1/languages/

Remove a language from the project. This also permanently deletes all translation values for that language across every key in the project.

Irreversible

All translation values for the removed language will be permanently deleted. This cannot be undone.

Request

DELETE https://sapi.i18nme.com/v1/languages/{code}

Parameter	In	Required	Description
code	path	✅	BCP-47 language code to remove

Response

200 OK

{
  "project_id": "3fa85f64-...",
  "code": "de",
  "translations_deleted": 150,
  "deleted": true
}

404 Not Found — language is not registered for this project.

---

Examples

List languages

curl https://sapi.i18nme.com/v1/languages \
  -H "X-API-Key: key_live_XXXX"

Add language

curl -X POST https://sapi.i18nme.com/v1/languages \
  -H "X-API-Key: key_live_XXXX" \
  -H "Content-Type: application/json" \
  -d '{"code": "de"}'

Remove language

curl -X DELETE https://sapi.i18nme.com/v1/languages/de \
  -H "X-API-Key: key_live_XXXX"