---
title: "Check your missing-data report"
method: GET
path: "/api/v1/data-reports/{reportId}"
tags: ["Data reports"]
---

# Check your missing-data report

`GET /api/v1/data-reports/{reportId}`

## Request

- Base URL: `https://aicdapi.com`
- URL: `https://aicdapi.com/api/v1/data-reports/{reportId}`
- Auth: HTTP bearer

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.

## Path parameters

- `reportId` string, uuid, required

## Response `200`

The customer's current report status.

- DataReportStatusEnvelope
  - `data` object, required
    - `reportId` string, uuid, required
    - `status` 'received' | 'validating' | 'investigating' | 'fixing' | 'verifying' | 'resolved' | 'needs_review' | 'not_missing' | 'out_of_coverage' | 'unable_to_verify', required
    - `submittedAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `closedAt` string, date-time
    - `nextCheckAt` string, date-time
    - `reasonCode` 'already_present' | 'query_mismatch' | 'publication_delay' | 'coverage_gap' | 'discovery_failure' | 'fetch_failure' | 'extraction_failure' | 'classification_failure' | 'search_index_failure' | 'feed_sync_failure' | 'unverified'
    - `finding` string
    - `nextAction` string
    - `verifiedRecords` object[], required
      - `itemId` string, uuid, required
      - `sourceUrl` string, required
      - `title` string

## Other responses

- `400`: The report input or report ID is invalid.
- `401`: The API key is missing, invalid, expired, or revoked.
- `403`: The credential or workspace is not allowed to report.
- `404`: No report with that ID is available to this customer.
- `429`: 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`: A required access, limit, policy, or queue control is unavailable.

---

[API](https://skmtc.dev/aicdapi/apis/aicd-api.md) · [All operations](https://skmtc.dev/aicdapi/apis/aicd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aicdapi/apis/aicd-api/revisions/0f3752fae465?raw)