Hanzo
OpenapiDomain

Is the domains your org has bought here, newest registration first, each…

Is the domains your org has bought here, newest registration first, each carrying the name, when it was registered, when it expires, what the org paid,…

GET /v1/domain/domains

Addresshttps://api.hanzo.ai/v1/domain/domains
MethodGET
Operationget_domain_domains
AuthAuthorization: Bearer $HANZO_API_KEY

Is the domains your org has bought here, newest registration first, each carrying the name, when it was registered, when it expires, what the org paid, the registrar order id and the nameservers it points at.

Scoped to the validated principal's org — 403 without one, and there is no parameter that reaches another org's holdings.

This is the deployment's OWN ownership record, not a query to the registrar: it lists what was bought THROUGH this surface, so a domain the org holds elsewhere is not here. The default store is in-process, so a deployment that has not swapped in a durable store answers from what this process registered.

Request

GET /v1/domain/domains takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200holdingsok

200 body — 9 fields.

FieldInTypeAlwaysDescription
domainsbodyHolding[]Domains is the caller org's domains, newest registration first.
domains[].costCentsbodyintegerwholesale cost
domains[].domainbodystringthe name owned
domains[].expiresAtbodystringwhen the registration lapses, RFC3339
domains[].nameserversbodystring[]the authoritative nameservers the name points at
domains[].orderbodyintegerregistrar order id
domains[].orgbodystringthe org that owns the domain
domains[].priceCentsbodyintegerwhat the customer paid (sell)
domains[].registeredAtbodyintegerunix seconds

Failure carries the platform error shape — see Errors.

Examples

hanzo domain domains

Domain API · All Hanzo APIs · Interactive reference

How is this guide?

On this page