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

# Fundamentals

> Retrieves the latest generation of financial fundamentals data powered by Benzinga's enhanced data pipeline. Provides comprehensive financial statements, metrics, and ratios with improved data quality and coverage. Supports flexible date range queries and relative date specifications.

<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
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:
    get:
      tags:
        - Fundamentals
      summary: Company Fundamentals V3
      description: >-
        Retrieves the latest generation of financial fundamentals data powered
        by Benzinga's enhanced data pipeline. Provides comprehensive financial
        statements, metrics, and ratios with improved data quality and coverage.
        Supports flexible date range queries and relative date specifications.
      operationId: get-fundamentals-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), 1WEEK/1w/1W (1 week ago), 1DAY/1d/1D (1
            day 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. Defaults to current date if not
            specified.
          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: Latest fundamentals data with enhanced coverage and quality
          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

````