# General Translation Platform: Obtenir une tâche
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/jobs/get-job.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Récupère l’état d’une tâche de traduction de fichier ou de génération de contexte. Nécessite project:files:read.

{/* Ce fichier a été généré par Fumadocs. Ne le modifiez pas directement. Pour y apporter des modifications, relancez la commande de génération. */}

## Endpoint

`GET https://api.gtx.dev/v2/projects/{projectId}/jobs/{jobId}`

**Operation ID:** `getJob`

**Tags:** `Jobs`

**Summary:** Get a job

Get the status of a file translation or context generation job. Requires `project:files:read`.

Authentication: required. Send an API key in the `Authorization: Bearer <key>` header when authenticating.

### Parameters

- `projectId` (path, string, required)
- `jobId` (path, string, required): Job ID returned when the job was queued.
- `gt-api-version` (header, "2026-10-08.v1", optional): API contract version. Defaults to the oldest supported version.

### Responses

**200**: Job
Response body (`application/json`, object):
- `id` (string, required)
- `status` ("queued" | "processing" | "completed" | "failed", required): `queued`: accepted and waiting to run. `processing`: running, or waiting to retry after a failed attempt. `completed` and `failed` are final.
- `subject` (object | object | object, required): What the job works on, by `type`. A file translation names its source file version and target locale.
- `error` (string | null, required): Failure reason of a failed job; `null` otherwise.

**400**: The request is malformed or failed validation.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**401**: Authentication is missing or invalid.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**403**: The caller is authenticated but not allowed to perform this operation or access the requested resource.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**404**: The requested resource was not found.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**429**: Too many requests. The rate limit was exceeded.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**500**: An unexpected server error occurred.
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

Complete OpenAPI 3.1 specification: https://generaltranslation.com/openapi.yaml

OpenAPI schema: [openapi.json](https://generaltranslation.com/openapi.json)

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.