Skip to main content
GET
Resolve a domain up its corporate hierarchy (authoring preview)

Authorizations

Authorization
string
header
required

API key or access token

Query Parameters

domain
string
required

The brand or operator domain to resolve up its corporate hierarchy.

Required string length: 1 - 253
Example:

"converse.com"

Response

Resolve a domain up its corporate hierarchy (authoring preview)

A domain resolved up its corporate hierarchy for authoring.

domain
string
required

Normalized input domain.

chain
string[]
required

Ordered self → … → house. A single element means the domain heads its own house or only a self-domain fallback is available; use coverage to distinguish unregistered from unavailable.

Example:
house
string
required

The corporate house at the top of the chain.

Example:

"nike.com"

known
boolean
required

Whether usable published hierarchy evidence exists. False means the domain is unregistered or hierarchy evidence is unavailable; inspect coverage before treating that as a definitive no-match.

coverage
enum<string>
required

Hierarchy coverage state: registered means usable registry/upstream or cached hierarchy evidence, unregistered means a definitive self-domain fallback, and unavailable means no usable evidence was available.

Available options:
registered,
unregistered,
unavailable
resolverDegraded
boolean
required

True when registry resolution failed and the response retained fallback cache evidence; coverage explains whether that evidence is usable.

isTop
boolean
required

A known domain that already heads its own house.