Skip to main content
GET
Get account KYC
Returns the latest identity verification state and recent verification history for the UPA. Provider decision payloads and identity documents are never returned.

Authorizations

Authorization
string
header
required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Stableyard-Version
enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:
2026-09-09

Path Parameters

accountId
string
required

Canonical account id returned by the Accounts API.

Example:

"acct_123"

Response

Account KYC state

accountId
string
required
Pattern: ^acct_[A-Za-z0-9_-]+$
Example:

"acct_123"

verifications
object[]
required
Maximum array length: 10
current
object