Skip to main content
POST
Calculate Repayment

Overview

Returns a projected repayment schedule for a given loan amount, tenure, and state. Can be called at any point — no active application is required. Useful for showing customers a preview before they apply. All amounts are in kobo.

Request

Method: POST
URL: /v1/loans/calculate-repayment

Parameters

Request Body

Response

200 OK

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.

loan_amount
number
required
Example:

2000000

tenure
number
required
Example:

3

state
string
required
Example:

"LAGOS STATE"

Response

200 - application/json

Successful response

The response is of type object.