Skip to content

GET /v1/manifest

Returns the list of languages available for this project.

Overview

Use this endpoint to discover which language codes your project has live translations for. The response is suitable for populating a language-switcher UI or deciding which locales to pre-fetch.

Authentication

X-API-Key header required. See Authentication.

Request

GET https://sapi.i18nme.com/v1/manifest
HeaderRequiredDescription
X-API-KeyYour project API key

No path parameters or query parameters.

Response

200 OK

json
{
  "project_id": "3fa85f64-...",
  "languages": [
    { "code": "en", "name": "English",  "iso": "en", "approved_count": 120 },
    { "code": "pl", "name": "Polish",   "iso": "pl", "approved_count":  98 },
    { "code": "de", "name": "German",   "iso": "de", "approved_count":  45 }
  ]
}

Field reference

FieldTypeDescription
project_idstringUUID of the project
languagesLanguage[]Ordered list of languages that have at least one translation
languages[].codestringURL-safe locale identifier (used in endpoint paths)
languages[].namestringHuman-readable language name
languages[].isostringISO 639-1 code
languages[].approved_countnumberNumber of keys with an approved translation in this language

Examples

bash
curl https://sapi.i18nme.com/v1/manifest \
  -H "X-API-Key: key_live_XXXX"
js
const res = await fetch('https://sapi.i18nme.com/v1/manifest', {
  headers: { 'X-API-Key': process.env.I18N_API_KEY }
})
const { languages } = await res.json()
// ['en', 'pl', 'de']
const codes = languages.map(l => l.code)
python
import httpx, os

res = httpx.get(
    'https://sapi.i18nme.com/v1/manifest',
    headers={'X-API-Key': os.environ['I18N_API_KEY']}
)
languages = res.json()['languages']
print([l['code'] for l in languages])

See also

i18nme is provided on a best-effort basis. While we strive for reliability and rapid issue resolution, no specific uptime, response time, or bug-fix timeframe is guaranteed.
Translation content and AI-generated output should be reviewed before production use.