> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ainvest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Earnings calendar

> Get earnings announcements on the specified date

For more info including corresponding SEC forms and investor call transcripts, please refer to [earnings by ticker](/reference/securities/stock-earnings) API endpoint.

An earnings report is a company's official statement showing how much money they made (or lost) during the previous quarter.
Securities and Exchange Commission (SEC) requires all public companies to file Form 10-Q for each of the first three quarters of the company's fiscal year.
At the last quarter of a fiscal year the quarterly report is not published, the annual Form 10-K must be filed instead. This report, unlike the quarterly one, is audited by an independent audit firm and tends to have more details.
The exact filing dates depend on organization's fiscal year.

### The two numbers that matter most

Earnings reports matter because they're the closest thing to financial truth in the stock market.

**Earnings Per Share (EPS)**: This is the company's total profit divided by the number of shares outstanding. If a company earned \$100 million and has 50 million shares, that's \$2 per share. EPS tells you how profitable the company is.

**Revenue**: This is the total amount of money flowing into the company before expenses. Revenue shows whether the business is growing, shrinking, or staying flat. A company might have great revenue but poor profits, or they might have lower revenue but excellent profit margins.

Here's where it gets interesting for traders. Before each earnings report, analysts make predictions about what they think the EPS and revenue will be. These are called "estimates" or "expectations". Beat expectations? Stock often jumps up. Miss expectations? Stock often goes down. Sometimes even good news sends stocks down if investors were expecting *great* news.
There are multiple strategies that can help making a decision, one of them is [testing on historical data](/reference/calendar/earnings-backtesting).


## OpenAPI

````yaml reference/calendar/calendar.yaml GET /calendar/earnings
openapi: 3.1.0
info:
  title: Get financial calendar
  description: >-
    Get financial calendar data, including earnings, corporate actions,
    dividends and other events
  version: 1.0.0
servers:
  - url: https://openapi.ainvest.com/open
    description: Production environment
security:
  - bearerAuth: []
tags:
  - name: Calendar
    description: Financial calendar events
    externalDocs:
      url: https://docs.ainvest.com/calendar
paths:
  /calendar/earnings:
    get:
      tags:
        - Calendar
      summary: Get earnings calendar
      description: Get earnings announcements on the specified date
      operationId: getEarningsCalendar
      parameters:
        - name: date
          in: query
          required: true
          description: The date for which to get earnings announcements, format YYYY-MM-DD
          schema:
            type: string
      responses:
        '200':
          description: Successful response in standard envelope
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-04/schema#
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      data:
                        type: array
                        description: >-
                          A list of securities that have announced earnings on
                          the specified date
                        items:
                          type: object
                          properties:
                            ticker:
                              type: string
                              description: >-
                                US stock market ticker symbol, e.g. AAPL, TSLA,
                                etc.
                            unique_id:
                              type: string
                              description: Unique identifier for the event
                            period_name:
                              type: string
                              description: >-
                                Name of the period, e.g. Q2 2025. The financial
                                periods are specific for each company and they
                                don't necessarily match the calendar periods
                            eps_actual:
                              type: number
                              description: Earnings per share reported, in US dollars
                            eps_forecast:
                              type: number
                              description: >-
                                Earnings per share forecasted before the release
                                report, in US dollars
                            eps_surprise:
                              type: number
                              description: >-
                                Percentage value of difference between actual
                                and forecasted EPS
                            revenue_actual:
                              type: number
                              description: Revenue reported, in US dollars
                            revenue_forecast:
                              type: number
                              description: >-
                                Revenue forecasted before the released report,
                                in US dollars
                            revenue_surprise:
                              type: number
                              description: >-
                                Percentage value of difference between actual
                                and forecasted revenue
                  status_code:
                    type: number
                    description: Status code, `0` for success
                  status_msg:
                    type: string
                    description: Status message, `success` for success
        '400':
          description: Validation error, i.e. date is not specified or invalid format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status_code: 4012
                status_msg: Invalid param
components:
  schemas:
    Error:
      type: object
      properties:
        status_code:
          type: integer
          description: Business status code
        status_msg:
          type: string
          description: Error message
      required:
        - status_code
        - status_msg
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your key. [Get the key
        here](https://www.ainvest.com/business/developer-manage/)

````