# General Translation Platform: Lister les branches
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/branches/list-branches.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Liste les branches du projet, triées par ID, en indiquant pour chacune s’il s’agit de la branche par défaut du projet. Nécessite project:files:read.

{/* Ce fichier a été généré par Fumadocs. Ne le modifiez pas directement. Pour toute modification, relancez la commande de génération. */}

## Endpoint

`GET https://api.gtx.dev/v2/projects/{projectId}/branches`

**Operation ID:** `listBranches`

**Tags:** `Branches and tags`

**Summary:** List branches

List the project's branches ordered by ID, each marked with whether it is the project's default branch. Requires `project:files:read`.

Authentication: required. Send an API key in the `Authorization: Bearer <key>` header when authenticating.

### Parameters

- `projectId` (path, string, required): Project ID.
- `cursor` (query, string, optional): The nextCursor from the previous page. Omit for the first page.
- `limit` (query, integer, optional): Maximum number of items to return, 1–100. Defaults to 50.
- `name` (query, string[], optional): Branch names to match exactly (case-sensitive); repeat the parameter for up to 20 names. Omit to list every branch. Characters that need percent-encoding cost 3–12 bytes each in the URL, so send fewer such names per request to keep the URL under 8 KB.
- `isDefault` (query, "true" | "false", optional): With `true`, list only the project's default branch; with `false`, every other branch. With `name`, a branch must match both.
- `gt-api-version` (header, "2026-10-08.v1", required): API contract version. Must be `2026-10-08.v1` or later; requests without it or with an older version return 400.

### Responses

**200**: Page of branches
Response body (`application/json`, object):
- `items` (object[], required)
  - `id` (string, required)
  - `name` (string, required)
  - `isDefault` (boolean, required): Whether this is the project's one default branch.
- `nextCursor` (string | null, required): Opaque cursor for the next page; `null` when there are no more items. Pages are read independently, so items changed between requests may be missed or repeated.

**400**: The request is malformed or failed validation.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**401**: Authentication is missing or invalid.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**403**: The caller is authenticated but not allowed to perform this operation or access the requested resource.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**404**: The requested resource was not found.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**429**: Too many requests. The rate limit was exceeded.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**500**: An unexpected server error occurred.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

Complete OpenAPI 3.1 specification: https://generaltranslation.com/openapi.yaml

OpenAPI schema: [openapi.json](https://generaltranslation.com/openapi.json)

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.