Skip to main content
POST
Verify KYC

Overview

Initiates identity verification (BVN check) for a customer who has been enrolled for lending. The result is asynchronous — poll GET /v1/loans/customers/:customerId/kyc-status until kyc_status becomes VERIFIED. This call is idempotent for already-verified customers and returns immediately with 200.

Request

Method: POST
URL: /v1/loans/customers/:customerId/verify-kyc

Parameters

No request body required.

Response

200 — Verification Initiated

200 — Already Verified

Error Responses

Authorizations

apikey
string
header
required

Provide your API key in the 'apikey' header.

Headers

x-carbon-key
string
required

Path Parameters

customerId
string
required

Response

200 - application/json

Successful response

The response is of type object.