API Enterprise

Region-wide dividend events over a date window. One request returns every dividend event, for every listing in the requested region, whose ex-date falls inside the window — the same rows the single-stock dividends endpoint serves, without a per-ticker fan-out.

Built for enterprise consumers: the response is uncharged (no credits), and every row carries the full instrument-identity block so it can be joined straight onto your own security master. Announced future dividends are included.

Available Data Points:

• Company: The name of the company issuing the security.
• Ticker: The ticker symbol associated with the security.
• Operating MIC: The operating Market Identifier Code of the security.
• MIC: The Market Identifier Code (MIC) for the traded security.
• ISIN: The International Securities Identification Number for the security.
• FIGI: The Financial Instrument Global Identifier.
• Share Class FIGI: The Financial Instrument Global Identifier for the share class.
• Ortex Company ID: Unique id for a company.
• Ortex Security ID: Unique id for a security issued by a company.
• Ortex Tradable item ID: Unique id for a listing of a security.
• Ortex Tradable item main indicator: Indicates if the trading item is the main trading item for the security.
• Tradable Item Currency: The currency of the tradable item.
• Exchange Country: The country location of the exchange.
• Ex Date: The ex-dividend date — the first trading day the share trades without the dividend (YYYY-MM-DD format).
• Pay Date: The date the dividend is paid to shareholders.
• Record Date: The date on which a shareholder must be on the register to receive the dividend.
• Announced Date: The date the dividend was announced.
• Amount: The declared dividend amount per share, in the payment currency.
• Net Amount: The dividend amount per share net of withholding, where reported.
• Gross Amount: The gross dividend amount per share, where reported.
• Currency: The ISO code of the payment currency.
• Frequency: The payment frequency (e.g. quarterly, semi-annual, annual).
• Dividend Type: The type of the dividend event (e.g. regular cash, special cash).
• Is Special: Whether the dividend is a special (non-regular) distribution.

Region and window

Use region to select the universe (a region name, an ISO-2 country code, or ALL; defaults to US). from_date (required) and to_date (defaults to today) bound the ex-date window, which may span at most 366 days. Results are ordered by ex-date, most recent first.

Identity and coverage

Dividends ORTEX could not match to a listing are not included: a row with no listing has no country to place it in a region by, so the feed is limited to well-mapped issuers. Delisted listings are included, but every row's identity columns (company name, ticker, ISIN and the ORTEX ids) are the listing's current values rather than those it carried on the event's date; ISIN is null where the listing no longer has an active ISIN.

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! Contact [email protected]