Get Utility exchange rate

Retrieves the current exchange rate for a specified operator and currency. The endpoint returns the exchange rate applied by LedgerBlock, along with the currency, operator, and the time the rate was last updated.

Request

Method: GET

Endpoint:

{{base_url}}/api/v1/utility/exchange-rates?operator=Nigeria t2 Mobile&currency=NGN

Query Parameters

Parameter	Type	Required	Description
`operator`	String	Yes	Name of the operator for which the exchange rate is requested.
`currency`	String	Yes	Currency code for the requested exchange rate.

Authentication & Headers

Header	Type	Required	Description
`Authorization`	String	Yes	`Bearer ${api_key}` — your activated merchant API key.
`x-merchant-ref`	String	Yes	Your unique merchant reference.

Request Body

This endpoint does not require a request body.

Response

Success Response

{
  "status": "success",
  "message": "Fetched",
  "data": {
    "data": {
      "currency": "NGN",
      "operator": "Nigeria T2 Mobile",
      "rate": "1340.212500",
      "updatedAt": "2026-08-27T12:00:34.50149Z"
    }
  }
}

Response Fields

Field	Type	Description
`status`	String	Indicates whether the request was successful.
`message`	String	Response message.
`data.data`	Object	Contains the exchange rate information.
`currency`	String	Currency code associated with the exchange rate.
`operator`	String	Name of the operator associated with the exchange rate.
`rate`	String	Current exchange rate for the specified operator and currency.
`updatedAt`	String	Timestamp indicating when the exchange rate was last updated.

Updated 27 days ago

Did this page help you?