# General Translation Platform: Get context generation status
URL: https://generaltranslation.com/en-GB/docs/platform/openapi/reference/context/context-status.mdx
---

title: Get context generation status
description: Track the status of a General Translation context generation job. API reference for Get context generation status.

method: GET
---

Returns the status of a context generation job started by [Generate translation context](/docs/platform/openapi/reference/context/generate-context).

*Note: this endpoint is retained for backwards compatibility. For new integrations, use [Get translation job status](/docs/platform/openapi/reference/translation/job-status), which reports status for any queued job.*

## Overview [#overview]

```http
GET https://api2.gtx.dev/v2/project/setup/status/:jobId
```

**Permission** `project:context:read` · **Rate limit** Medium (120/min)

Poll a single context generation job by ID.

## How it works [#how-it-works]

* The job is looked up in the authenticated Project. An unknown job ID returns `404`.
* A completed job returns `{ "status": "completed" }`.
* Otherwise, the response includes the job ID and a normalised status: `queued`, `processing`, `failed`, or `unknown`. Pending and queued jobs map to `queued`; processing and retrying jobs map to `processing`.

## Request [#request]

### Headers

| Header            | Description                                          | Required |
| ----------------- | ---------------------------------------------------- | -------- |
| `x-gt-api-key`    | Project or Organization API key.                     | Yes      |
| `x-gt-project-id` | Project ID. Required when using an Organization key. | No       |

### Path parameters

| Parameter | Description                               | Type     | Required |
| --------- | ----------------------------------------- | -------- | -------- |
| `jobId`   | Identifier of the context generation job. | `string` | Yes      |

## Response [#response]

**Status** `200 OK`

```json title="Response"
{
  "jobId": "job_...",
  "status": "processing"
}
```

A completed job returns:

```json title="Response"
{
  "status": "completed"
}
```

## Errors [#errors]

| Status | Cause                                 |
| ------ | ------------------------------------- |
| `401`  | Missing or invalid API key.           |
| `403`  | API key lacks `project:context:read`. |
| `404`  | Job not found.                        |
| `429`  | Rate limit exceeded.                  |

## Example [#example]

```bash
curl -X GET https://api2.gtx.dev/v2/project/setup/status/job_... \
  -H "x-gt-api-key: gtx-api-..."
```