# List the account's address monitors

`GET /api/v1/address/monitors`

- Authentication: Secret API key as a bearer token
- Billing: Free.
- Group: Address

The saved address lists this account re-checks on a schedule, newest first, 100 per page. Each monitor carries the summary of its last run: how many addresses were `ok`, how many fired each of the five conditions, how many were `unverifiable` (valid, but no dataset installed for the country could say anything about the place), how many changed status, how many newly became flagged, the credits the run spent, and whether it stopped for lack of credits. The addresses and their statuses are on the single-monitor endpoint.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | integer | no | The page to return. Default: 1. |

## Example request

```bash
curl https://spaw.co/api/v1/address/monitors \
  -H "Authorization: Bearer sk_live_…"
```

## Responses

### 200 — One page of monitors.

```json
{
    "success": true,
    "data": {
        "monitors": [
            {
                "id": 9,
                "name": "Supplier offices",
                "cadence": "monthly",
                "address_count": 2,
                "country": "GB",
                "deliverability": false,
                "next_run_at": "2026-10-05T08:00:00+00:00",
                "last_run_at": "2026-09-05T08:00:04+00:00",
                "last_summary": {
                    "total": 2,
                    "ok": 1,
                    "invalid": 0,
                    "not_in_register": 1,
                    "terminated_postcode": 0,
                    "mail_drop": 0,
                    "high_risk": 0,
                    "unverifiable": 0,
                    "changed": 1,
                    "newly_flagged": 1,
                    "credits_used": 2,
                    "stopped_reason": null
                },
                "created_at": "2026-08-05T08:00:00+00:00"
            }
        ]
    },
    "meta": {
        "page": 1,
        "per_page": 100,
        "total": 1
    }
}
```

### 401 — The key is missing, malformed, or revoked.

```json
{
    "success": false,
    "error": {
        "code": "UNAUTHENTICATED",
        "message": "Provide a valid API key as a bearer token.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}
```

### 429 — Over 5 requests per second for the key. Retry after the limit resets.

```json
{
    "success": false,
    "error": {
        "code": "RATE_LIMITED",
        "message": "Too many requests. Retry after the limit resets.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}
```

## Error codes

- `UNAUTHENTICATED` — https://spaw.co/docs/errors/UNAUTHENTICATED
- `RATE_LIMITED` — https://spaw.co/docs/errors/RATE_LIMITED

---

Canonical page: https://spaw.co/docs/api/list-address-monitors · OpenAPI document: https://spaw.co/openapi.json · All endpoints: https://spaw.co/docs/api