Skip to main content
GET
curl

Path Parameters

token
string
required

Opaque session token returned when the widget session was minted.

Response

The widget context and proof statuses.

vasp_name
string

Legal name from your VASP profile, shown to the customer in the widget. Empty when no profile exists.

wallet_address
string
chain
string

The chain the session was minted with, as you sent it.

chain_family
enum<string> | null

The key family behind chain: EVM (Ethereum, BNB Chain, Polygon, Arbitrum, Base, Optimism, Avalanche, Linea and the other EVM chains), BTC, SOL or TRON. One EVM key controls the same address on every EVM chain. Null when no signature can be verified on the chain.

Available options:
EVM,
BTC,
SOL,
TRON,
null
holder_name
string
allowed_methods
enum<string>[]

Proof methods available for this session. MESSAGE_SIGNING requires a chain with a chain_family, SATOSHI_TEST requires a satoshi_deposit_address on the session and a chain whose deposits Didit can read back, SCREENSHOT requires the allow_screenshot_proof setting, and SELF_DECLARATION requires the allow_self_declaration setting.

Available options:
MESSAGE_SIGNING,
SCREENSHOT,
SATOSHI_TEST,
SELF_DECLARATION
transfer_status
string | null

Status of the linked Travel Rule transfer. Null when the session was minted without a transaction_id.

callback_url
string

Where the widget returns the customer after completion. Empty when not set.

expires_at
string<date-time>
completed_at
string<date-time> | null

Non-null once a proof has been verified.

proofs
object[]
max_attempts
integer

Rejected wallet proofs this session allows.

attempts_used
integer

Rejected proofs so far.

attempts_remaining
integer

When 0, starting another proof answers 409 and you mint a new widget session.

customization
object | null

The application's whitelabel customization (colors, logo, font family) when white label is enabled - the widget renders with the same branding as the verification flow. Null otherwise.

Last modified on November 1, 2026