Get Forex Rates

Test URL

POSThttps://uat.finserve.africa/v3-apis/transaction-api/v3.0/foreignexchangerates

Live URL

POSThttps://api.finserve.africa/v3-apis/transaction-api/v3.0/foreignexchangerates

The Foreign Exchange Rates API Provides Easy Access To The Equity Bank Daily Currency Conversion Rate For Major Currencies

200 Success Response Schema

Field Name	Field Type	Field Descriptions
`data`	`object`	list of conversion rates for major currencies
`convertedAmount`	`double`	Converted amount
`rate`	`double`	Conversion rate
`fromAmount`	`double`	Original amount
`rateCode`	`string`

Example Request

⚠️

In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.

Signature Formula

countryCode+currencyCode+amount+toCurrency

Example Request

curl -X POST \
	-d '{
            "accountNumber": "1450160649886",
            "countryCode": "KE",
            "currencyCode": "GBP",
            "amount": 344,
            "toCurrency": "USD"
        }'  \
	-H 'Authorization: Bearer {{token}}'  \
	-H 'Content-Type: application/json'  \
	-L 'https://uat.finserve.africa/v3-apis/transaction-api/v3.0/foreignexchangerates'

Example Response

{
    "status": true,
    "code": 0,
    "message": "success",
    "data": {
        "convertedAmount": 425.184,
        "rate": 1.236,
        "fromAmount": 344,
        "rateCode": "TTB"
    }
}

Purchase Airtime ID Search & Validation