Verification history

API referenceVerify

From the Verify API reference. Requests use the base URL https://app.warmerly.com/api/v1 and an API key, see Authentication.

text

GET /verify/history

Returns the recent single verifications (from POST /verify) recorded against your active workspace, most recent first, cursor-paginated.

Query param	Type	Required	Description
`cursor`	ISO 8601 timestamp	No	Fetch results older than this timestamp. Use the previous response's `nextCursor`.
`limit`	integer	No	Page size, 1-100. Default `25`.

An invalid cursor or limit returns 400 bad_request (invalid_query).

bash

curl "https://app.warmerly.com/api/v1/verify/history?limit=25" \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

json

{
  "checks": [
    {
      "id": "b2b7c9a0-1e3f-4a2b-9c1d-4e8f0a2b3c4d",
      "email": "jane@example.com",
      "status": "valid",
      "confidence": 95,
      "reason": "mailbox_accepts",
      "checks": { "...": "..." },
      "confirmedStatus": null,
      "sendTestStatus": null,
      "createdAt": "2026-07-02T10:14:03.000Z"
    }
  ],
  "nextCursor": "2026-07-02T09:58:11.000Z"
}

confirmedStatus and sendTestStatus reflect a follow-up bounce-probe test send linked to the check (confirmedStatus is valid or invalid once resolved); both are null if no test was linked. nextCursor is null once you've reached the end of history.

Was this page helpful?

Verification history

More from Verify