POST
/
v1
/
kyc
/
onfido
curl https://api.geldstuck.com/v1/kyc/onfido \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "usr_01HX3ZAB...",
    "firstName": "Ada",
    "lastName": "Lovelace",
    "dob": "1815-12-10"
  }'

{
  "applicantId": "appl_01HX3ZH...",
  "workflowRunId": "wf_01HX3ZI...",
  "sdkToken": "eyJhbGciOi...",
  "expiresIn": 3600
}
Creates or reuses a verification session for the user and returns the token you hand to the client integration. See the KYC guide for the end-to-end flow.

​
Body

​
userId
string
required
​
firstName
string
required
​
lastName
string
required
​
dob
string
required
ISO date, YYYY-MM-DD.
​
country
string
ISO 3166-1 alpha-3 country code.

​
Returns

​
applicantId
string
Opaque applicant reference for this verification session.
​
workflowRunId
string
Opaque session ID. Pass it to the client verification flow.
​
sdkToken
string
JWT. Valid for 1 hour.
​
expiresIn
integer
Seconds until sdkToken expires.
curl https://api.geldstuck.com/v1/kyc/onfido \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "usr_01HX3ZAB...",
    "firstName": "Ada",
    "lastName": "Lovelace",
    "dob": "1815-12-10"
  }'

{
  "applicantId": "appl_01HX3ZH...",
  "workflowRunId": "wf_01HX3ZI...",
  "sdkToken": "eyJhbGciOi...",
  "expiresIn": 3600
}