Sessions

Verify the session's records against live DNS

Checks every expected record against authoritative nameservers. When all are present the session is marked verified, the connection is recorded, usage is metered and webhooks fire — all in one transaction, and only on an actual authoritative match. records[].outcome distinguishes a genuine absence (absent), a still-propagating record (propagating), a check that could not be completed (indeterminate) and a domain that does not resolve at all (domain_not_found).

post/api/v1/sessions/{token}/verify

Request

  • Base URL: https://app.dodomain.io
  • URL: https://app.dodomain.io/api/v1/sessions/{token}/verify
  • Auth: none required

Path parameters

tokenstring required

The session token returned by POST /api/v1/sessions (dd_sess_...). This value IS the credential for the operation — treat it like a bearer token and never log or share it.

Response

Success.

verifiedboolean required

Changes

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