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
}

400 Error: Bad Request

Error Message	Description
`DOMAIN_NAME_INVALID`	The provided domain name is invalid
`DOMAIN_NAME_NOT_PROVIDED`	The request does not contain any domain name to search
`INVALID_DOMAIN_SUFFIX`	The provided domain endings in TLD filter are invalid
`NOT_SUPPORTED`	The partner does not provide free domains (for free domain suggestions)
`DOMAIN_LOCK_NOT_AVAILABLE`	The requested domain cannot be reserved. The domain is not available for free or has been minted
`DOMAIN_NAME_NOT_PROVIDED`	The request does not contain any domain name to search
`INVALID_ORDER_SCHEMA`	The order information is not properly formatted or is missing critical information such as payment type
`UNALLOWED_PAYMENT_METHOD`	The payment method is not supported by Unstoppable Domains. Must use Stripe or minted freely
`UNSUPPORTED_PAYMENT_METHOD`	The requested payment method is currently not supported
`INVALID_OWNER_ADDRESS`	The owner address is not valid
`INVALID_EMAIL`	The email address is not valid
`DOMAIN_NOT_AVAILABLE`	The domain name is unavailable for purchase
`USER_NOT_ELIGIBLE`	The provided user is not eligible for a free domain
`WALLET_NOT_ELIGIBLE`	The provided wallet address is not eligible for a free domain
`FREE_DOMAIN_POLICY_VIOLATION`	The provided user has already claimed a free domain before
`INVALID_FINGERPRINTJS_VISIT`	The provided Fingerprint Visitor ID is invalid or is older than 30 seconds
`MISSING_FINGERPRINTJS_VISITOR_ID`	The request does not contain a Fingerprint Visitor ID
`SECURITY_PARAMS_NOT_PROVIDED`	The request does not contain any security parameters
`UNSUPPORTED_SECURITY_TYPE`	The requested security type is currently not supported
`QUERY_ARGUMENT_REQUIRED`	The request does not contain critical query parameters
`BRIDGE_DISABLED`	The Polygon bridge feature flag is not enabled in your environment
`REQUEST_INVALID`	The request body is not properly formatted or is missing critical information

401 Error: Unauthorized

Error Message	Description
`PARTNER_NOT_FOUND`	The requested Partner is not found

404 Error: Not Found

Error Message	Description
`ORDER_NOT_FOUND`	The requested order is not found
`DOMAIN_NOT_FOUND`	The requested domain name is not registered
`ACTION_NOT_FOUND`	The requested domain action is not found

Asking For Help

If you are experiencing difficulties using our services, please know that we are here to help. You can join our Discord Community for real-time support from UD and the community, where you can receive assistance with integrating your app