Skip to main content
POST /api/v2/storefront/resolve-brand Looks up a brand profile on agenticadvertising.org by domain. Returns the brand name, logo URL, and profile metadata when found. When no profile exists, returns resolved: false plus a builderUrl where the brand can register one.

​
Request

curl
curl -X POST https://api.interchange.io/api/v2/storefront/resolve-brand \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "northwind.example" }'

​
Parameters

FieldTypeRequiredNotes
domainstringYesBrand domain to resolve. Must be a valid domain (e.g. "northwind.example")

​
Response

Resolved
{
  "resolved": true,
  "domain": "northwind.example",
  "brandName": "Northwind Athletics",
  "logoUrl": "https://cdn.agenticadvertising.org/logos/northwind.png",
  "logoBackground": "light-bg",
  "manifestUrl": "https://northwind.example/.well-known/brand-manifest.json",
  "manifest": {},
  "registryEntry": {},
  "authorizedOperators": [],
  "houseBrand": {
    "houseName": "Acme House",
    "houseDomain": "acme.example",
    "architecture": "branded_house",
    "brands": []
  }
}
Not resolved
{
  "resolved": false,
  "domain": "newbrand.example.com",
  "error": "Brand profile not found",
  "builderUrl": "https://agenticadvertising.org/brand"
}
FieldTypeDescription
resolvedbooleanWhether a brand profile was found
domainstringThe domain that was resolved
brandNamestringBrand display name. Present when resolved
logoUrlstring | nullBrand logo URL, or null when none is published
logoBackground"dark-bg" | "light-bg" | "transparent-bg" | nullHint for the UI on which background the logo renders well. Present when resolved and a logo exists
manifestUrlstringURL of the resolved brand.json
manifestobjectThe resolved brand.json body
registryEntryobject | nullRaw AAO registry entry, or null
authorizedOperators[]arrayOperators authorized to transact for this brand
houseBrandobject | nullHouse-brand metadata when the brand is a house brand of the operator: { houseName, houseDomain, architecture?, brands[] }. Absent or null when not a house brand
warningstringAdvisory message, when present
errorstringResolution error message, when present
builderUrlstringSet when resolved is false — URL where the brand can register a profile

​
Errors

  • 400 VALIDATION_ERROR — domain missing or empty.
  • 401 UNAUTHORIZED — missing or invalid bearer token.
See Errors for the full error contract.

Storefront tasks

All core storefront operations.

Discover agents

Find the agents authorized for an operator domain.

Buyer instructions

Scope discounts and notes by buyer brand domain.