Simulate KYB status

Sets a test account’s KYB status outside production so you can exercise onboarding-gated workflows in staging.

POST /simulate/kyb/status

Simulate KYB status

cURL

curl --request POST \
  --url https://api.stabyl.com/v1/simulate/kyb/status \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

200

{
  "data": {
    "decision": "approved",
    "status": "approved",
    "user_id": "0197f1f0-0000-7000-8000-000000000006"
  },
  "status": "success"
}

Simulation endpoints are available only outside production. Use them to test integration behavior without moving real funds.

Body

application/json

Non-production KYB state to apply to a test account.

Non-production KYB state change for a test account.

status · enum<string> · required

KYB status value to apply in a non-production simulation.

Available options: approved, rejected, pending

user_id · string<uuid> · required

Response

200

application/json

Simulated KYB status updated

data · object · required

Result returned after applying a non-production KYB state.

Show child attributes

status · enum<string> · required

Available options: success