Domains

Run a DNS check for this domain now.

Requires manage scope. Rate-limited to 1 request per 60 s per domain id (shared with the account UI's identical action). Queries live DNS for the TXT challenge, SPF, and DKIM CNAME records and persists the result; three consecutive passing checks move the domain to verified, two consecutive failures after that demote it back to verification_lost.

post/v1/domains/{id}/verify

Request

  • Base URL: https://api.inboxy.net
  • URL: https://api.inboxy.net/v1/domains/{id}/verify
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Response

Check run; current state.

idstring uuid required
domainstring required
status'pending' | 'verified' | 'verification_lost' required

verified after 3 consecutive passing checks; demoted to verification_lost after 2 consecutive failures once verified. Verification only — this status never grants a sending capability.

txt_okboolean required

Ownership TXT challenge record found and matching.

spf_state'ok' | 'conflict' | 'missing' | 'null' nullable required
spf_suggestionstring nullable required

Suggested SPF record text. Null iff spf_state is ok.

dkim_cname_okboolean required

DKIM selector CNAME found and matching.

last_checked_atinteger nullable required

Unix seconds.

created_atinteger required

Unix seconds.

verified_atinteger nullable required

Unix seconds of the transition into verified. A re-check that keeps the domain verified, or one that fails without demoting it, never clears this. It IS cleared back to null if the domain is demoted to pending (e.g. by rotating its verify token) — it re-marks the transition on the next fresh verification.

Changes

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