Mint a counterparty credential for a business's web domain

post

https://api.baselayer.com/credentials/counterparty

Mints the domain-bound business entity credential a merchant hosts at /.well-known/baselayer-counterparty-credential so arriving agents can verify the business behind the site. No agent key: the credential binds to the domain, and TLS supplies the possession proof at fetch time.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Body for POST /credentials/counterparty: mint the domain-bound
business entity credential a merchant hosts for counterparty
verification (ENG-6598).

No agent key and no disclosure selection: the credential binds to the
merchant's domain rather than a presenting key, and every claim is
public-record fact, always disclosed.

business_ref

string

required

length between 1 and 255

Pairwise reference to the verified business the counterparty credential attests, as issued to the calling organization.

domain

string

required

length between 1 and 512

The domain the credential binds to — must match the business's verified website domain. A full URL is reduced to its hostname.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/vnd.baselayer.v1+json

201Response

404The business_ref is unknown or was issued to another organization — the two are indistinguishable.

409The domain does not match the business's verified website domain, the registration is not active and undissolved, or registry truth has lapsed.

422The mint payload failed validation, or the domain cannot be reduced to a canonical form.