Get one bought domain
get_bought_domain
Reads one domain the workspace bought, with its registrant for the workspace owner.
The answer carries everything list_bought_domains returns for the domain, the four auto-renew fields, RenewBy, the last day an expired domain can still be renewed, and the three Verification fields included, plus TransferLockExpires_At, set while the registrar keeps its own lock on the domain, for example after a change of owner, and Contact, the registrant on file. Contact is filled in only for the workspace owner, and CanSeeContact says whether it was. Verification_Email, the address Name.com sent its verification link to, is filled in only for the workspace owner while Verification is pending or suspended. Every member of the workspace can read the domain.
Reading it also refreshes the domain from Name.com in the background, at most every 15 minutes, so a change made at the registrar shows on a later read. See Open a domain's page.
Request
Call it with a POST to https://api.modulify.ai/v1/get_bought_domain, sending the inputs below as a JSON object. The token needs the domains:read scope.
It only reads and changes nothing, so retrying it is safe.
curl -X POST https://api.modulify.ai/v1/get_bought_domain \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"workspaceId":"WORKSPACE_ID","domainId":"DOMAIN_ID"}'Over MCP, the same method is the get_bought_domain tool.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
workspaceId |
string | Yes | The workspace that owns the domain. |
domainId |
string | Yes | The _id of the bought domain, from list_bought_domains. |
Response
Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.