---
title: "Async job status"
method: GET
path: "/v2/analytics/jobs/{job_id}"
tags: ["Cash Flow Analytics"]
---

# Async job status

`GET /v2/analytics/jobs/{job_id}`

## Request

- Base URL: `https://api.ocrolus.com`
- URL: `https://api.ocrolus.com/v2/analytics/jobs/{job_id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.ocrolus.com/oauth/token`

Retrieves the status and result of an analytics job created when any supported analytics endpoint is called with **`async=true`**. Poll this endpoint until the job reaches a terminal state (`DONE` or `FAILED`).

The job **`status`** moves through the following states: **`PENDING`** while the job is running, **`DONE`** when the result is ready, and **`FAILED`** if the job could not be completed. Poll every few seconds until a terminal state is reached. Large Books may take longer to process.

When the status is **`DONE`**, the response includes a **`result_url`**, a temporary pre-signed download link to retrieve the analytics payload, which is identical in shape to the corresponding synchronous endpoint's response. The job and its **`result_url`** are valid for 24 hours from the time the job was created.

## Path parameters

- `job_id` string, uuid, required

## Response `200`

The job is complete. Fetch the `result_url` to download the analytics payload. The URL expires 24 hours after the job was created.

- object
  - `job_id` string, uuid: The unique identifier of the async job.
  - `status` 'DONE': The job completed successfully.
  - `result_url` string, uri: A temporary pre-signed link to download the analytics payload. Expires 24 hours after the job was created.

## Other responses

- `202`: The job is still running. Keep polling until the status changes to `DONE` or `FAILED`.
- `404`: The job ID is not recognized, does not belong to your organization, or has expired. Jobs expire 24 hours after creation.
- `422`: The job failed. The `error` field explains why. For example, a book that exceeds 1,000,000 transactions is rejected with `422`.
- `500`: Internal server error

---

[API](https://skmtc.dev/ocrolus/apis/analyze.md) - [All operations](https://skmtc.dev/ocrolus/apis/analyze/llms.txt) - [OpenAPI document](https://skmtc.dev/ocrolus/apis/analyze/revisions/4ef40f224ab5?raw)