Better I18NBetter I18N

listKeys

Get translation keys with search, filters, and translations.

Get all translation keys with their ID, source text, and translations. Supports full-text search and filtering.

Parameters

ParameterTypeRequiredDescription
projectstringYesProject identifier in org/project format
searchstringNoText to search for (case-insensitive)
languagesstring[]NoLanguage codes to search in and return
namespacesstring[]NoFilter by namespace(s)
keysstring[]NoFetch specific keys by exact name
statusstringNoFilter by status: missing, draft, published, all

Examples

Search in source text

{
  "project": "my-org/my-app",
  "search": "login"
}

Search in Turkish translations

{
  "project": "my-org/my-app",
  "search": "Giriş",
  "languages": ["tr"]
}

Get missing Turkish translations

{
  "project": "my-org/my-app",
  "languages": ["tr"],
  "status": "missing"
}

Get specific keys

{
  "project": "my-org/my-app",
  "keys": ["auth.login.title", "auth.login.button"]
}

Response

{
  "keys": [
    {
      "id": "key_abc123",
      "name": "auth.login.title",
      "namespace": "auth",
      "sourceText": "Sign in to your account",
      "translations": {
        "tr": "Hesabınıza giriş yapın",
        "de": "Melden Sie sich an"
      }
    }
  ],
  "namespaceDetails": {
    "auth": {
      "name": "auth",
      "keyCount": 25,
      "description": "Authentication flows",
      "context": {
        "team": "auth-team",
        "domain": "auth"
      }
    }
  }
}

Search Behavior

  • If languages is specified, searches in those languages
  • If languages is omitted, searches in source text
  • Search is case-insensitive and matches partial strings

On this page