---
title: "List currencies"
method: GET
path: "/openmeter/currencies"
tags: ["OpenMeter Billing"]
---

# List currencies

`GET /openmeter/currencies`

List currencies supported by the billing system.

## Query parameters

- `page` object
  - `size` integer — The number of items to include per page.
  - `number` integer — The page number.
- `sort` string — The `asc` suffix is optional as the default sort order is ascending. The `desc` suffix is used to specify a descending order. Multiple sort attributes may be provided via a comma separated list. JSONPath notation may be used to specify a sub-attribute (eg: 'foo.bar desc').
- `filter` ListCurrenciesParamsFilter — Filter options for listing currencies.
  - `type` 'fiat' | 'custom' — Currency type for custom currencies. It should be a unique code but not conflicting with any existing standard currency codes.
  - `code` union — Filters on the given string field value by either exact or fuzzy match. All properties are optional; provide exactly one to specify the comparison.
    - string
    - object
      - `eq` string — Value strictly equals the given string value.
      - `neq` string — Value does not equal the given string value.
      - `contains` string — Value contains the given string value (fuzzy match).
      - `ocontains` string, ArrayEncoding.commaDelimited — Returns entities that fuzzy-match any of the comma-delimited phrases in the filter string.
      - `oeq` string, ArrayEncoding.commaDelimited — Returns entities that exact match any of the comma-delimited phrases in the filter string.
      - `gt` string — Value is greater than the given string value (lexicographic compare).
      - `gte` string — Value is greater than or equal to the given string value (lexicographic compare).
      - `lt` string — Value is less than the given string value (lexicographic compare).
      - `lte` string — Value is less than or equal to the given string value (lexicographic compare).
      - `exists` boolean — When true, the field must be present (non-null); when false, the field must be absent (null).

## Response `200`

Page paginated response.

- CurrencyPagePaginatedResponse — Page paginated response.
  - `data` BillingCurrency[], required
    - union — Fiat or custom currency.
      - object — Currency describes a currency supported by the billing system.
        - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier).
        - `type` 'fiat', required — The type of the currency.
        - `name` string, required — The name of the currency. It should be a human-readable string that represents the name of the currency, such as "US Dollar" or "Euro".
        - `description` string — Description of the currency.
        - `symbol` string — The symbol of the currency. It should be a string that represents the symbol of the currency, such as "$" for US Dollar or "€" for Euro.
        - `code` string, required — Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.
      - object — Describes custom currency.
        - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier).
        - `type` 'custom', required — The type of the currency.
        - `name` string, required — The name of the currency. It should be a human-readable string that represents the name of the currency, such as "US Dollar" or "Euro".
        - `description` string — Description of the currency.
        - `symbol` string — The symbol of the currency. It should be a string that represents the symbol of the currency, such as "$" for US Dollar or "€" for Euro.
        - `code` string, required — Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
        - `created_at` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC.
  - `meta` PaginatedMeta, required — returns the pagination information
    - `page` PageMeta, required — Contains pagination query parameters and the total number of objects returned.
      - `number` number, required
      - `size` number, required
      - `total` number, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-05-14** (v3) `2a50b07fe75c` — 1 warning, 3 info
  - for the `query` request parameter `filter`, the type/format of property `type` was changed from ``/`` to `string`/``
  - added the new optional `query` request parameter `sort`
  - added the enum value `custom` to the property `type` of the `query` request parameter `filter`
  - added the enum value `fiat` to the property `type` of the `query` request parameter `filter`
- **2026-05-11** (v3) `9d0042cb3815` — 2 breaking, 2 warning, 5 info
  - removed the enum value `custom` from the property `type` of the `query` request parameter `filter`
  - removed the enum value `fiat` from the property `type` of the `query` request parameter `filter`
  - for the `query` request parameter `filter`, the type/format of property `type` was changed from `string`/`` to ``/``
  - deleted the `query` request parameter `sort`
  - …5 more

[Change history](https://skmtc.dev/openmeterio/apis/openmeter-api/changes/openmeter/currencies/get.md)

---

[API](https://skmtc.dev/openmeterio/apis/openmeter-api.md) · [All operations](https://skmtc.dev/openmeterio/apis/openmeter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openmeterio/openmeter-api/revisions/3ecbdfd707eb/schema)