ISIN Mapper API beta Endpoints

Resolve Endpoint

resolve ISIN, with all current listings (JSON): https://mapper.sparcero.com/api/beta/isin/AT0000A325L0?api_key=spk_xxxxx

resolve ISIN, chosen FIGI only (JSON): https://mapper.sparcero.com/api/beta/isin/AT0000A325L0?include=none&api_key=spk_xxxxx

resolve ISIN, with raw payload hashes (JSON): https://mapper.sparcero.com/api/beta/isin/AT0000A325L0?include=provenance&api_key=spk_xxxxx

Batch Resolve Endpoint

resolve up to 200 ISINs, chosen FIGI only (JSON): https://mapper.sparcero.com/api/beta/isin?isins=AT0000A325L0,BE0974271034,BE0974303357&api_key=spk_xxxxx

resolve up to 200 ISINs, with all listings (JSON): https://mapper.sparcero.com/api/beta/isin?isins=AT0000A325L0,BE0974271034&include=listings&api_key=spk_xxxxx

History Endpoint

every listing version, open and closed (JSON): https://mapper.sparcero.com/api/beta/isin/AT0000A325L0/history?api_key=spk_xxxxx

FIGI Endpoint

reverse lookup FIGI to ISIN (JSON): https://mapper.sparcero.com/api/beta/figi/BBG01G09QQC4?api_key=spk_xxxxx

Ticker Endpoint

all listings carrying a ticker (JSON): https://mapper.sparcero.com/api/beta/ticker/ACQ0?api_key=spk_xxxxx

listings for a ticker on one exchange (JSON): https://mapper.sparcero.com/api/beta/ticker/ACQ0?exchange=GR&api_key=spk_xxxxx

Tickers are not unique across venues or issuers. Check the ambiguous flag before treating the first row as an answer.

Search Endpoint

search by name prefix (JSON): https://mapper.sparcero.com/api/beta/search?name=AUSTRIACARD&api_key=spk_xxxxx

search anywhere in the name, slower (JSON): https://mapper.sparcero.com/api/beta/search?name=HOLDINGS&mode=contains&api_key=spk_xxxxx

Status Endpoint

coverage and freshness of the mapping (JSON): https://mapper.sparcero.com/api/beta/status?api_key=spk_xxxxx

liveness, no key needed: https://mapper.sparcero.com/healthz

Bulk Export Endpoint

manifest with record counts, sizes and SHA-256 checksums (JSON): https://mapper.sparcero.com/api/beta/export?api_key=spk_xxxxx

full mapping, one line per ISIN (JSONL): https://mapper.sparcero.com/export/latest/isin.jsonl.gz

full mapping, one line per listing (JSONL): https://mapper.sparcero.com/export/latest/figi.jsonl.gz

full mapping, flat (CSV): https://mapper.sparcero.com/export/latest/isin_figi.csv.gz

every version row ever recorded (JSONL): https://mapper.sparcero.com/export/latest/figi_history.jsonl.gz

Published nightly. Prefer these over walking the API. The dated tar.gz holding all of the above uncompressed, plus SHA256SUMS, is named in the manifest.

Notes

ISINs are validated including the check digit: a mistyped one returns 400 invalid_isin, not 404.

exch_code is the Bloomberg exchange code (GR, EO, LN), not an ISO 10383 MIC.