GET
/
v1
/
kyc
/
:userId
/
reuse-eligibility
curl https://api.geldstuck.com/v1/kyc/usr_01HX3ZAB.../reuse-eligibility \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY"

{
  "eligible": true,
  "expiresAt": "2027-04-22T10:34:00.000Z"
}
If a user has completed KYC recently, many tenants allow reusing that verification for subsequent transactions. This endpoint returns whether the existing record is still valid.

​
Path parameters

​
userId
string
required

​
Query parameters

​
transactionId
string
Optional. If provided, we check eligibility in the context of the specific transaction (e.g., amount-based policies).

​
Returns

​
eligible
boolean
​
expiresAt
string
When the existing verification expires.
​
reason
string
Populated when eligible is false. One of expired, failed, status_not_complete, policy_requires_refresh.
curl https://api.geldstuck.com/v1/kyc/usr_01HX3ZAB.../reuse-eligibility \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY"

{
  "eligible": true,
  "expiresAt": "2027-04-22T10:34:00.000Z"
}