Error Codes

Complete reference of 23 error codes across 5 categories returned by the Domains Service.

Error response formatjson

{
  "statusCode": 404,
  "timestamp": "2026-02-22T10:30:00.000Z",
  "path": "/domains/v1/abc-123",
  "method": "GET",
  "message": "Domain not found",
  "errorCode": "DOMAIN_001"
}

Domain LifecycleDOMAIN_001-005

Code	HTTP	Name	Description	Resolution
`DOMAIN_001`	404	`DOMAIN_NOT_FOUND`	Domain not found	Verify the domain ID is correct and belongs to your tenant
`DOMAIN_002`	409	`DOMAIN_ALREADY_EXISTS`	Domain already registered	Check if the domain belongs to your tenant. Use the transfer API if needed.
`DOMAIN_003`	400	`DOMAIN_UNAVAILABLE`	Domain unavailable for registration	Verify domain availability with a WHOIS lookup. Try an alternative TLD.
`DOMAIN_004`	422	`DOMAIN_VERIFICATION_FAILED`	Domain verification failed	Ensure TXT or CNAME record is correctly configured. Allow up to 5 minutes for propagation.
`DOMAIN_005`	400	`DOMAIN_UPDATE_FAILED`	Domain update failed	Confirm the domain is in VERIFIED or PENDING status. Check the update DTO schema.

Quota & PaymentDOMAIN_006-008

Code	HTTP	Name	Description	Resolution
`DOMAIN_006`	403	`QUOTA_EXCEEDED`	Domain quota exceeded for subscription tier	Upgrade the subscription tier or delete unused domains
`DOMAIN_007`	402	`INSUFFICIENT_FUNDS`	Insufficient wallet balance	Top up the wallet via wallet-svc. Check balance with GET /wallet/v1/balance.
`DOMAIN_008`	422	`DNS_CONFIGURATION_FAILED`	DNS configuration failed	Check DNS validation rules: TTL must be 60-86400s, CNAME cannot coexist with other types.

DNS & SSL & CDNDOMAIN_009-013

Code	HTTP	Name	Description	Resolution
`DOMAIN_009`	404	`DNS_RECORD_NOT_FOUND`	DNS record not found	List DNS records with GET /domains/v1/:id/dns to find valid record IDs
`DOMAIN_010`	408	`DNS_PROPAGATION_TIMEOUT`	DNS propagation timeout	DNS propagation can take up to 48 hours. Retry later. Check with 8.8.8.8, 1.1.1.1.
`DOMAIN_011`	503	`SSL_ISSUANCE_FAILED`	SSL certificate issuance failed	Retry after a few minutes. Check AWS ACM service status.
`DOMAIN_012`	404	`SSL_CERTIFICATE_NOT_FOUND`	SSL certificate not found	Issue a certificate first via POST /domains/v1/:id/ssl
`DOMAIN_013`	503	`CDN_PROVISIONING_FAILED`	CDN provisioning failed	Retry after a few minutes. Check AWS CloudFront service status and account limits.

Routes & TransfersDOMAIN_014-018

Code	HTTP	Name	Description	Resolution
`DOMAIN_014`	404	`ROUTE_NOT_FOUND`	Route not found	List routes with GET /domains/v1/:id/routes to find valid route IDs
`DOMAIN_015`	409	`ROUTE_CONFLICT`	Route path already exists for domain	Modify the conflicting route or use a different path
`DOMAIN_016`	503	`TRANSFER_FAILED`	Domain transfer failed	Retry after a few minutes. Verify registrar API credentials.
`DOMAIN_017`	404	`TRANSFER_NOT_FOUND`	Domain transfer not found	List transfers with GET /domains/v1/transfers to find valid IDs
`DOMAIN_018`	400	`INVALID_AUTH_CODE`	Invalid authorization code	Verify the auth code from the current registrar is correct and unexpired

Health & IntegrationsDOMAIN_019-023

Code	HTTP	Name	Description	Resolution
`DOMAIN_019`	500	`HEALTH_CHECK_FAILED`	Domain health check failed	Check domain configuration and DNS resolution
`DOMAIN_020`	503	`INTEGRATION_REGISTRAR_FAILED`	Integration with registrar failed	Check registrar status page. Verify API credentials. Retry with backoff.
`DOMAIN_021`	503	`INTEGRATION_CDN_FAILED`	CDN integration failed	Check AWS CloudFront service health. Verify IAM permissions.
`DOMAIN_022`	503	`INTEGRATION_DNS_FAILED`	DNS integration failed	Check DNS provider service health. Verify API credentials.
`DOMAIN_023`	503	`INTEGRATION_SSL_FAILED`	SSL integration failed	Check SSL provider service health. Verify ACM permissions and quotas.