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

# Get Fiscal Dates by Fiscal Year

> [OpenAPI JSON Spec](/docs/output/v1_stocks_fiscal-dates_get.json)
Retrieve fiscal date information for a specific stock by fiscal year and quarter

**Feature Overview**
Get fiscal dates including calendar end dates and public dates for stocks based on fiscal year and quarter.

**Main Use Cases**
- **Financial Analysis**: Understand fiscal calendar for earnings analysis
- **Earnings Tracking**: Track fiscal quarters and their corresponding calendar dates
- **Investment Planning**: Plan investments around fiscal reporting periods
- **Data Alignment**: Align financial data with correct fiscal periods

**Response Data Structure**

Each fiscal date record includes:
- **symbol**: Stock symbol (e.g., "AAPL")
- **fiscalYear**: Fiscal year (e.g., 2024)
- **fiscalQuarter**: Fiscal quarter (Q1/Q2/Q3/Q4/FY)
- **calendarEnd**: End date of the fiscal quarter or year covered by the earnings report (YYYY-MM-DD format)
- **publicDate**: Date when the earnings report was publicly released (YYYY-MM-DD format, empty string if not available)



## OpenAPI

````yaml /api-reference/openapi.json get /v1/stocks/fiscal-dates
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Welcome to Arrays!


    Arrays is a unified financial data layer for both financial institutions and
    retail users, delivering comprehensive market data across crypto and equity
    markets. Our datasets cover fundamentals, ETFs, options, crypto, and more.


    Visit [arrays.org](https://arrays.org) to request an API key and start your
    free trial. You can explore our full API offerings in the documentation
    below.


    For any questions regarding APIs or pricing, please contact
    support@arrays.org.
  title: Arrays API
  version: '1.0'
servers:
  - url: https://data-tools.prd.arrays.org/api
security: []
paths:
  /v1/stocks/fiscal-dates:
    get:
      tags:
        - Stock
      summary: Get Fiscal Dates by Fiscal Year
      description: >-
        [OpenAPI JSON Spec](/docs/output/v1_stocks_fiscal-dates_get.json)

        Retrieve fiscal date information for a specific stock by fiscal year and
        quarter


        **Feature Overview**

        Get fiscal dates including calendar end dates and public dates for
        stocks based on fiscal year and quarter.


        **Main Use Cases**

        - **Financial Analysis**: Understand fiscal calendar for earnings
        analysis

        - **Earnings Tracking**: Track fiscal quarters and their corresponding
        calendar dates

        - **Investment Planning**: Plan investments around fiscal reporting
        periods

        - **Data Alignment**: Align financial data with correct fiscal periods


        **Response Data Structure**


        Each fiscal date record includes:

        - **symbol**: Stock symbol (e.g., "AAPL")

        - **fiscalYear**: Fiscal year (e.g., 2024)

        - **fiscalQuarter**: Fiscal quarter (Q1/Q2/Q3/Q4/FY)

        - **calendarEnd**: End date of the fiscal quarter or year covered by the
        earnings report (YYYY-MM-DD format)

        - **publicDate**: Date when the earnings report was publicly released
        (YYYY-MM-DD format, empty string if not available)
      parameters:
        - description: Stock symbol (e.g., AAPL)
          in: query
          name: symbol
          required: true
          schema:
            type: string
        - description: Fiscal year (e.g., 2024)
          in: query
          name: fiscal_year
          required: true
          schema:
            type: integer
        - description: Fiscal quarter (Q1/Q2/Q3/Q4/FY)
          in: query
          name: fiscal_quarter
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved fiscal dates
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.FiscalDateData'
                        type: array
                    type: object
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      error:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      error:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        metadata: {}
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.FiscalDateData:
      properties:
        calendar_end:
          description: >-
            End date of the fiscal quarter or year covered by the earnings
            report (YYYY-MM-DD)
          example: '2024-03-31'
          type: string
        fiscal_quarter:
          description: Fiscal quarter (Q1/Q2/Q3/Q4/FY)
          example: Q1
          type: string
        fiscal_year:
          description: Fiscal year
          example: 2024
          type: integer
        public_date:
          description: >-
            Date when the earnings report was publicly released (YYYY-MM-DD),
            empty string if not available
          example: '2024-04-15'
          type: string
        symbol:
          description: Stock symbol
          example: AAPL
          type: string
      type: object
    model.APIError:
      properties:
        code:
          example: RESOURCE_NOT_FOUND
          type: string
        details:
          items:
            $ref: '#/components/schemas/model.APIErrorDetail'
          type: array
        docs_url:
          type: string
        examples:
          items:
            type: string
          type: array
        hint:
          type: string
        message:
          example: The requested resource was not found.
          type: string
        suggestions:
          items:
            type: string
          type: array
      type: object
    model.APIErrorDetail:
      properties:
        field:
          type: string
        got:
          type: string
        reason:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: 'API Key authentication. Example: "your-api-key-here"'
      in: header
      name: X-API-Key
      type: apiKey

````