ISIN History

API TraderAPI QuantAPI Developer

See every ISIN a security has carried and the dates each one applied. An ISIN changes on a reverse split, a redomiciliation or a reorganization, and a system keyed on ISIN needs the full list to join today's holdings to yesterday's history.

One row is returned per ISIN span. Rows carry their real dates: from_date is the day the ISIN took effect even when that is before your requested window, and to_date is null while the ISIN still applies. Your window selects which rows are returned (any row that overlaps it), it does not re-date them. A change that has been announced but is not yet effective has a from_date in the future and is only returned when your to_date reaches it.

An ISIN belongs to the security, not to a listing, so every listing of the same security returns the same rows, and identifying the stock by security id (stock/sid/3001547/isin_history) is the direct way in. The from_date you pass still anchors which listing is resolved, exactly as on every other stock endpoint.

Available Data Points:

  • From Date: The first date this ISIN applied (YYYY-MM-DD).
  • To Date: The last date it applied, or null while it still does.
  • ISIN: The International Securities Identification Number.

Try it out! You can test the API with the trial key TEST. Simply include it in your request headers; either here, or add the header "Ortex-Api-Key": "TEST" to your http request.

Trial key restrictions: Trial keys may be limited to a specific date range and set of regions. Requests outside the allowed regions or entirely outside the allowed date range are rejected; a date window that partially overlaps the allowed range is trimmed to it, reported in meta.restriction.

Get full access! Get a key at app.ortex.com/apis

Path Params
string
required

Where to find the instrument: a venue (exchange symbol, MIC or ISO-2 country) or an identifier scheme (tid, sid, cid, isin, figi). See Identifying an instrument.

string
required

The ticker on that venue, or the value in that scheme. An ISIN, sid, cid or share-class FIGI answers for the main listing only; reference/listings lists the others. See Identifying an instrument.

Query Params
date
required

Inclusive start of the returned date window. Format: YYYY-MM-DD.

Also selects the instrument: the ticker resolves to the listing that held it on the exchange in the URL path on this date. To retrieve a delisted or renamed company, use its former exchange and ticker with a from_date from when it was listed. An identifier path (/stock/isin|figi|sid|cid/<value>/…) resolves at this date too. The instrument block in the response names the company the data belongs to.

date

Inclusive end of the returned date window (defaults to today). Format: YYYY-MM-DD.

integer

Page number within the paginated result set. Must be >= 1. Defaults to 1.

integer

Number of rows per page. The default and the maximum allowed depend on the API tier; a value above the tier maximum is rejected with 400 invalidPageSize.

string
enum
Defaults to json

Response format. "json" (default) or "csv".

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/csv