KYC verifier API
Who this is for: developers integrating on-chain KYC verification. This is the endpoint table only: for the integration walkthrough see /build/identity/on-chain-kyc-integration, which transcludes this page.
Endpoints
Quoted from docs.lumia.org, fetched 2026-09-09:
POST
https://verifier-backend.privado.id/sign-in
Starts a verification session; returns a QR code for wallet scanning
GET
https://verifier-backend.privado.id/status?sessionID={sessionID}
Polls the status of a verification session
Request shape: POST /sign-in
chainID
Network the verification is scoped to. docs.lumia.org's own example uses "1952959480", the retired "Lumia Testnet" (see /reference/retired-testnet), alongside "994873017" (mainnet). Use the confirmed values from /reference/networks: mainnet 994873017, Beam testnet 2030232745. Do not copy the 1952959480 example as-is.
scope
Array of query objects, each with circuitId, id, and query
query
Includes allowedIssuers, context, type, credentialSubject
skipClaimRevocationCheck
Boolean; false recommended
Response shape
POST /sign-in response:
qrCode
QR code data for wallet scanning
sessionID
Session identifier used to poll /status
GET /status response:
status
One of: success, approved, failed, or a pending state (exact enumeration of pending states [UNVERIFIED])
Error codes
[UNVERIFIED]: docs.lumia.org does not document explicit error codes or an error response structure for this API as of 2026-09-09. {{TODO: confirm with the identity/KYC integration owner: error code table, if one exists}}
Source / last verified
WebFetch of docs.lumia.org/build/on-chain-kyc, 2026-09-09.
Was this helpful?