Skip to main content
GET
Look up one directory entry

Authorizations

X-API-Key
string
header
required

Path Parameters

profile_id
string<uuid>
required

Response

Response

Body for GET /directory/businesses/{id}: the full entry.

id
string<uuid>
required

The directory entry's id — resolvable via GET /directory/businesses/{id}.

display_name
string
required

The business's display name.

domain
string
required

The merchant's canonical domain, where its kya-profile.json and counterparty credential are served.

kyb_verified
boolean
required

Whether the entry is backed by a business whose public registry record is current: an active registration in good standing. Derived from public records, never from any organization's private evaluation; always false for an entry with no linked business.

website
string | null

The business's website URL.

logo_url
string | null

URL of the business's logo.

summary
string | null

A short description of what the business does.

payment_rails
enum<string>[]

The agentic payment rails the business advertises accepting.

A payment method a directory-listed business accepts from agents.

Self-declared commerce metadata on a KYA directory entry — which rails (protocols or card-network agent programs) the merchant advertises for agentic checkout. Advisory only: nothing in the platform settles on these rails, so the vocabulary is expected to grow with the ecosystem and OTHER absorbs rails we have not named yet.

Available options:
X402,
MPP,
UCP,
VISA_TAP,
VISA_INTELLIGENT_COMMERCE,
MASTERCARD_AGENT_PAY,
GOOGLE_AP2,
STRIPE_ACP,
OTHER
registry_record
DirectoryRegistryRecordResponse (v1) · object | null

The public-record identity of the linked business — legal name and incorporation facts; null for an entry with no linked business, which is also always unverified.

contacts
DirectoryContact · object[]

Points of contact the business publishes for questions — self-declared business-role details, never verification data.

kya_profile
DisclosureProfile · object | null

The business's published kya-profile.json: the disclosure scopes it requests, each naming the fields, purpose, legal basis, and retention behind one use case.

counterparty_credential
DirectoryCounterpartyCredentialResponse (v1) · object | null

The serving state of the counterparty credential this entry's domain hosts; null when the entry has no linked business, or that business never minted one for this domain.