Validation

List a validation run's 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.

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

Request

  • Base URL: https://api.sendly.now
  • URL: https://api.sendly.now/api/v1/validation-runs/{id}/results
  • Auth: one of:
    • HTTP bearer
    • API key in cookie better-auth.session_token
    • OAuth 2 (authorization code, authorization URL https://app.sendly.now/api/auth/oauth2/authorize, token URL https://app.sendly.now/api/auth/oauth2/token, scopes: validation:read)

Path parameters

idstring uuid required

Resource id.

Query parameters

limitinteger
afterstring

Opaque cursor from a previous response's next_cursor.

verdict'deliverable' | 'undeliverable' | 'risky' | 'unknown'

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

Response

One page of results

has_moreboolean required
next_cursorstring nullable required

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

Changes

No recorded changes to this operation across all 1 revision of this API.