Numista Coin & Banknote Catalog API Wrapper

Extract coin, banknote, and exonumia catalog data from the Numista REST API v3 — 600k+ catalogued types, KM (Krause-Mishler) and other cross-reference numbers, physical specs, per-year/mintmark issue and mintage data, and obverse/reverse images.

What you get

• Type records — title, issuer/country, category (coin / banknote / exonumia), sub-classification (e.g. "Standard circulation coins"), min/max year, ruler, physical specs (weight, size, thickness, shape, orientation, composition), face value and currency
• Descriptions — obverse, reverse, and edge design descriptions
• Catalog cross-references — KM number plus the full set of other catalogue numbers (Schön, Wikidata, etc.)
• Issue-level data (optional) — one row per year/mintmark issue with mintage figures, when includeIssues is enabled
• Images — obverse and reverse full-resolution image URLs

Modes

Mode	Description
catalog_walk	Paginated walk of the catalog filtered by issuer / category / year range (default)
type_ids	Fetch specific Numista type IDs with full detail
search	Free-text catalog search

catalog_walk and search results are list items; this actor automatically enriches each one with a full-detail follow-up request before emitting a row, so all three modes produce the same rich schema.

Input

Field	Type	Description
mode	string	catalog_walk, type_ids, or search. Default: catalog_walk
issuer	string	Numista issuer slug (e.g. united-states, united-kingdom, france, japon) — not an ISO country code. Look up the exact slug via GET https://api.numista.com/v3/issuers or the catalogue URL on en.numista.com. Used in catalog_walk mode
category	string	coin, banknote, or exonumia. Leave blank for all categories
minYear / maxYear	integer	Year range filter for catalog_walk
typeIds	array	Numista numeric type IDs to fetch (e.g. ["1492"] — the Morgan Dollar). Used in type_ids mode
query	string	Free-text search query. Used in search mode
includeIssues	boolean	Fetch per-year/mintmark issue + mintage data for each type. Doubles API calls but adds mintage detail. Default: true
language	string	Catalog description language. Default: en
maxItems	integer	Maximum number of catalog types to walk. When includeIssues is enabled, each type can fan out into many issue rows, so total output rows may exceed maxItems

Rate limits

Numista issues a per-key request quota (2,000+/day on the free tier) and a per-second rate limit. This actor respects Retry-After on HTTP 429 automatically and runs at a conservative default pace.

Use cases

• Numismatic price guides — join on KM number / catalogue cross-references against price-guide data (e.g. NGC population reports) for a full catalog + pricing stack
• Collection cataloguing — pull full physical specs and images for a personal or dealer collection
• Mintage research — per-year/mintmark mintage figures for rarity analysis
• World coin reference — the largest open catalog of foreign/world coins, complementing US-centric price guides