Error Codes for Troubleshooting

Partner API errors are in JSON format.

Copy

Copied

{
  code: string,         // string error code
  message: string,      // error message
  field: string | null, // request field that caused the error
  value: string | null, // request value that caused the error
  status: number        // error status
}

GET Domain name

Error Code	Status Code	Explanation
DOMAIN_NAME_INVALID	400	The provided domain name is invalid.

GET Domains Suggestions

Error Code	Status Code	Explanation
INVALID_DOMAIN_SUFFIX	400	Provided domain endings in TLD filter are invalid.

GET Domains Suggestions Free

Error Code	Status Code	Explanation
INVALID_DOMAIN_SUFFIX	400	Provided domain endings in TLD filter are invalid.
NOT_SUPPORTED	400	The partner does not provide free domains (for free domain suggestions).

POST Orders

Error Code	Status Code	Explanation
INVALID_ORDER_SCHEMA	400	Order information is not properly formatted or is missing critical information such as payment type.
UNALLOWED_PAYMENT_METHOD	400	Payment method is not supported by UD. Must use Stripe or Coinbase.
UNSUPPORTED_PAYMENT_METHOD	400	Requested payment method is currently not supported.
INVALID_OWNER_ADDRESS	400	Owner address is not valid.
INVALID_EMAIL	400	Email address is not valid.
DOMAIN_NOT_AVAILABLE	400	Domain name is unavailable for purchase.
USER_NOT_ELIGIBLE	400	The provided user is not eligible for a free domain.
WALLET_NOT_ELIGIBLE	400	The provided wallet address is not eligible for a free domain.
FREE_DOMAIN_POLICY_VIOLATION	400	The provided user has already claimed a free domain before.
INVALID_FINGERPRINTJS_VISIT	400	The provided FingerprintJS Visitor ID is invalid or is older than 30 seconds.
MISSING_FINGERPRINTJS_VISITOR_ID	400	The request does not contain a FingerprintJS Visitor ID.
SECURITY_PARAMS_NOT_PROVIDED	400	The request does not contain any security parameters.
UNSUPPORTED_SECURITY_TYPE	400	Requested security type is currently not supported.
DOMAIN_RESERVED	400	Requested domain has been reserved by another partner.

GET Order Number

Error Code	Status Code	Explanation
ORDER_NOT_FOUND	404	Order is not found.

Asking For Help

Having troubles using our services? We’re here to help. Join our Discord Community for real-time support from UD and the community if you need assistance integrating your app.