# General Translation Platform: Obtener información de la rama
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/project/branch-info.mdx
---

title: Obtener información de la rama
description: Inspecciona los metadatos de la rama y el estado de la rama del Project de General Translation. Referencia de la API para obtener información de la rama.

method: POST
---

Devuelve la rama predeterminada del Project y cualquier rama que consultes por nombre. Úsalo para resolver nombres de ramas a ID antes de realizar otras operaciones con archivos.

## Descripción general [#overview]

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

**Permiso** `project:files:read` · **Límite de solicitudes** Predeterminado (200/min)

Consulta las ramas de un Project. Para crear una rama, usa [Crear una rama](/docs/platform/openapi/reference/project/create-branch).

## Cómo funciona [#how-it-works]

* Siempre se devuelve la rama predeterminada, o `null` si el Project no tiene ninguna.
* `branchNames` filtra la lista de `branches` que se devuelve. Si está vacío, no se devuelve ninguna rama con nombre.
* Cada rama se devuelve con su `id` y su `name`.

## Solicitud [#request]

### Cabeceras

| Cabecera          | Descripción                                                        | Obligatorio |
| ----------------- | ------------------------------------------------------------------ | ----------- |
| `x-gt-api-key`    | API Key de Project o de Organization.                              | Sí          |
| `x-gt-project-id` | Project ID. Obligatorio cuando se usa una API Key de Organization. | No          |

### Cuerpo

**Tipo de contenido** `application/json`

| Campo         | Descripción                               | Tipo       | Opcional | Predeterminado |
| ------------- | ----------------------------------------- | ---------- | -------- | -------------- |
| `branchNames` | Nombres de las ramas que se van a buscar. | `string[]` | Sí       | `[]`           |

## Respuesta [#response]

**Estado** `200 OK`

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

## Errores [#errors]

| Estado | Causa                                     |
| ------ | ----------------------------------------- |
| `400`  | Cuerpo de la solicitud no válido.         |
| `401`  | Falta la API key o no es válida.          |
| `403`  | La API key no tiene `project:files:read`. |
| `429`  | Se superó el límite de solicitudes.       |

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