v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-03101355448.4 KB
OpenMeter Currencies

List cost bases

List cost bases for a currency. For custom currencies, there can be multiple cost bases with different effective_from dates.

get/openmeter/currencies/custom/{currencyId}/cost-bases

Path parameters

currencyIdstring required

ULID (Universally Unique Lexicographically Sortable Identifier).

Example:01G65Z755AFWAKHE12NY0CQ9FH

Query parameters

fiat_codestring

Three-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.

Filter cost bases returned in the response.

To filter cost bases by fiat currency code add the following query param: filter[fiat_code]=USD

{
  "fiat_code": "USD"
}
sizeinteger

The number of items to include per page.

numberinteger

The page number.

Determines which page of the collection to retrieve.

Response

Page paginated response.

Example response

{
  "data": [
    {
      "id": "01G65Z755AFWAKHE12NY0CQ9FH",
      "fiat_code": "USD",
      "effective_from": "2023-01-01T01:01:01.001Z",
      "effective_to": "2023-01-01T01:01:01.001Z",
      "created_at": "2023-01-01T01:01:01.001Z"
    }
  ],
  "meta": {
    "page": {
      "number": 1,
      "size": 10,
      "total": 100
    }
  }
}