# General Translation Platform: Obtener el estado de un trabajo de traducción
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/translation/job-status.mdx
---

title: Obtener el estado de un trabajo de traducción
description: Recupera el estado de un trabajo de traducción en cola en General Translation. Referencia de la API para obtener el estado de un trabajo de traducción.

method: POST
---

Devuelve el estado de uno o varios trabajos en cola por ID. Úsalo para consultar trabajos creados por [Poner traducciones en cola](/docs/platform/openapi/reference/translation/queue) o [Generar contexto de traducción](/docs/platform/openapi/reference/context/generate-context).

## Descripción general [#overview]

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

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

Consulta el progreso de los trabajos en segundo plano en una sola solicitud.

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

* Envía uno o más ID de trabajo. Los trabajos se buscan dentro del proyecto autenticado.
* El estado bruto de cada trabajo se normaliza: los trabajos `pending` y `queued` se reportan como `queued`; los trabajos `processing` y `retrying` se reportan como `processing`; los trabajos `failed` se reportan como `failed` con un `error.message`; los trabajos `completed` se reportan como `completed`.
* Solo se devuelven los trabajos que coinciden con los ID proporcionados. Los ID que no corresponden a ningún trabajo se omiten de la lista de respuesta; una solicitud cuyos ID no coinciden con ninguno devuelve `200` con una lista vacía.

## Petición [#request]

### Cabeceras

| Cabecera          | Descripción                                                     | Obligatoria |
| ----------------- | --------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clave de API del proyecto o de Organization.                    | Sí          |
| `x-gt-project-id` | ID del proyecto. Obligatoria al usar una clave de Organization. | No          |

### Cuerpo

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

| Campo    | Descripción                                                                          | Tipo       | Opcional | Predeterminado |
| -------- | ------------------------------------------------------------------------------------ | ---------- | -------- | -------------- |
| `jobIds` | ID de trabajo para consultar; se requiere al menos uno y ninguno puede estar vacío. | `string[]` | No       | —              |

## Respuesta [#response]

**Estado** `200 OK`

La respuesta es una lista JSON con un elemento por cada trabajo resuelto:

```json title="Response"
[
  { "status": "completed", "jobId": "job_a..." },
  { "status": "processing", "jobId": "job_b..." },
  {
    "status": "failed",
    "jobId": "job_c...",
    "error": { "message": "Translation failed" }
  }
]
```

## Errores [#errors]

| Estado | Causa                                                    |
| ------ | -------------------------------------------------------- |
| `400`  | Cuerpo de la solicitud no válido o lista `jobIds` vacía. |
| `401`  | Falta la clave de API o no es válida.                    |
| `403`  | La clave de API 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/jobs/info \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobIds": ["job_a...", "job_b..."]
  }'
```