---
title: "Get currency conversion rates"
method: GET
path: "/api/v1/meta/currency-conversions"
tags: ["Public API"]
---

# Get currency conversion rates

`GET /api/v1/meta/currency-conversions`

Returns a snapshot of currency conversion rates for the specified base currency, keyed by ISO 4217 currency code. Rate map keys match the `code` field from GET /api/v1/meta/currency/types. Timestamps are ISO 8601 UTC with a Z offset.

OAuth Scopes: meta

## Query parameters

- `baseCurrency` string

## Response `200`

Currency conversion rates retrieved successfully

- object
  - `baseCurrency` string — ISO 4217 base currency code
  - `lastUpdated` string, date-time — ISO 8601 UTC timestamp of the last rate update
  - `nextUpdate` string, date-time — ISO 8601 UTC timestamp of the next scheduled rate update
  - `rates` object — Map of ISO 4217 currency codes to numeric conversion rates relative to the base currency

## Other responses

- `400` — Invalid parameter type for baseCurrency
- `401` — Unauthorized
- `403` — Forbidden
- `404` — No conversion rate snapshot found for the requested base currency
- `422` — Malformed baseCurrency query parameter
- `503` — Backing store or dependency temporarily unavailable

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)