---
title: "List World Currency Codes records"
method: GET
path: "/v1/data/world-currency-codes"
tags: ["Currency Codes"]
---

# List World Currency Codes records

`GET /v1/data/world-currency-codes`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/world-currency-codes`
- Auth: none declared. Required headers: `X-API-Key`

List World Currency Codes records with optional filters and pagination.

**Source:** Currency code data from the Frictionless Data core datasets (github.com/datasets/currency-codes), derived from the ISO 4217 maintenance agency list. (ODC PDDL 1.0).

**Fields returned:**
- `entity` (str) — Country or territory that uses the currency
- `currency` (str) — Currency name
- `alphabetic_code` (str) — Three-letter currency code, e.g. AUD
- `numeric_code` (str) — Three-digit numeric currency code
- `minor_unit` (str) — Number of decimal places used for the currency
- `withdrawal_date` (str) — Date the currency was withdrawn, if retired

**Example:** `GET /v1/data/world-currency-codes?limit=10&entity=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `entity` string, nullable: Country or territory that uses the currency
- `alphabetic_code` string, nullable: Three-letter currency code, e.g. AUD
- `numeric_code` string, nullable: Three-digit numeric currency code

## Headers

- `X-API-Key` string, required

## Response `200`

A page of World Currency Codes records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)