Verify a domain

POSThttps://api.mailfully.com/v1/domains/{id}/verify

Re-checks DNS and returns the domain's current status (no DNS records). Checking stops 72 hours after the domain was added or last restarted; send restart_if_failed: true to start a new 72-hour window for a failed domain. Overall verified requires both DKIM and MAIL FROM verified; DMARC is advisory and not part of the gate. Requires the send scope. The request body is optional.

Loading code example

Loading code example

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

idstringrequired

The domain id (dom_…).

Body

restart_if_failedboolean

When true, a failed domain starts a new 72-hour verification window. Defaults to false.

Response

application/json

The domain with freshly evaluated statuses.

object"domain"required

Allowed values: "domain"

idstringrequired

namestringrequired

regionstringrequired

Internal. You can ignore this field.

mail_from_subdomainstringrequired

dkim_tokensarray<string>required

dkim_status"not_started" | "pending" | "verified" | "failed"required

Allowed values: "not_started" | "pending" | "verified" | "failed"

mail_from_status"not_started" | "pending" | "verified" | "failed"required

Allowed values: "not_started" | "pending" | "verified" | "failed"

dmarc_status"not_started" | "pending" | "verified" | "failed"required

Allowed values: "not_started" | "pending" | "verified" | "failed"

tracking_status"not_started" | "pending" | "verified" | "failed"required

Allowed values: "not_started" | "pending" | "verified" | "failed"

tracking_enabledbooleanrequired

config_setstringrequired

Internal. You can ignore this field.

status"pending" | "verified" | "failed" | "partially_verified"required

Allowed values: "pending" | "verified" | "failed" | "partially_verified"

created_atstring<date-time>required

receivingbooleanrequired

Whether the domain receives email. See Receiving email.