Bamboo Card
Open in PostmanGo to Client Portal
HomeAPI ReferenceExchange RatesExchange rates
GET

Exchange rates

Retrieve Bamboo exchange rates used for cross-currency pricing and account settlement.

GET/api/integration/v1.0/exchange-rates

Exchange Rates returns the currency conversion data Bamboo uses when a product denomination currency differs from the charged account currency.

Exchange rates are updated internally every hour and are powered by OpenExchange API.

This endpoint requires Basic Auth using your API credentials.

Query parameters

Both query parameters are optional. The returned data changes depending on which values you send.

ParameterTypeRequiredDescriptionExample
baseCurrencystringNoBase currency used to calculate the response rates.AED
currencystringNoTarget currency to return when a single pair is required.INR

Response specifications

Bamboo always returns the base currency plus the matching rate entries.

FieldTypeDescription
baseCurrencyCodestringBase currency used for the returned rates.
ratesarrayExchange-rate entries for the requested base.
currencyCodestringTarget currency code.
valuenumberExchange rate value for the base-to-target pair.

Examples

Full request and response examples for this endpoint.

Example request

Use this full request as the primary reference for client-side implementation.

cURL - cURL
# Generate token: echo -n 'YOUR_CLIENT_ID:YOUR_CLIENT_SECRET' | base64

curl --location 'https://api.bamboocardportal.com/api/integration/v1.0/exchange-rates?baseCurrency=AED&currency=INR' \
  --header 'Authorization: Basic YOUR_BASE64_TOKEN' \
  --header 'Accept: application/json'

Example response

Use this sample payload to validate parsing, field mapping, and downstream handling.

200 OK
JSON
{
  "baseCurrencyCode": "AED",
  "rates": [
    {
      "currencyCode": "INR",
      "value": 22.718078
    }
  ]
}

Behavior by query combination

Exchange Rates changes behavior depending on which parameters you send.

1

No query parameters

When you send no query parameters, Bamboo returns all exchange rates based on USD.

2

baseCurrency only

When you send baseCurrency, Bamboo returns all rates based on the specified base currency.

3

baseCurrency + currency

When you send both baseCurrency and currency, Bamboo returns the exchange rate between the base and target currency.

Operational notes

Use exchange-rate results when you need to explain or estimate cross-currency pricing.

Hourly refresh

Bamboo updates exchange rates internally every hour.

Cross-currency orders

These rates are applied when the product currency and charged account currency differ.

Request precision

Specify both baseCurrency and currency when you need one exact pair for a pricing explanation.

JSON response

The response returns the base currency plus one or more rates entries.

PreviousTransactionsNextNotification

On this page

Try it out

Open the interactive API panel to test this endpoint with your own credentials.