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

Retrieve a domain claim

Retrieves the latest claim for the placeholder domain created by a domain claim. Use the claim status and TXT record details to track verification and prove ownership of the claimed domain.

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

1 status code
200Returns the latest claim object, including its status, claimed domain name, TXT record details, and any applicable blocked 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 a claim.