> ## 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.

# Dividends calendar

> Get dividends on the specified ex-date. Both historical or upcoming dividends can be retrieved.

<Frame caption="Asking Claude about dividends income using Ainvest MCP server">
  <img src="https://mintcdn.com/ainvest-8e114140/DGzrPnVwd1HT0tfj/images/mcp-calendar-dividends.png?fit=max&auto=format&n=DGzrPnVwd1HT0tfj&q=85&s=d7bb01050f83fd221c4e4b4040129716" alt="Asking Claude about dividends income using Ainvest MCP server" width="1820" height="2030" data-path="images/mcp-calendar-dividends.png" />
</Frame>


## OpenAPI

````yaml reference/calendar/calendar.yaml GET /calendar/dividends
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/dividends:
    get:
      tags:
        - Calendar
      summary: Get dividends calendar
      description: >-
        Get dividends on the specified ex-date. Both historical or upcoming
        dividends can be retrieved.
      operationId: getDividendsCalendar
      parameters:
        - name: date
          in: query
          required: true
          description: The date for which to get dividends, 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 with specified ex-dividend date
                        items:
                          type: object
                          properties:
                            ticker:
                              type: string
                              description: >-
                                US stock market ticker symbol, e.g. AAPL, TSLA,
                                etc.
                            ex_date:
                              type: string
                              description: >-
                                Ex-dividend date, format YYYY-MM-DD. It
                                represents the cutoff point for determining who
                                is eligible to receive a company's dividend
                                payment. For example, if a stock's ex-dividend
                                date is set for March 1, shareholders who
                                purchase the stock on or after that date will
                                not receive the dividend payment.
                            pay_date:
                              type: string
                              description: >-
                                The date when the dividend is actually
                                distributed to shareholders, format YYYY-MM-DD
                            amount:
                              type: number
                              description: >-
                                The amount in US dollars that is paid per share
                                as a dividend
                  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/)

````