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

Request Fields

Parameter	Type	Description	Example	Required
`accountNumber`	string	The account number from which the currency conversion is requested.	"1450160649886"	Yes
`countryCode`	string	The ISO Alpha-2 country code of the account's location.	"KE"	Yes
`currencyCode`	string	The 3-letter code of the currency to be converted (e.g., GBP, EUR, USD).	"GBP"	Yes
`amount`	double	The amount in the original currency to be converted.	344	Yes
`toCurrency`	string	The target currency to which the amount will be converted (e.g., USD, EUR).	"USD"	Yes

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