Skip to main content
GET
List Domains

Authorizations

Authorization
string
header
required

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-10-06-2"

Query Parameters

account_id
string

Only domains belonging to this account, prefixed biz_.

app_id
string

Only domains assigned to this app, prefixed app_.

status
enum<string>

Only domains with this lifecycle status. Removed and failed domains aren't listed; retrieve them by ID.

Available options:
pending_verification,
awaiting_payment,
registering,
provisioning,
active,
action_required,
deleting,
expired
order
enum<string>

Field to sort by.

Available options:
created_at,
updated_at
direction
enum<string>

Sort direction.

Available options:
asc,
desc
first
integer
default:20

Number of results to return from the start of the range.

Required range: x <= 100
after
string

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

last
integer

Number of results to return from the end of the range.

Required range: x <= 100
before
string

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

A name or domain to find domains to buy, such as example or example.com; a subdomain or URL searches its registrable domain. Returns search results instead of your domains, without other filters or pagination.

tlds
string[]

With search, check only these extensions, such as com or co.uk, returned in this order. Repeat for several, up to 100.

domain
string

Only your domain with this hostname, such as example.com.

Response

Domain list

data
object[]
required
page_info
object
required