1. Home
  2. Interswitch lending Service
  3. Interswitch Lending Service (Channels)
  4. Get Multiple Provider Offers

Get Multiple Provider Offers

This endpoint is to get offers available to a user/customer from all available providers.

Request Message Description

Field#Field nameData typeMax lengthRequiredDescription
trueThe Email or Mobile Number of the Customer for which offers are been requested.
trueThe Code of the Channel from which this request is originating.
falseThe Full name of the Customer.
5amountNumeric String
falseThe Amount of Loan that the customer wishes to take (in Kobo).
falseThe service type code


GET /v2/offers?customerId={customerId}&channelCode={channelCode}&amount={amount}&serviceType={serviceType}


 Authorization: Bearer {{token}}

Sample Request


Response Message  field description

Field#Field nameDescription
1responseCodeThe Code representing the result of the request processing.
2responseMessageThe Description of the responseCode.
4offersArrays of the available offers.
4b.amountOfferedThe Amount which the Credit Company is ready to loan the customer/user.
4c.interestThe Interest Percentage that applies to the loan.
4d.amountPayableThe Compound Interest which is to be paid by the Customer at the end of the loan tenure.
4e.feesArray of the many fees that applied with the offer.
4f.tenureThe Duration for which the loan is applied. After this duration, the loan is marked as due. (in days)
4g.termsThe Terms and Conditions that applied to the offer.
4h.expiryDateThe Date and Time at which this offer becomes invalid.(UTC)
4i.currencyThe Currency Code of the Amount offered.
5providerThe provider for the specified loan

Sample Response (success)

"responseCode": "00",
"offers": [
"offerId": "OFFER1511245980103",
"amountOffered": 3500000,
"interest": 15,
"amountPayable": 3875000,
"tenure": 14,
"expiryDate": "2017-06-30T09:24:09Z",
"currency": "566",
"description": "N35000 to pay N3875000 in 14 days",
"provider": {
"code": "MKT",
"name": "MKT Loans",
"description": "MKT"

Sample Response (failure)

"responseCode": "3001",
"responseMessage": "No offers available",
"offers": []

Was this article helpful to you? Yes No

How can we help?