Edit this page

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.