Manual
CLI
API
Log in Get started free

List branches

Lists the branches of every project you can see, the protected branch of each project first.

Lists the branches of every project you can see, the protected branch of each project first.

HTTP
GET /branches

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

Response 200 #

A list of branches.

JSON
[
{
  "id": "0197a3c8-6f75-7c66-a9bd-1d5a7e2c4f86",
  "projectId": "0197a3c6-4d53-7a44-87fb-9b3e5c0a2d64",
  "name": "feature/checkout",
  "base": "main",
  "status": "active",
  "progress": 40,
  "progressLabel": "80 / 200",
  "openKeys": 30,
  "ageMinutes": 15
}
]

Response fields #

FieldTypeDescription
idstringThe id of the branch.
projectIdstringThe id of its project.
namestringThe name.
basestring or nullThe name of the branch it was made from. null for main.
statusstringprotected (the main branch), active, frozen, or ready when every key is published in every language.
progressintegerPercent of published translations over all keys and languages.
progressLabelstringThe same as a text such as 80 / 200, with thousands separators.
openKeysintegerKeys that are not published in every language yet.
ageMinutesintegerMinutes since the branch last changed.

Errors #

StatuserrorWhen
401unauthenticatedThe token is missing or not valid.
429rate_limitedToo many requests, see Rate limiting.

See Errors for the error format.