Get the tenant's settlement configuration

GET

/v1/settlement/config

curl --request GET \
  --url https://example.com/v1/settlement/config \
  --header 'Authorization: Bearer <token>'

• The gateway serves this contract at its own root; no fixed host is baked in (self-hostable).

Authorizations

• oidcBearer

Responses

200

The tenant’s settlement configuration.

Media typeapplication/json

object

facilitator_url

required

string format: uri

facilitator_credential_ref

required

string

created_at

required

string format: date-time

updated_at

required

string format: date-time

Example^generated

{
  "facilitator_url": "https://example.com",
  "facilitator_credential_ref": "example",
  "created_at": "2026-04-15T12:00:00Z",
  "updated_at": "2026-04-15T12:00:00Z"
}

401

Missing or invalid bearer token, or the token’s tenant/user claims are absent. No body.

404

The tenant has not configured settlement.

Media typeapplication/json

The uniform error body for all 4xx responses that carry one.

object

error

required

A coarse, caller-safe message. Never contains internal state (invariant

string

Example^generated

{
  "error": "example"
}

500

An unexpected server-side error. No body (internal detail is never returned to callers, invariant