# Check an e-mail sender's DNS now

`POST https://api.parasend.com/v1/email_senders/{id}/check`

Source: https://parasend.com/docs/api/email-senders/check

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.

Checks the sender's DNS records now, instead of waiting for the next automatic check (every 15 minutes, and every minute while the sender is being set up), and returns the sender as it now stands, with every record and whether it was seen. At most once per 30 seconds per sender and 30 times an hour per organisation, else 429 too_many_checks. A failed sender whose records are right again starts over, with fresh DKIM records. 409 email_sender_removed for a removed sender. Needs brand_profiles read.

## Path parameters

- `id` (string, required)

## Example: Check an e-mail sender's DNS now

```bash
curl -X POST "https://api.parasend.com/v1/email_senders/{id}/check" \
  -H "Authorization: Bearer $PARASEND_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

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

## Response 200

The sender as it now stands.

Content type: application/json.

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