---
title: "Poll the status of an audit job"
method: GET
path: "/api/audits/jobs/{jobId}"
---

# Poll the status of an audit job

`GET /api/audits/jobs/{jobId}`

## Request

- Base URL: `https://api.aetherya.ai`
- URL: `https://api.aetherya.ai/api/audits/jobs/{jobId}`
- Auth: HTTP bearer

Returns the current status of an async audit job. When `status` is `completed`, `reportId` is set and the full report can be fetched from `/api/audits/{reportId}`.

## Path parameters

- `jobId` string, required

## Headers

- `X-Aetherya-Workspace-Id` string

## Response `200`

Job status.

- object
  - `success` boolean, required
  - `jobId` string, required
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'not_found' | 'error', required
  - `reportId` string: Set when status is 'completed'.
  - `error` string: Set when status is 'failed'.

## Other responses

- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/aetherya/apis/aetherya-api.md) · [All operations](https://skmtc.dev/aetherya/apis/aetherya-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aetherya/apis/aetherya-api/revisions/afa076131ee1?raw)