Initiate a customer verification

POST

customers

{customerId}

verifications

curl --request POST \
  --url https://api.conduit.financial/v2/customers/{customerId}/verifications \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "WALLET_SIGNER_ACTIVATION",
  "referenceId": "txn-abc-123"
}
'

{
  "verificationId": "vrf_2xKjF9mQb7vN4hL1pR3w8t",
  "verificationUrl": "https://verify.conduit.financial/vrf_2xKjF9mQb7vN4hL1pR3w8t"
}

Authorizations

x-api-key

string

header

required

Path Parameters

customerId

string

required

Body

application/json

type

enum<string>

required

Type of verification to initiate

Available options:

WALLET_CUSTODY_CONVERSION,

WALLET_SIGNER_ACTIVATION,

TRANSACTION_APPROVAL,

QUORUM_CONFIG_CHANGE

Example:

"WALLET_SIGNER_ACTIVATION"

referenceId

string

required

Client-provided reference ID to correlate the verification with your system

Required string length: 1 - 60

Example:

"txn-abc-123"

Response

verificationId

string

required

Unique identifier for the initiated verification

Pattern: ^vrf_[0-9A-Za-z]{22}$

Example:

"vrf_2xKjF9mQb7vN4hL1pR3w8t"

verificationUrl

string

required

URL to redirect the user to for completing the verification

Example:

"https://verify.conduit.financial/vrf_2xKjF9mQb7vN4hL1pR3w8t"

Submit sender (originator) information for a deposit parked on UNREGISTERED_ADDRESSTwo paths: register=false records sender data for this deposit only; register=true also creates a durable RegisteredAddress (at end-of-flow on Sardine APPROVE) that resolves any future deposits from the same address. First-snapshot wins — once recorded, a second submission returns 409. Returns 202 with the transaction in its post-signal state; poll GET /v2/transactions/:id for downstream updates.

⌘I

Initiate a customer verification

curl --request POST \
  --url https://api.conduit.financial/v2/customers/{customerId}/verifications \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "WALLET_SIGNER_ACTIVATION",
  "referenceId": "txn-abc-123"
}
'

{
  "verificationId": "vrf_2xKjF9mQb7vN4hL1pR3w8t",
  "verificationUrl": "https://verify.conduit.financial/vrf_2xKjF9mQb7vN4hL1pR3w8t"
}