# General Translation Platform: Obtenir l’état d’un job de traduction
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/translation/job-status.mdx
---
title: Obtenir l’état d’un job de traduction
description: Récupère l’état d’un job de traduction en file d’attente dans General Translation. Référence de l’API pour obtenir l’état d’un job de traduction.

method: POST
---

Renvoie l’état d’un ou de plusieurs jobs en file d’attente à partir de leur ID. Utilisez cette méthode pour interroger les jobs créés par [Queue translations](/docs/platform/openapi/reference/translation/queue) ou [Generate translation context](/docs/platform/openapi/reference/context/generate-context).

## Vue d’ensemble [#overview]

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

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

Consultez l’avancement des jobs en arrière-plan en une seule requête.

## Fonctionnement [#how-it-works]

* Envoyez un ou plusieurs ID de job. Les jobs sont recherchés dans le projet authentifié.
* L’état brut de chaque job est normalisé : les jobs `pending` et `queued` renvoient `queued` ; les jobs `processing` et `retrying` renvoient `processing` ; les jobs `failed` renvoient `failed` avec un `error.message` ; les jobs `completed` renvoient `completed`.
* Seuls les jobs correspondant aux ID fournis sont renvoyés. Les ID qui ne correspondent à aucun job sont omis du tableau de réponse ; une requête dont les ID ne correspondent à aucun job renvoie `200` avec un tableau vide.

## Requête [#request]

### En-têtes

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

### Corps

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

| Champ    | Description                                                                           | Type       | Facultatif | Par défaut |
| -------- | ------------------------------------------------------------------------------------- | ---------- | ---------- | ---------- |
| `jobIds` | Identifiants de job à rechercher ; au moins un est requis et aucun ne peut être vide. | `string[]` | Non        | —          |

## Réponse [#response]

**État** `200 OK`

La réponse est un tableau JSON contenant une entrée par job résolu :

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

## Erreurs [#errors]

| État  | Cause                                                   |
| ----- | ------------------------------------------------------- |
| `400` | Corps de la requête invalide, ou tableau `jobIds` vide. |
| `401` | Clé API manquante ou invalide.                          |
| `403` | La clé 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/jobs/info \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobIds": ["job_a...", "job_b..."]
  }'
```