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

# قائمة الدخل

<ResponseExample>
  ```json استجابة (200 OK) theme={null}
  {
    "ok": "true",
    "data": []
  }
  ```

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

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

  ```json استجابة (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 ar/openapi/data-api-proxy.spec.yml GET /api/v3/fundamentals/income-statement
openapi: 3.0.0
info:
  contact: {}
  description: >-
    توفّر واجهة برمجة التطبيقات REST هذه نقاط نهاية للبحث في الأساسيات المالية
    والحصول على تفاصيلها.
  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: بيانات قائمة الدخل v3
      description: >-
        يسترجع بيانات شاملة لقائمة الدخل للأوراق المالية المحددة. تتضمن
        الإيرادات، وتكلفة البضائع المباعة، والمصروفات التشغيلية، والدخل
        التشغيلي، ومصروفات الفائدة، والضرائب، وصافي الدخل، وربحية السهم. تُعد
        هذه البيانات أساسية لتحليل ربحية الشركة وأدائها التشغيلي عبر الوقت.
      operationId: get-income-statement-v3
      parameters:
        - description: >-
            قائمة مفصولة بفواصل من رموز تداول الأسهم (مثل AAPL,MSFT,GOOGL). هذا
            الحقل مطلوب.
          in: query
          name: symbols
          required: true
          schema:
            type: string
        - description: >-
            تاريخ بدء الاستعلام. يدعم تنسيقات متعددة: YYYY-MM-DD (مثلًا
            2024-01-01)، أو YTD (منذ بداية السنة من 1 يناير)، أو تواريخ نسبية
            مثل 1MONTH/1m/1M (قبل شهر واحد)
          in: query
          name: from
          schema:
            type: string
        - description: >-
            تاريخ انتهاء الاستعلام. التنسيق: YYYY-MM-DD (مثال: 2024-12-31).
            يُرجع البيانات حتى هذا التاريخ (ضمناً).
          in: query
          name: to
          schema:
            type: string
        - description: >-
            عامل تصفية لنوع التقرير في القوائم المالية. القيم المدعومة: TTM (آخر
            اثني عشر شهرًا)، A (كما تم الإبلاغ عنها أصلاً)، R (القيم المعاد
            بيانها)، P (الإعلانات الأولية)
          in: query
          name: date
          schema:
            type: string
      responses:
        '200':
          description: بيانات قائمة الدخل
          content:
            application/json:
              schema:
                type: object
        '400':
          description: طلب غير صالح - معلمة الرموز مفقودة أو غير صالحة
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '500':
          description: خطأ داخلي في الخادم
          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:
        - 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
        - unsupported_message_type
        - database_query_error
      type: string
      x-enum-varnames:
        - ErrorJSONUnmarshaling
        - ErrorNoDataFound
        - ErrorNoMatchingEndpoint
        - ErrorBadRequest
        - ErrorDBError
        - ErrorInternalServerError
        - ErrorAuthFailed
        - ErrorForbidden
        - ErrorFailedDependency
        - ErrorServiceUnavailable
        - ErrorUpstreamAPIError
        - ErrorUnsupportedMessageType
        - ErrorDBQueryError
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````