# Send a reminder

`POST https://api.parasend.com/v1/deliveries/{id}/remind`

Source: https://parasend.com/docs/api/deliveries/remind

Authentication: `Authorization: Bearer <API key>` (a `ps_test_` key in test mode, `ps_live_` in live mode).
Send an `Idempotency-Key` header: a retry with the same key returns the first answer.

Capped at 10 per recipient per day. The response includes the remaining quota so clients can show "1 of 10 used today".

## Path parameters

- `id` (string, required): The delivery's ID, starting `dlv_`.

## Example: Send a reminder

```bash
curl -X POST "https://api.parasend.com/v1/deliveries/dlv_01M6R27T05512SCV3852TPM2XY/remind" \
  -H "Authorization: Bearer $PARASEND_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

```js
const res = await fetch('https://api.parasend.com/v1/deliveries/dlv_01M6R27T05512SCV3852TPM2XY/remind', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
  },
});
const data = await res.json();
```

## Response 200

Reminder dispatched.

```json
{
  "delivery_id": "dlv_01M6R27T05512SCV3852TPM2XY",
  "reminded_at": "2026-11-06T09:15:05.736Z",
  "reminders_used_today": 1,
  "reminders_remaining_today": 9
}
```

Errors: one shape, `{"error": {type, code, message, param, request_id}}`; every code is listed at https://parasend.com/docs/errors.
