BAbamboohr
Account Information
Public API

Get Currency Conversion Rates

Changed on

Returns the latest currency conversion rate snapshot for a single base currency. The response is a single JSON object whose rates field is a map of ISO 4217 currency codes to conversion rates relative to the base currency; the base currency itself maps to 1. The rate-map keys match the code values from Get All Currency Types (get-all-currency-types). A well-formed base currency code that has no stored snapshot returns 404 rather than an empty object.

OAuth Scopes: meta

get/api/v1/meta/currency-conversions

Request

Query parameters

baseCurrencystring

ISO 4217 alphabetic base currency code (for example USD or EUR). Case-insensitive; values are normalized to uppercase. Defaults to USD when omitted. A well-formed code with no stored rate snapshot returns 404.

Response

Currency conversion rate snapshot retrieved successfully. Returns a single JSON object.

baseCurrencystring

ISO 4217 base currency code the rates are relative to

lastUpdatedstring date-time

ISO 8601 UTC timestamp of the last rate update

nextUpdatestring date-time

ISO 8601 UTC timestamp of the next scheduled rate update

ratesobject

Map of ISO 4217 currency codes to conversion rates relative to the base currency, returned as JSON numbers. The base currency maps to 1.

Example response

{
  "baseCurrency": "USD",
  "lastUpdated": "2026-04-07T12:00:00Z",
  "nextUpdate": "2026-04-08T12:00:00Z"
}

Changes