Domains/list_domains
Tool · Domains

list_domains

List the caller's registered domains with expiry dates, optionally filtered by name, 100 per page.

Read-onlyIdempotentscope read:domains

Invoked over the MCP transport with a tools/call request naming this tool.

Authorization #

Requires a valid OAuth 2.1 bearer access_token whose grant includes the read:domains scope — View your registered domains and their details. The broker resolves the caller from the token and returns only records the account owns.

Parameters #

searchstringOptional
Optional case-insensitive substring of the domain name, e.g. "example" or ".bg". Omit to list every domain.
limitintegerOptional
Maximum domains to return. Capped at 100; omit for 100.
offsetintegerOptional
Number of matching domains to skip, for the next page. Use the previous offset + limit when "truncated" is true.

Response #

200 · application/json

domainsarray<object>
idinteger
domain_namestring
statusstring
One of: Active Expired Pending Pending Registration Pending Transfer Transferred Away Cancelled Grace Fraud
expiry_datestring · null
recurring_amountobject
valuestring
currencystring
first_payment_amountobject
valuestring
currencystring
totalinteger
offsetinteger
limitinteger
truncatedboolean