Skip to content

Retrieve progressive checkpoint status

Request

Returns checkpoint-level progress for an Enterprise Progressive Report: nested report identity and status, whether continuation is still eligible, when eligibility expires, and an ordered list of checkpoints.

Each checkpoint lists the products it runs and a user_review object. That object's status, decision, and paused_at distinguish waiting on a review action, a customer-applied decision, auto-progress, and checkpoints with no gate.

Use this endpoint when polling after a report.paused webhook, or alongside Apply a review action to a Report.

Returns 404 if the Report does not exist or does not have progressive checkpoint status.

Security
basic_auth
Path
idstringrequired

The Report's ID.

curl -i -X GET \
  -u '<username>:<password>' \
  'https://docs.checkr.com/_mock/apis/openapi/reports/{id}/progressive/status'

Responses

Progressive checkpoint status for the Report

Bodyapplication/json
reportobjectrequired

Nested Report identity and public status. id, uri, and status match Retrieve an existing Report, including account-level paused to suspended translation when that setting is enabled.

Example:
{ "id": "abc123", "uri": "/v1/reports/abc123", "status": "paused" }
progressive_continuation_statusstringrequired

Whether this report can still be advanced.

eligible: a review action can be applied now, or screenings skipped earlier can still be run. expired: the deadline in expires_at has passed. ineligible: the report cannot be advanced, for example because it is disputed, in adverse action, or canceled.

Enum:"eligible""ineligible""expired"
Example:"eligible"
expires_atstring or null, (date-time)

The deadline for advancing this report. Until this time you may apply a review action to run the report's remaining screenings. After it passes, those screenings can no longer be run and progressive_continuation_status becomes expired. null until the report completes for the first time. The value is not cleared once the deadline passes, so a timestamp in the past tells you when the window closed.

Example:"2026-09-11T15:54:00Z"
checkpointsArray of objects(ProgressiveCheckpoint)required

Ordered progressive checkpoints for this report. position is 1-based (the first checkpoint is 1).

Example:
[ { "position": 1, "name": "identity_gate", "status": "completed", "products": [ … ], "user_review": { … } }, { "position": 2, "status": "in_progress", "products": [ … ], "user_review": { … } } ]
Response
{ "report": { "id": "abc123", "uri": "/v1/reports/abc123", "status": "paused" }, "progressive_continuation_status": "eligible", "expires_at": "2026-09-11T15:54:00Z", "checkpoints": [ { … }, { … } ] }