Manual
CLI
API
Log in Get started free

List keys

Lists all keys of a branch, ordered by name, with their translation in one language.

Lists all keys of a branch, ordered by name, with their translation in one language.

HTTP
GET /branches/{branchId}/keys

Access: Session token, or an API key with the projects:read scope.

Role: Any role in the project.

Path parameters #

ParameterDescription
branchIdThe id of the branch.

Query parameters #

ParameterRequiredDescription
languageyesA language code such as de-de, lower case or not.

Response 200 #

A list of keys.

JSON
[
  {
    "id": "0197a3c9-7086-7d77-8ace-2e6b8f3d5097",
    "name": "checkout.title",
    "source": "Checkout",
    "maxLength": null,
    "translation": { "value": "Kasse", "status": "approved" }
  }
]

Response fields #

FieldTypeDescription
idstringThe id of the key.
namestringThe name of the key.
sourcestring or nullThe source text. null until it has one.
maxLengthinteger or nullThe longest allowed translation, in characters, or null for no limit.
translationobject or nullThe translation in the requested language: value and status (draft, review, changes or approved). null when there is none.

Errors #

StatuserrorWhen
401unauthenticatedThe token is missing or not valid.
404not_foundThe branch does not exist, you have no access to its project, or branchId is not a UUID.
422invalid_requestlanguage is missing or not a language code (language: invalid).
429rate_limitedToo many requests, see Rate limiting.

See Errors for the error format.