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

# Income Statement

> Retrieves comprehensive income statement data for specified securities. Includes revenue, cost of goods sold, operating expenses, operating income, interest expense, taxes, net income, and earnings per share. Essential for analyzing company profitability and operational performance over time.

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "ok": "true",
    "data": []
  }
  ```

  ```json Response (401 Unauthorized) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "auth_failed",
        "id": "unauthorized",
        "value": "Invalid or missing authentication token"
      }
    ]
  }
  ```

  ```json Response (404 Not Found) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "no_data_found",
        "id": "not_found",
        "value": "No data found for the specified parameters"
      }
    ]
  }
  ```

  ```json Response (500 Internal Server Error) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "internal_server_error",
        "id": "server_error",
        "value": "An unexpected error occurred while processing your request"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml /openapi/data-api-proxy_api.spec.yml GET /api/v3/fundamentals/income-statement
openapi: 3.0.0
info:
  contact: {}
  description: >-
    This REST API provides endpoints to search for fundamentals and get
    fundamental details.
  termsOfService: http://swagger.io/terms/
  title: Data API Proxy
  version: 2.0.0
servers:
  - url: https://api.benzinga.com
    description: PROD
security: []
paths:
  /api/v3/fundamentals/income-statement:
    get:
      tags:
        - Fundamentals
      summary: Income Statement Data V3
      description: >-
        Retrieves comprehensive income statement data for specified securities.
        Includes revenue, cost of goods sold, operating expenses, operating
        income, interest expense, taxes, net income, and earnings per share.
        Essential for analyzing company profitability and operational
        performance over time.
      operationId: get-income-statement-v3
      parameters:
        - description: >-
            Comma-separated list of stock ticker symbols (e.g.,
            AAPL,MSFT,GOOGL). Required.
          in: query
          name: symbols
          required: true
          schema:
            type: string
        - description: >-
            Start date for query. Supports multiple formats: YYYY-MM-DD (e.g.,
            2024-01-01), YTD (year-to-date from Jan 1), or relative dates like
            1MONTH/1m/1M (1 month ago)
          in: query
          name: from
          schema:
            type: string
        - description: >-
            End date for query. Format: YYYY-MM-DD (e.g., 2024-12-31). Returns
            data up to and including this date.
          in: query
          name: to
          schema:
            type: string
        - description: >-
            Report type filter for financial statements. Supported values: TTM
            (trailing twelve months), A (as originally reported), R (restated
            values), P (preliminary announcements)
          in: query
          name: date
          schema:
            type: string
      responses:
        '200':
          description: Income statement data
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request - missing or invalid symbols parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    bzhttp.Resp:
      properties:
        data:
          additionalProperties: true
          type: object
        errors:
          items:
            $ref: '#/components/schemas/bzhttp.Error'
          type: array
        ok:
          type: boolean
      type: object
    bzhttp.Error:
      properties:
        code:
          $ref: '#/components/schemas/bzhttp.ErrorCode'
        id:
          type: string
        value:
          type: string
      type: object
    bzhttp.ErrorCode:
      enum:
        - unsupported_message_type
        - database_query_error
        - json_unmarshaling_error
        - no_data_found
        - no_matching_endpoint
        - bad_request
        - db_error
        - internal_server_error
        - auth_failed
        - forbidden
        - failed_dependency
        - service_unavailable
        - upstream_api_error
      type: string
      x-enum-varnames:
        - ErrorUnsupportedMessageType
        - ErrorDBQueryError
        - ErrorJSONUnmarshaling
        - ErrorNoDataFound
        - ErrorNoMatchingEndpoint
        - ErrorBadRequest
        - ErrorDBError
        - ErrorInternalServerError
        - ErrorAuthFailed
        - ErrorForbidden
        - ErrorFailedDependency
        - ErrorServiceUnavailable
        - ErrorUpstreamAPIError
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````