---
title: "Poll an AI agent readiness check"
method: GET
path: "/agent/readiness/checks/{job_id}"
tags: ["readiness"]
---

# Poll an AI agent readiness check

`GET /agent/readiness/checks/{job_id}`

## Request

- Base URL: `https://vertodigital.com`
- URL: `https://vertodigital.com/agent/readiness/checks/{job_id}`
- Auth: none declared

Status of a check started with POST /agent/readiness/checks. While status is queued or running the response carries Retry-After (seconds) and a progress object; once complete it carries report_url and report_json_url, and once failed an error. Never cached (Cache-Control: no-store). Most checks finish within a minute.

## Path parameters

- `job_id` string, required

## Response `200`

Current job status

- ReadinessCheckStatus
  - `status` 'queued' | 'running' | 'complete' | 'failed', required
  - `progress` object, nullable, required: Scan progress, null before the scan starts
    - `step` string
    - `done` integer
    - `total` integer
  - `report_url` string, uri: Present when status is complete: the report page
  - `report_json_url` string, uri: Present when status is complete: the report as JSON (for a comparison, GET /agent/readiness/compare/{compare_id})
  - `error` string: Present when status is failed

## Other responses

- `404`: No check with this job_id

---

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