Skip to main content
POST
curl

Path Parameters

token
string
required

Opaque session token returned when the widget session was minted.

proof_id
string<uuid>
required

proof_id returned when the proof was started.

Body

signature
string

MESSAGE_SIGNING: the wallet's signature over the proof's challenge.

txid
string

SATOSHI_TEST: the transaction id of the test deposit.

Response

VERIFIED, or still PENDING (a screenshot awaiting review, a deposit not indexed or not confirmed yet, with code DEPOSIT_NOT_FOUND or DEPOSIT_UNCONFIRMED).

proof_id
string<uuid>
method
enum<string>
Available options:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>
Available options:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
is_ownership_verified
boolean

Present when the proof is VERIFIED: the address book entry is now ownership-verified.

transfer_status
string | null

Present when the proof is VERIFIED: the linked transfer's status, null without one.

detail
string

Present while the proof stays PENDING: a submitted screenshot awaiting review, or a test deposit that is not confirmed yet.

code
enum<string>

Present on a pending test deposit: why it is not confirmed yet.

Available options:
,
SIGNATURE_INVALID,
SIGNATURE_UNSUPPORTED_SCHEME,
DEPOSIT_NOT_FOUND,
DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED,
DEPOSIT_MISMATCH,
DEPOSIT_STALE,
TXID_REUSED,
CHAIN_UNSUPPORTED,
WINDOW_EXPIRED,
OWNERSHIP_CHANGED,
METHOD_SWITCHED,
REVIEW_REJECTED,
ABANDONED