## monitors/test-delivery

`GET /v1/monitors/test-delivery`

Sends one clearly-marked sample alert (a short report with receipts) to the destinations given, right now, and reports what each one answered. Nothing is recorded, nothing is charged, and no real finding is involved: it proves the channel works before a monitor is switched on.

*Send a sample alert*

| Parameter | Required | Description |
| --- | --- | --- |
| `destinations` | yes | The destinations to send the sample to, as for monitors/create — e.g. `[{"kind":"endpoint","endpoint_id":"whk_…"}]` |
| `name` | no | The monitor name to show on the sample — e.g. `Monzo complaints` |
| `id` | no | The monitor the sample is sent from, when it already exists: the sample then links to that monitor’s page and takes its name. Without it, the sample links to the monitors list. — e.g. `mon_…` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** free — 0 credits.

```bash
curl "https://www.monocrawl.com/v1/monitors/test-delivery?destinations=%5B%7B%22kind%22%3A%22endpoint%22%2C%22endpoint_id%22%3A%22whk_%E2%80%A6%22%7D%5D&id=mon_%E2%80%A6" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "sent": 0,
  "failed": 0,
  "results": [],
  "sample": false,
  "note": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/monitors/test-delivery#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/monitors/test-delivery.json)