# General Translation Platform: Obtenir les informations sur la branche
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/project/branch-info.mdx
---
title: Obtenir les informations sur la branche
description: Inspectez les métadonnées de la branche et l’état de la branche du projet General Translation. Référence de l’API pour obtenir les informations sur la branche.

method: POST
---

Renvoie la branche par défaut du projet ainsi que toutes les branches que vous recherchez par nom. Utilisez cette méthode pour résoudre les noms de branche en ID avant d’effectuer d’autres opérations sur les fichiers.

## Vue d’ensemble [#overview]

```http
POST https://api2.gtx.dev/v2/project/branches/info
```

**Autorisation** `project:files:read` · **Limite de requêtes** Par défaut (200/min)

Récupérez les branches d’un projet. Pour créer une branche, utilisez [Créer une branche](/docs/platform/openapi/reference/project/create-branch).

## Fonctionnement [#how-it-works]

* La branche par défaut est toujours renvoyée, ou `null` si le projet n'en a pas.
* `branchNames` filtre la liste `branches` renvoyée. Lorsqu'il est vide, aucune branche nommée n'est renvoyée.
* Chaque branche est renvoyée avec son `id` et son `name`.

## Requête [#request]

### En-têtes

| En-tête           | Description                                                        | Obligatoire |
| ----------------- | ------------------------------------------------------------------ | ----------- |
| `x-gt-api-key`    | Clé d’API du projet ou de l’Organization.                          | Oui         |
| `x-gt-project-id` | ID du projet. Obligatoire si vous utilisez une clé d’Organization. | Non         |

### Corps

**Type de contenu** `application/json`

| Champ         | Description                     | Type       | Facultatif | Par défaut |
| ------------- | ------------------------------- | ---------- | ---------- | ---------- |
| `branchNames` | Noms des branches à rechercher. | `string[]` | Oui        | `[]`       |

## Réponse [#response]

**État** `200 OK`

```json title="Response"
{
  "branches": [
    { "id": "br_...", "name": "feature-x" }
  ],
  "defaultBranch": { "id": "br_...", "name": "main" }
}
```

## Erreurs [#errors]

| État  | Cause                                             |
| ----- | ------------------------------------------------- |
| `400` | Corps de la requête invalide.                     |
| `401` | clé d’API manquante ou invalide.                    |
| `403` | La clé d’API ne dispose pas de `project:files:read`. |
| `429` | Limite de requêtes dépassée.                      |

## Exemple [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/branches/info \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "branchNames": ["feature-x"]
  }'
```