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

# Get a list of earning reports filtered by date.

> Returns a paginated list of earning reports within a date range.



## OpenAPI

````yaml api-reference/openapi.json get /v1/earnings-reports
openapi: 3.0.0
info:
  title: CapyFin API
  description: >-
    The CapyFin API provides access to earnings reports with financials, key
    takeaways, revenue breakdowns, and forward guidance, delivered through a
    powerful, developer-friendly API. For support or enterprise access, please
    contact us at support@capyfin.com.
  version: 1.0.0
  contact:
    name: CapyFin Support
    url: https://capyfin.com/support
    email: support@capyfin.com
servers:
  - url: https://api.capyfin.com
    description: CapyFin API
security:
  - ApiKeyQuery: []
  - ApiKeyHeader: []
tags: []
paths:
  /v1/earnings-reports:
    get:
      tags:
        - Earnings Reports API
      summary: Get a list of earning reports filtered by date.
      description: Returns a paginated list of earning reports within a date range.
      operationId: getReports
      parameters:
        - name: from
          required: false
          in: query
          description: Start date for filtering reports (ISO 8601 format).
          schema:
            example: '2024-01-01'
            type: string
        - name: to
          required: false
          in: query
          description: End date for filtering reports (ISO 8601 format).
          schema:
            example: '2024-12-31'
            type: string
        - name: page
          required: false
          in: query
          description: 'Page number for pagination (default: 1).'
          schema:
            example: 1
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PaginatedDto'
                  - properties:
                      items:
                        type: array
                        items:
                          $ref: '#/components/schemas/EarningsReportListItemDto'
components:
  schemas:
    PaginatedDto:
      type: object
      properties:
        total:
          type: number
          description: The total number of results
          example: 100
        sub:
          type: boolean
          description: Whether this response includes subscriber-only data
          example: true
      required:
        - total
    EarningsReportListItemDto:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier for the earning report.
          example: 507f1f77bcf86cd799439011
        fiscalPeriod:
          type: string
          description: The fiscal period of the report (e.g., Q12024, FY2023).
          example: Q12024
        date:
          format: date-time
          type: string
          description: The release date of the earnings report.
          example: '2024-05-02T00:00:00.000Z'
        reportTime:
          type: string
          description: The time of day the report is released.
          enum:
            - amc
            - bmo
            - dm
          example: amc
        currency:
          type: string
          description: The currency of the report values.
          example: USD
        totalRevenue:
          type: number
          description: Total revenue reported.
          example: 94836000000
        eps:
          type: number
          description: Earnings Per Share (EPS).
          example: 1.53
        epsAdj:
          type: number
          description: Adjusted Earnings Per Share (Non-GAAP).
          example: 1.53
        verified:
          type: boolean
          description: Whether the report has been verified.
          example: true
        employees:
          type: number
          description: Number of employees.
          example: 1000
      required:
        - id
        - fiscalPeriod
        - date
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: apikey
      description: >-
        Pass your API key as a query parameter (e.g.,
        /endpoint?apikey=YOUR_API_KEY)
    ApiKeyHeader:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Pass your API key as a Bearer token in the header (e.g., Authorization:
        Bearer YOUR_API_KEY)

````