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