# Check your missing-data report

`GET /api/v1/data-reports/{reportId}` - [human page](https://aicdapi.com/api-reference#getDataReport)

**Release status.** Limited availability

Limited release. Any active API key can check a report, with the same access as submission: no scope and no report permission, and the account needs current paid access. A status read takes no extra payment. Returns only this customer's report and safe findings. Other-customer IDs are treated as not found. Follow nextCheckAt instead of polling in a loop. A status read does not consume paid data-call usage.

**Authentication.** Customer API key: `Authorization: Bearer aicd_...`. A browser session does not authenticate this endpoint. It requires no scope; the account's own access rules still apply.

### Parameters

| Field | Type | Required | Bounds | Description |
| --- | --- | --- | --- | --- |
| `path reportId` | string (uuid) | yes |  |  |

### Example request

```bash
curl -X GET 'https://aicdapi.com/api/v1/data-reports/{reportId}' \
  -H "Authorization: Bearer $AICD_API_KEY"
```

### Response 200

The customer's current report status.

| Field | Type | Required | Bounds | Description |
| --- | --- | --- | --- | --- |
| `data` | object | yes |  |  |
| `data.reportId` | string (uuid) | yes | pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$ |  |
| `data.status` | one of 10 values | yes |  |  |
| `data.submittedAt` | string (date-time) | yes | pattern ^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$ |  |
| `data.updatedAt` | string (date-time) | yes | pattern ^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$ |  |
| `data.closedAt` | string (date-time) | no | pattern ^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$ |  |
| `data.nextCheckAt` | string (date-time) | no | pattern ^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$ |  |
| `data.reasonCode` | one of 11 values | no |  |  |
| `data.finding` | string | no | length 1..1000 |  |
| `data.nextAction` | string | no | length 1..500 |  |
| `data.verifiedRecords` | object[] | yes | max 20 items |  |

### Errors

| Status | `error.code` | Description |
| --- | --- | --- |
| **400** | `invalid_input` | The report input or report ID is invalid. |
| **401** | `unauthorized` | The API key is missing, invalid, expired, or revoked. |
| **403** | `forbidden` | The credential or workspace is not allowed to report. |
| **404** | `report_not_found` | No report with that ID is available to this customer. |
| **429** | `rate_limited`, `status_rate_limited` | A report limit was reached, or the account-wide abuse ceiling was reached. The abuse ceiling is account-wide and is not charged against the paid quota. Retry after the stated delay. |
| **503** | `authentication_unavailable` | A required access, limit, policy, or queue control is unavailable. |

### Behaviour

- **Retry-After.** Sent on 429 only, as whole seconds.
- **Caching.** Customer report responses must not be cached.