Skip to Content
SendlySendly
API ReferenceValidation

List a validation run's results

GET
/api/v1/validation-runs/{id}/results

One page of a run's verdicts, cursor-paginated. Filter with verdict — undeliverable is the page you want when you are about to act on the results.

No total is reported: a run over a large list holds millions of rows, and counting them on every page read is the query this design exists to avoid. The run's own counters carry the numbers worth having.

contact_id is the contact the address belonged to when it was checked, and it is null for a contact deleted since. The email is stored on the result rather than read through the contact, so a completed run reports what it actually checked even after the contact changed address.

Requires the validation:read scope — View your email validation runs and their results.

headerAuthorizationBearer <API Key>

API key authentication. Use a sk_* (FULL) or pk_* (SENDING_ONLY) key as the bearer token. Public keys (pk_*) are restricted to the email-send endpoints and the self-serve list subscribe/unsubscribe pair; every other endpoint — event tracking included — answers 403 for them. In scope terms (used by /api/v1/* operations): FULL keys hold every scope; SENDING_ONLY keys hold only emails:send.

id*string

Resource id.

Formatuuid
limit?integer
Range1 <= value <= 200
Default50
after?string

Opaque cursor from a previous response's next_cursor.

Length1 <= length
verdict?string

Return only results with this verdict — undeliverable is the usual filter.

Value in"deliverable""undeliverable""risky""unknown"

Response Body

One page of results

application/json
  1. response

One page of a run's results. No total — a run over a large list holds millions of rows, and the run's own counters are the numbers worth reading.

data*array<>
has_more*boolean
next_cursor*|

Pass as after to fetch the next page. null on the last page.

Example Request
curl -X GET 'https://api.sendly.now/api/v1/validation-runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/results'
Example Response
{  "data": [    {      "email": "string",      "verdict": "deliverable",      "is_disposable": true,      "is_role_address": true,      "is_personal": true,      "has_mx_records": true,      "reasons": [        "string"      ],      "contact_id": "string"    }  ],  "has_more": true,  "next_cursor": "string"}