Company Earnings

API Enterprise

Earnings announcements for the company behind one instrument - past results and scheduled upcoming dates - with the announcement time where the company has published one.

Available Data Points:

  • Datetime: The most important date and time of the announcement, YYYY-MM-DDTHH:mmZ (UTC).
  • Title: A human-readable headline for the announcement, e.g. 'Q4 Earnings 2025'.
  • Description: The announcement's summary, including the session (before or after market) where known.
  • Estimated Date: True when the date is an estimate (a derived expected release date) rather than one the company has announced. An estimate is replaced by the announced date once one exists.
  • Event Type Name: The source event type name, which says the same thing in words.

Filtering

from_date and to_date are both required on this endpoint; a future to_date includes scheduled announcements. Results are ordered by announcement time, most recent first.

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]

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. Required — a missing value returns 400 invalidDateRange. Also anchors instrument resolution: the instrument that owned the ticker at this date is the one the whole response describes. Format: YYYY-MM-DD.

date
required

Inclusive end of the returned date window. Required — a missing value returns 400 invalidDateRange. 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