Resend API (unofficial showcase)
POST/domains/{domain_id}/claim/verify

Verify a domain claim

Triggers asynchronous DNS verification and ownership transfer for a domain claim. The claim remains pending while verification runs, so retrieve the claim to check its status. Once the claim is completed, add the transferred domain's new DKIM records to DNS and verify them with the standard domain verification endpoint.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter
domain_idstringrequired
The ID of the placeholder domain created by the claim.

1 status code
200Returns the claim object, including its current status and any applicable TXT record, blocked reason, or failure reason.
objectstringoptional
The type of object.
idstringoptional
The ID of the claim.
namestringoptional
The name of the domain being claimed.
statusstringoptional
The status of the claim.
Allowed:pendingverifiedcompletedblockedexpiredsupersededcanceledfailed
domain_idstringoptional
The ID of the placeholder domain created for the claim.
regionstringoptional
The region where the claimed domain will send from.
Allowed:us-east-1eu-west-1sa-east-1ap-northeast-1null
recordobjectoptional
The TXT record to add to your DNS to prove ownership of the claimed domain.
blocked_reasonstringoptional
Why the claim is currently blocked, if applicable.
Allowed:grace_periodrecent_owner_activitypending_scheduled_emailsnull
failure_reasonstringoptional
Why the claim failed, if applicable.
created_atstringoptional
The date and time the claim was created.
expires_atstringoptional
The date and time the claim expires if not verified.

Error handling

The domain_id path parameter must identify the placeholder domain created by the claim. After triggering verification, retrieve the claim to check its status; once it is completed, add the new DKIM records to DNS and verify the domain.