---
title: "List of earning events"
method: GET
path: "/api/v1/earnings"
tags: ["Company Earnings Events"]
---

# List of earning events

`GET /api/v1/earnings`

Provides upcoming or historic earnings announcements for publicly traded companies, including an optional timestamp when it is available.

### Available Data Points:

*   **Exchange:** The stock exchange where the company is listed (e.g., "Nasdaq", "NYSE").
*   **Ticker:** The company's stock ticker symbol.
*   **Datetime:** Most important date and time of the earnings event in \`YYYY-MM-DDTHH:mmZ\` format.
*   **Company:** Full name of the company.
*   **Title:** A human-readable headline of the earnings event.
*   **Description:** Brief summary or additional details about the earnings event

**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:** A list of randomly selected rows will be returned

**Get full access!** Get a key at [app.ortex.com/apis](https://app.ortex.com/apis)

## Query parameters

- `from_date` string
- `page` integer
- `page_size` integer
- `to_date` string

## Response `200`

- PaginatedCompanyEarningsList
  - `paginationLinks` object
  - `length` integer, required
  - `rows` CompanyEarnings[], required
    - `exchange` string, nullable
    - `ticker` string, nullable
    - `datetime` string, date-time, nullable
    - `company` string, required
    - `title` string, required
    - `description` string, required
  - `creditsUsed` integer
  - `creditsLeft` integer

## Other responses

- `400` — Invalid request parameters
- `403` — Not authorized
- `404` — Data not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/ortex/apis/ortex-apis.md) · [All operations](https://skmtc.dev/ortex/apis/ortex-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ortex/ortex-apis/revisions/2629fc613cdc/schema)