PUT
/
v1
/
kyc
/
:userId
curl -X PUT https://api.geldstuck.com/v1/kyc/usr_01HX3ZAB... \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currentStep": 20}'

{
  "id": "kyc_01HX3ZH...",
  "userId": "usr_01HX3ZAB...",
  "status": "in_progress",
  "currentStep": 20,
  "updatedAt": "2026-04-22T10:30:00.000Z"
}
Use this to patch clientInformation, advance currentStep, or update metadata. To start a user-facing verification session, create a session token with POST /kyc/onfido.

​
Path parameters

​
userId
string
required

​
Body

​
clientInformation
object
​
currentStep
integer
​
metadata
object

​
Returns

The updated KYC record. 
curl -X PUT https://api.geldstuck.com/v1/kyc/usr_01HX3ZAB... \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currentStep": 20}'

{
  "id": "kyc_01HX3ZH...",
  "userId": "usr_01HX3ZAB...",
  "status": "in_progress",
  "currentStep": 20,
  "updatedAt": "2026-04-22T10:30:00.000Z"
}