# General Translation Platform: Recupera informazioni sul branch
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/project/branch-info.mdx
---

title: Recupera informazioni sul branch
description: Esamina i metadati del branch e lo stato dei branch del progetto in General Translation. Riferimento API per recuperare informazioni sul branch.

method: POST
---

Restituisce il branch predefinito del progetto e tutti i branch richiesti per nome. Usalo per convertire i nomi dei branch nei relativi ID prima di eseguire altre operazioni sui file.

## Panoramica [#overview]

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

**Permesso** `project:files:read` · **Limite di richieste** Predefinito (200/min)

Recupera i branch di un progetto. Per creare un branch, usa [Crea un branch](/docs/platform/openapi/reference/project/create-branch).

## Come funziona [#how-it-works]

* Viene sempre restituito il branch predefinito, oppure `null` se il progetto non ne ha uno.
* `branchNames` filtra l'elenco `branches` restituito. Quando è vuoto, non viene restituito alcun branch nominato.
* Ogni branch viene restituito con il relativo `id` e `name`.

## Richiesta [#request]

### Header

| Header            | Descrizione                                                                    | Obbligatorio |
| ----------------- | ------------------------------------------------------------------------------ | ------------ |
| `x-gt-api-key`    | Chiave API del progetto o dell'Organization.                               | Sì           |
| `x-gt-project-id` | ID progetto. Obbligatorio quando si utilizza una chiave dell'Organization. | No           |

### Corpo

**Tipo di contenuto** `application/json`

| Campo         | Descrizione                 | Tipo       | Facoltativo | Predefinito |
| ------------- | --------------------------- | ---------- | ----------- | ----------- |
| `branchNames` | Nomi dei branch da cercare. | `string[]` | Sì          | `[]`        |

## Risposta [#response]

**Stato** `200 OK`

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

## Errori [#errors]

| Stato | Causa                                              |
| ----- | -------------------------------------------------- |
| `400` | Corpo della richiesta non valido.                  |
| `401` | Chiave API mancante o non valida.                  |
| `403` | La chiave API non dispone di `project:files:read`. |
| `429` | Limite di richieste superato.                      |

## Esempio [#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"]
  }'
```