POST
/
external
/
loan-offer
curl --request POST \
  --url https://direct-pub-api.directgh.com/api/v1/external/loan-offer \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 50000,
  "tenure": 6,
  "narration": "Business expansion loan",
  "userId": "550e8400-e29b-41d4-a716-446655440000"
}
'
{
  "amount": 50000,
  "tenure": 6,
  "interest": 15000,
  "processingFee": 2500,
  "monthlyInstallment": 10833.33,
  "totalRepayment": 65000
}

Authorizations

​
Authorization
string
header
required

HMAC signature authentication. The Authorization header must contain your public key and HMAC signature in the format: public_key:signature

Format: Authorization: public_key:signature

Example: Authorization: pub_abc123xyz:abc123def456ghi789...

The signature is generated by creating an HMAC hash of the request body (JSON stringified) using your secret key. Contact your account manager to obtain your public key and secret key for generating signatures.

Body

application/json
​
amount
number
required

Loan amount requested (must be a positive number)

Required range: x >= 0.01
Example:

50000

​
tenure
integer
required

Loan tenure in months (must be a positive integer)

Required range: x >= 1
Example:

6

​
narration
string
required

Description or purpose of the loan

Example:

"Business expansion loan"

​
userId
string<uuid>
required

Unique identifier of the institution member requesting the loan

Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

Loan offer calculated successfully

Loan offer details including interest, fees, and repayment terms

​
amount
number

Loan amount offered

Example:

50000

​
tenure
integer

Loan tenure in months

Example:

6

​
interest
number

Total interest amount for the loan

Example:

15000

​
processingFee
number

Processing fee charged for the loan

Example:

2500

​
monthlyInstallment
number

Monthly repayment amount

Example:

10833.33

​
totalRepayment
number

Total amount to be repaid (principal + interest + fees)

Example:

65000