Skip to main content
POST
curl

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is missing, wrong, revoked or expired; 403 means the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Path Parameters

proof_uuid
string<uuid>
required

proof_id from the review queue.

Body

application/json
decision
enum<string>
required
Available options:
approve,
reject
note
string

Optional. Kept with the proof and returned as review_note.

Maximum string length: 512

Response

The decided proof.

proof_id
string<uuid>
method
enum<string>
Available options:
SCREENSHOT
status
enum<string>
Available options:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

Canonical chain identifier, e.g. ETH, BTC, SOL, TRX.

holder_name
string
is_ownership_verified
boolean

Whether the address book entry is ownership-verified, by this proof or another one.

transaction_id
string<uuid> | null

The transaction whose Travel Rule transfer the widget session was minted for. Null for a session minted without a transaction_id.

file_name
string | null
content_type
string | null
screenshot_url
string | null

Time-limited link to the uploaded screenshot. List the queue again for a fresh link.

attempts
integer

How many files the end user uploaded for this proof.

failure_reason
enum<string>

REVIEW_REJECTED after a rejection, OWNERSHIP_CHANGED when the wallet changed holder or was deleted before a decision. Empty otherwise.

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
method_chosen_at
string<date-time> | null

When the end user picked the screenshot method.

decided_at
string<date-time> | null
decided_by
string

Who closed the proof: review: for a console reviewer, review for an API-key decision, widget or sweeper when Didit closed it automatically. Empty while PENDING.

review_note
string

The note sent with the decision. Empty when none.

created_at
string<date-time>