# Monitors, history, and safe retries over the API

Scheduled list monitors and the verification history are now available to integrations, and bulk creation can be retried without queueing twice.

Date: 2026-09-03

- Monitors over the API: `GET`, `POST` and `DELETE /api/v1/email/monitors`, `GET /api/v1/email/monitors/{id}` with the last run's verdict per address, and `POST /api/v1/email/monitors/{id}/run` to re-verify now. The same 500-address lists, weekly or monthly cadences and decay alerts as the dashboard.
- History over the API: `GET /api/v1/email/history` lists every lookup the account ran through any channel, newest first, with filters for verdict, address, date range and channel.
- Bulk creation accepts an `Idempotency-Key` header. A retry with the same key and request replays the job it created, with `Idempotent-Replayed: true` and the same webhook secret, instead of queueing a second run; the same key with a different request answers `409 IDEMPOTENCY_KEY_REUSED`.
- Every new endpoint has a reference page under the API docs and a Markdown twin.

Reference: https://spaw.co/changelog/2026-09-03-monitors-history-api