---
title: "List server-owned ISO 4217 currency and capability authority"
method: GET
path: "/reference-data/currencies"
tags: ["Reference Data"]
---

# List server-owned ISO 4217 currency and capability authority

`GET /reference-data/currencies`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/reference-data/currencies`
- Auth: HTTP bearer

## Response `200`

Current and historical currency reference with explicit vertical capabilities

- CurrencyReferenceResponse
  - `success` boolean, required
  - `data` CurrencyReferenceData, required
    - `publication` object, required
      - `current` string, date, required
      - `historical` string, date, required
    - `currencies` CurrencyReference[], required
      - `code` string, required
      - `current` CurrencyReferenceCurrent, required
        - `code` string, required
        - `numericCode` string, required
        - `name` string, required
        - `minorUnit` integer, nullable, required
        - `kind` 'currency' | 'fund' | 'precious_metal' | 'testing' | 'no_currency', required
        - `entities` string[], required
      - `historical` CurrencyReferenceHistorical[], required
        - `code` string, required
        - `numericCode` string, nullable, required
        - `name` string, required
        - `entity` string, required
        - `withdrawalDate` string, nullable, required: Raw SIX withdrawal date or published date range.
        - `isFund` boolean, required
      - `capabilities` CurrencyCapabilities, required
        - `provisioning` boolean, required
        - `ledger` boolean, required
        - `presentation` boolean, required
        - `arAp` boolean, required
        - `forecast` boolean, required
        - `providerIngress` boolean, required
        - `legacyCents` boolean, required

## Other responses

- `401`: Missing or invalid auth token

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)