---
title: "Simulate KYC approval (sandbox only)"
method: POST
path: "/customers/{customerID}/simulate_kyc_approval"
tags: ["Sandbox"]
---

# Simulate KYC approval (sandbox only)

`POST /customers/{customerID}/simulate_kyc_approval`

Simulates a KYC/KYB approval for a customer in the sandbox environment. This endpoint is not available in production.

Mimics what happens when a customer completes identity verification through the KYC provider in production:
- Sets the customer's KYC status to `approved`
- Populates required entity data (name, address, date of birth) using any data already on the customer, falling back to sandbox defaults
- Approves any pending endorsements, enabling the customer to initiate transfers

Useful for testing the full customer lifecycle without integrating with a real KYC provider.

## Headers

- `Idempotency-Key` string, required

## Response `200`

KYC approval simulated successfully

- SimulateKycApprovalResponse — Response from the simulate KYC approval endpoint
  - `success` boolean, required — Whether the simulation succeeded
  - `customer_id` string, required — The ID of the customer whose KYC was simulated
  - `kyc_status` 'not_started' | 'incomplete' | 'awaiting_questionnaire' | 'awaiting_ubo' | 'under_review' | 'approved' | 'rejected' | 'paused' | 'offboarded', required — Status of the KYC flow.
  - `message` string, required — Human-readable description of what was processed

## Other responses

- `401` — Missing or invalid API key
- `404` — No resource found
- `500` — Unexpected error. User may try and send the request again.

---

[API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/revisions/570998bde3b5/schema)