---
title: "jobs.status"
description: "Reads one async process job status."
source: https://liatir.com/plugins/api/jobs/status
---

# jobs.status

`Liatir.jobs.status()` reads the current state of one async process job.

## Signature

### Node

```ts
status(jobId: string): Promise<JobEntry>
```


### Python

```python
status(job_id) -> dict
```


## Parameters

### Node

| Parameter | Type     | Description                    |
|-----------|----------|--------------------------------|
| `jobId`   | `string` | Unique identifier for the job. |

### Python

| Parameter | Type  | Description                    |
|-----------|-------|--------------------------------|
| `job_id`  | `str` | Unique identifier for the job. |

## Example

### Node

```ts
const job = await Liatir.jobs.status(jobId);

console.log('Status:', job.status.type);
console.log('Exit code:', job.status.exitCode);
```


### Python

```python
job = ctx.liatir.jobs.status(job_id)

print('Status:', job['status']['type'])
print('Exit code:', job['status'].get('exitCode'))
```


## Return value

Returns a `JobEntry` object. See [`.jobs.list`](https://liatir.com/plugins/api/jobs/list.md#jobentry) for the full structure.

## Job states

A job can be `running`, `done`, `failed`, or `killed`.