curl --request GET \
--url https://api.interchange.io/api/v2/storefront/house-discounts/resolve \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/storefront/house-discounts/resolve"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/storefront/house-discounts/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"domain": "<string>",
"chain": [
"converse.com",
"nike.com"
],
"house": "nike.com",
"known": true,
"coverage": "registered",
"resolverDegraded": true,
"isTop": true
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Resolve a domain up its corporate hierarchy (authoring preview)
Read-only helper for the authoring UI: resolves a brand or operator domain up its published corporate hierarchy (e.g. converse.com → nike.com) so you can preview where a discount would key before saving it. Creates and matches nothing.
curl --request GET \
--url https://api.interchange.io/api/v2/storefront/house-discounts/resolve \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/storefront/house-discounts/resolve"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/storefront/house-discounts/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"domain": "<string>",
"chain": [
"converse.com",
"nike.com"
],
"house": "nike.com",
"known": true,
"coverage": "registered",
"resolverDegraded": true,
"isTop": true
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Authorizations
API key or access token
Query Parameters
The brand or operator domain to resolve up its corporate hierarchy.
1 - 253"converse.com"
Response
Resolve a domain up its corporate hierarchy (authoring preview)
A domain resolved up its corporate hierarchy for authoring.
Normalized input domain.
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.
["converse.com", "nike.com"]
The corporate house at the top of the chain.
"nike.com"
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.
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.
registered, unregistered, unavailable True when registry resolution failed and the response retained fallback cache evidence; coverage explains whether that evidence is usable.
A known domain that already heads its own house.