# gt: General Translation CLI tool: gt project status
URL: https://generaltranslation.com/en-US/docs/cli/reference/commands/project-status.mdx
---

title: gt project status
description: Check the current status of a translation or Project context-generation job. API reference for the gt project status command.

---

Use `gt project status` to inspect a job returned by a translation workflow or [`setupProject`](/docs/platform/core/reference/gt-class-methods/translation/setup-project). Project creation completes synchronously and does not return a job ID.

## Overview [#overview]

```bash
npx gt project status <job-id> [options]
```

The command makes one status request and prints the status returned by the API.

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

1. Resolves the API key and Project ID from flags, config, or environment variables.
2. Requests the current state of the supplied translation or context-generation job.
3. Prints the returned status, or `unknown` when the response contains no status.

The command exits with status 1 when credentials are missing or the API rejects the request. If the API returns no matching job, the command prints `unknown` and exits successfully; a printed `failed` job status also does not make the command exit with an error.

## Arguments and flags [#arguments-flags]

| Parameter | Description | Type | Optional | Default |
| --- | --- | --- | --- | --- |
| `<job-id>` | Translation or context-generation job ID to inspect. | `string` | No | — |
| `-c, --config <path>` | Path to `gt.config.json`. | `string` | Yes | Auto-resolved |
| `--api-key <key>` | API key override. | `string` | Yes | `GT_API_KEY` |
| `--project-id <id>` | Project ID override. | `string` | Yes | Config or `GT_PROJECT_ID` |

## Example [#example]

```bash
npx gt project status job_123
```

## Other notes [#notes]

- `gt project status` is available in `gt` 2.20.0 and later.
- The command needs both an API key and Project ID.
- See [Get translation job status](/docs/platform/openapi/reference/translation/job-status) for the underlying job-status response shapes.