| Status | Description |
|---|---|
pending | The report is in progress. Screenings are still running. |
suspended | The report is on hold — the candidate needs to provide additional information. |
paused | The report is awaiting a Review Action decision to continue or skip the remaining screenings. |
complete | Report processing has finished — at least one screening completed. The overall result is clear or consider. |
canceled | All screenings in the report were canceled. |
dispute | The candidate has disputed one or more results. |
Retrieve the current status of a report at any time by calling the Reports endpoint.
curl -u YOUR_API_KEY: \
https://api.checkr-staging.com/v1/reports/REPORT_IDThe response includes the status field along with individual screening statuses.
Polling is straightforward but not recommended for production applications. Use webhooks instead.
Configure a webhook endpoint to receive real-time status updates. Checkr sends a POST request to your endpoint whenever a report or screening status changes.
Key webhook events:
| Event | Description |
|---|---|
report.updated | The report changed while processing — sent as individual screenings within the report complete. |
report.suspended | The report has been suspended. |
report.completed | The report has finished processing. |
To set up webhooks, go to Dashboard → Developer → Webhooks and add your endpoint URL.
Use Checkr's Customer MCP to query report status using Claude or another AI assistant.
Example queries:
- "What's the status of the report for John Smith?"
- "Which reports are still pending?"
- "Show me all reports with a 'consider' status this week."
Customer MCP is particularly useful for ad hoc lookups during development or support investigations.