check_status
A check in progress.
For one paid order: the check running now with how many answers are in (poll this, about once a minute; no call waits), the last finished check and when the next one is due.
Who can use it
- Access
- A paid order.
- Scope
scan:read- Changes anything
- No. Read-only.
Inputs
| Name | Type | Required | Values and limits |
|---|---|---|---|
order_id | string | Yes |
What it answers
Every answer has status and, where useful, message in plain words.
| Field | Meaning |
|---|---|
order_state | The order's state. |
in_progress | The check running now: check_id, kind, started_at, answers_in of answers_planned, and retrying_at when some answers will be tried again. null when none runs. |
last_finished | The last finished check: check_id, kind, status, finished_at. |
next_check_at | When the next check is due, or null. |
message | What to do next. Poll about once a minute; no call waits. |
Errors
| status | What it means |
|---|---|
invalid_input | order_id isn't an order id. Take one from get_dashboard. |
not_found | No order with that id on this account. |
forbidden | The credential lacks the tool's scope, or an agent's owner has no ScanFree account yet (the owner signs in on the website once). |
Input validation error | An argument doesn't match the schema below. The call fails with MCP error -32602, naming the field. |
Errors before the tool runs (a missing key, too many requests) are on the MCP page.
Example
Example shape; values are illustrative.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "check_status",
"arguments": {
"order_id": "00000000-0000-4000-8000-000000000002"
}
}
}{
"status": "ok",
"order_id": "00000000-0000-4000-8000-000000000002",
"order_state": "active",
"in_progress": {
"check_id": "00000000-0000-4000-8000-000000000003",
"kind": "scheduled",
"started_at": "2026-11-21T09:00:00.000Z",
"answers_in": 36,
"answers_planned": 80
},
"last_finished": {
"check_id": "00000000-0000-4000-8000-000000000008",
"kind": "scheduled",
"status": "complete",
"finished_at": "2026-10-21T09:40:00.000Z"
},
"next_check_at": null,
"message": "A check is running: 36 of 80 answers are in. Call check_status again in about a minute."
}