GET `/v1/checks`

Lists the caller's checks, most recent first. All filters are optional and combine.

http

GET /v1/checks?from=2026-09-01&to=2026-09-30&reference=F-2026-0417
Authorization: Bearer ak_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

http

GET /v1/checks?valid=false&from=2026-09-01&to=2026-09-30
Authorization: Bearer ak_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Parameter	Meaning
`vat_number`	VAT number to filter on (any formatting)
`reference`	exact match after the same trimming as on input
`from`	`YYYY-MM-DD`, created on that UTC day or later
`to`	`YYYY-MM-DD`, created on that UTC day or earlier (inclusive, like the audit export)
`confidence`	one of `confirmed`, `probable`, `degraded`, `unverified`, `invalid`
`valid`	`true` or `false`; checks with unknown validity match neither
`limit`	page size, default 20, capped at 100
`cursor`	opaque cursor from a previous page's `next_cursor`

json

{
  "items": [
    { "check_id": "chk_01J9X0000000000000000000", "...": "one full check response object per item" }
  ],
  "next_cursor": "chk_01J9X0000000000000000000"
}

next_cursor is "" when there is no further page.

A malformed date, from after to, or an unknown confidence/valid value is a 400 BAD_REQUEST naming the parameter. Test keys only see test checks (see Test keys).