REST APIs

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:

Method	Path	Purpose
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

Field	Description
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:

Field	Description
qrCode	QR code data for wallet scanning
sessionID	Session identifier used to poll /status

GET /status response:

Field	Description
status	One of: success, approved, failed, or a pending state