Edit this page

Partner API Endpoints

For more details about the Partner API endpoints, see the Partner API endpoint specification. These endpoints are specified in OpenAPI format, which provides an interactive API explorer in which you can try out sample API calls.


The Partner API is limited to 60 requests per hour. However, this is subject to change in the future.

The Partner API endpoints are as follows:

  • GET Domain Name Availability : checks the availability of a domain name before purchase
  • GET Get Domains Suggestions: provides domain suggestions based on the entered information
  • GET Get Free Domains Suggestions: provides free domain suggestions based on entered information if the partner is eligible to offer free domains
  • POST Buy a Domain or Claim Free Domain : used to buy domains or mint free domains from Unstoppable Domains
  • GET Get Order Status : provides the status of your order and tells if the domain has successfully "minted"
  • POST Reserve Free Domain : reserves a free and available domain for seven days; the domain is automatically unlocked if it is not minted within seven days
  • POST Get Fingerprint Public Key : provides a Fingerprint public key to generate a Visitor ID for your order security; the endpoint returns a different key when called to avoid rate limitations.

The generated Fingerprint Visitor ID will always be the same despite the different public keys being returned.


To reserve or lock a free domain, the partner must provide a unique user identifier (this could be an email or some other internal user identifier). The same identifier must be provided in the resellerIdentityKey parameter when minting the domain (using the Orders endpoint).

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.

Help Us Improve

We’d be eternally grateful if you could answer a few quick questions about your experience that would help us improve our Partner API.