# General Translation Platform: Interroga i job
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/jobs/query-jobs.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Recupera lo stato dei job di traduzione dei file e di generazione del contesto tramite ID. Richiede project:files:read.

{/* Questo file è stato generato da Fumadocs. Non modificarlo direttamente. Per apportare modifiche, esegui nuovamente il comando di generazione. */}

## Endpoint

`POST https://api.gtx.dev/v2/projects/{projectId}/jobs/query`

**Operation ID:** `queryJobs`

**Tags:** `Jobs`

**Summary:** Query jobs

Get the status of file translation and context generation jobs by ID. Requires `project:files:read`.

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

### Parameters

- `projectId` (path, string, required)
- `gt-api-version` (header, "2026-10-08.v1", required): API contract version. Must be `2026-10-08.v1` or later; requests without it or with an older version return 400.

### Request body (required)

Body (`application/json`, object):
- `jobs` (object[], required): Jobs to read, 1–100; a job ID repeated is rejected.
  - `id` (string, required): Job ID returned when the job was queued.

### Responses

**200**: One result per selector, in selector order; a job the project does not have is `not_found`.
Response body (`application/json`, object):
- `results` (object[], required): One result per selector, in selector order.
  - `id` (string, required)
  - `status` ("queued" | "processing" | "completed" | "failed" | "not_found", required): The job status, or `not_found` when the project has no such job.
  - `subject` (object | object | object): Absent when `status` is `not_found`.
  - `error` (string | null): Absent when `status` is `not_found`.

**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):

**413**: The request, or the data it would return, exceeds a size or item limit.
Response body (`application/json`, object):
- `error` (string, required)

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

**415**: The request body's Content-Type is missing or not supported. Send the body as application/json.
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.