> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Job Status

> Retrieve the current status and progress of an async Galtea job.

> [!WARNING]
>
> You are reading the docs of Galtea 5.12. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/job/get-status.md).

Retrieve the status of an async job. Use this after calling [`evaluations.run()`](https://docs.galtea.ai/v5.12/sdk/api/evaluation/run) in endpoint-connection mode to check whether the inference batch is still running, has completed, or has been cancelled.

## Usage

```python theme={"system"}
    status = galtea.jobs.get_status(job_id=job_id)
    print(f"State:    {status.state}")
    print(f"Progress: {status.progress}")
    if status.error:
        print(f"Error:    {status.error}")
    if status.result:
        print(f"Result:   {status.result}")
```

## Parameters

**job\_id** `string` *required*

The ID of the job to inspect. Returned as `jobId` in the response from [`evaluations.run()`](https://docs.galtea.ai/v5.12/sdk/api/evaluation/run).

## Returns

A `JobStatus` object with the following fields:

**id** `string`

The job ID.

**state** `JobState | str`

Current state of the job: `waiting`, `delayed`, `prioritized`, `waiting-children`, `active`, `completed`, `failed`, `cancelled` or `unknown`. A state the API adds later arrives as a plain string, so handle a value outside this list.

**progress** `float | int | dict`

Progress indicator published by the worker. Typically a percentage (0–100) or a custom object. Defaults to `0`.

**result** `any`

The job's return value once it reaches `completed` state. `None` while in progress.

**error** `string`

Error message if the job has reached `failed` state. `None` otherwise.

## Errors

| Error | Cause |
| - | - |
| `EntityNotFoundException` | The job does not exist, or belongs to a different organization (the API returns 404 in both cases to avoid leaking cross-tenant existence). Import it with `from galtea import EntityNotFoundException`. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.