Skip to main content
POST
Apply for Loan

Overview

Submits a loan application for a customer whose kyc_status is VERIFIED. The reference field is a merchant-controlled idempotency key — submitting the same reference again returns the existing application with 200 OK instead of creating a duplicate. All amounts are in kobo (1 NGN = 100 kobo).

Request

Method: POST
URL: /v1/loans/apply

Parameters

Request Body

loan_purpose values:

Response

201 — Application Created

200 — Duplicate Reference (Idempotent)

Error Responses

Authorizations

apikey
string
header
required

Provide your API key in the 'apikey' header.

Headers

x-carbon-key
string
required

Body

application/json

Provide the required values for the request body.

customer_id
string
required
Example:

"1732ca47-42b2-4990-a65d-c369e934eed3"

amount
number
required

Loan amount in kobo

Example:

2000000

repayment_period
number
required

Tenure in months (1–6)

Example:

3

loan_purpose
string
required
Example:

"INVENTORY_MGT"

reference
string
required

Merchant idempotency key

Example:

"MERCH_REF_001"

Response

200 - application/json

Successful response

The response is of type object.