---
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}`

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.net/ocrolus/apis/user-management.md) · [All operations](https://skmtc.net/ocrolus/apis/user-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ocrolus/user-management/versions/3571ef602d13/schema)