Get the holder e-mail verification
GET /api/v2/domains/{id}/email-verification
Shows whether the domain holder has confirmed their e-mail address with the registry. Until it is confirmed the registry can suspend the domain. status is verified when nothing is pending. Otherwise reason explains the state and verification.recipient is the address the e-mail goes to. Resend the e-mail with POST /api/v2/domains/{id}/email-verification/actions/resend when actions.canResend.allowed is true. When the address is on a suspended domain (verification.recipientOnSuspendedDomain), the e-mail cannot arrive. Change the domain holder’s e-mail address in the domain contacts instead. A new verification e-mail then goes to the new address.
Authentication: An API key with the scope read:domains. About keys and scopes
Request
Path parameters
idstringrequiredGET /api/v2/domains.Example
curl "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/email-verification" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 The holder e-mail verification state.
{ "status": "verified", "isVerified": true, "isSuspended": false, "reason": null, "verifiedAt": null, "lastCheckedAt": null, "verification": null, "actions": { "canResend": { "allowed": false, "reason": "No verification email is needed for this domain." } }}{ "status": "pending", "isVerified": false, "isSuspended": false, "reason": "A verification email has been sent to user@example.com. Follow the link in that message to complete verification.", "verifiedAt": null, "lastCheckedAt": "2026-04-27T12:00:00.000Z", "verification": { "method": "email", "recipient": "user@example.com", "txtRecord": null, "expiresAt": "2026-05-11T12:00:00.000Z", "recipientOnSuspendedDomain": false }, "actions": { "canResend": { "allowed": true, "reason": null } }}Response fields
statusstringverified: nothing is pending. pending: an e-mail was sent and waits for the link to be opened. unverified: the address was not confirmed. expired: the link expired. unknown: the state could not be determined. One of verified, unverified, pending, expired, unknown.isVerifiedbooleanstatus is verified.isSuspendedbooleanreasonstring | nullverifiedAtstring | nulllastCheckedAtstring | nullverificationobject | nullmethodstring | nullemail. Null when no recipient is known. One of email, dns_txt, admin_manual, other.recipientstring | nulltxtRecordobject | nullnamestringvaluestringexpiresAtstring | nullrecipientOnSuspendedDomainbooleanactionsobjectcanResendobjectallowedbooleanreasonstring | nullErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is domain_not_found. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |