The .box Search API enables your users to search for .box domains through your platform and get redirected to the purchase flow on my.box
You will be rewarded $18 USDC per domain sold via your platform (15% of our revenue)
If you are interested in becoming a Search API referral partner, don't hesitate to get in touch with us at or message our Community Lead, on Telegram
Initial Setup Steps
Send the My.box team a wallet address. This wallet address is where your referral rewards will be received
Send the My.box team your development environment identifiers to be whitelisted. These will be URLs/IPs depending on your integration approach:
Frontend Integration
Send us your Allowed Origins (URLs) to be configured for frontend access:
HTTPS/HTTP and wildcards forsubdomains are supported (e.g. *domain.box)
Ports forlocalhost dev access are supported by adding the origin:
https?://[a-z].?localhost:[0-9]*
Backend Integration
Send us your Allowed Servers (IPs) to be configured for server access:
All server access IPV4 (0.0.0.0/0) is supported for development if required
All server access IPV6 (::/0) is supported for development if required
Server IP ranges are supported (ideally to limit access)
(Optional) Send us your Allowed Origins (URLs) to be configured for frontend access
If your integration also includes a frontend component, we recommend sending us the corresponding URLs to be whitelisted as well for best security practices. See:Frontend Integration
(Optional) For testing purposes only: Please advise us if your developers need TEMPORARY API access from their local environments and tools like Postman and we can add a special "allow ALL IPs" configuration: 0.0.0.0/0Note: this will make our API with your API Key accessible from all IPs. While you are still protected by your dedicated API Key, we recommend that this option be removed as soon as you go live.
The My.box team will send you an API key
Your team can find the registry.swagger.json file below which can be imported into Postman or Insomnia
Integrating the Search API
Import the Swagger file into Postman or Insomnia
Edit the Authorization tab with the provided x-api-key
Update the domain query param with the desired domain name to search
Open API 3.0 Spec (swagger)
The open API spec can be imported into Postman for testing the endpoint. Once imported, edit the authorization tab with the provided x-api-key and update the domain query param with the desired domain name you’d like to search
Domain status descriptions:
“LIVE” Domain is Unavailable and Tokenized. Examples, josh.box, areeb.box, adam.box, ronen.box
“UNAVAILABLE” - Domain is Unavailable and NOT Tokenized (Reserved/Evergreen, Banned, serverHold, pendingDelete, PendingCreate). Examples, china.box
“INVALID_DOMAIN” domain name failed validation. Examples, josh--.box, domains >63 chars
“AVAILABLE” Domain is available for purchase/registration
For domains with the AVAILABLE status, we recommend using the “href” callback URL parameter to route your users to my.box. This will ensure proper referral attribution.