# Verification history

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

Source: https://warmerly.com/docs/verify/verification-history

```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.

## More from Verify

- [Bulk verification](https://warmerly.com/docs/verify/bulk-verification): Submit a list of addresses as an asynchronous batch, then poll for results. Quota for the full batch size is…
- [Send test (deliverability-grade check)](https://warmerly.com/docs/verify/send-test-deliverability-grade-check): Some addresses cannot be settled by SMTP probing alone, a catch-all domain accepts everything, so "accepted"…
- [Usage / quota](https://warmerly.com/docs/verify/usage-quota): Returns your current verification usage against your plan's limit for the billing period. Checking usage…