---
title: "Get a list of currencies"
method: GET
path: "/currencies"
tags: ["Currencies"]
---

# Get a list of currencies

`GET /currencies`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/currencies`
- Auth: none declared

Returns all currencies supported by Kantata OX, unless filter parameters have been applied.

## Query parameters

- `addable_to_rate_card_set_version` integer
- `matching` string

## Response `200`

A list of Currencies have been retrieved.

- object
  - `iso_code` string: ISO alphabetic code (for example, `USD`).
  - `name` string: Name of currency (for example, `United States Dollar`).
  - `symbol` string: Symbol associated with currency (for example, `$`).
  - `subunit_to_unit` integer: Number of subunits in one unit for currency.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)