Check a monitor now
POST/v1/blocklist/monitors/{id}/check
Checks the lists right away, for example after you asked a list to remove you. A monitor can be checked at most once a minute.
Required scope: domains:manage
Parameters
| Name | In | Description |
|---|---|---|
idrequired | path | The blocklist monitor id. |
Example
curl -X POST 'https://api.sendsend.email/v1/blocklist/monitors/ID/check' \
-H "Authorization: Bearer $SENDSEND_API_KEY"Response 200
{
"id": "blm_7c1d…",
"object": "blocklist_monitor",
"kind": "domain",
"target": "acme.com",
"status": "clean",
"listed_on": [],
"listed_since": null,
"last_checked_at": "2026-10-15T09:00:00.000Z",
"created_at": "2026-10-15T08:59:00.000Z"
}Errors
| Status | Code | When |
|---|---|---|
| 404 | not_found | No such resource in this project. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 403 | forbidden | The key does not have the scope this endpoint needs. |
| 429 | rate_limited | Too many requests. Wait for the number of seconds in the Retry-After header. |
Every error has the same shape. See Errors.