> ## 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}
  {
    "earnings": [
      {
        "currency": "USD",
        "cusip": "037833100",
        "date": "2026-10-29",
        "date_confirmed": 0,
        "eps": "",
        "eps_est": "1.990",
        "eps_prior": "1.850",
        "eps_surprise": "",
        "eps_surprise_percent": "",
        "eps_type": "",
        "exchange": "NASDAQ",
        "id": "69030cfb619d3a00015b72a3",
        "importance": 5,
        "isin": "US0378331005",
        "name": "Apple",
        "notes": "",
        "period": "Q4",
        "period_year": 2026,
        "revenue": "",
        "revenue_est": "",
        "revenue_prior": "102466000000.000",
        "revenue_surprise": "",
        "revenue_surprise_percent": "",
        "revenue_type": "",
        "ticker": "AAPL",
        "time": "16:00:00",
        "updated": 1766187011
      }
    ]
  }
  ```

  ```json استجابة (401 Unauthorized) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "auth_failed",
        "id": "unauthorized",
        "value": "رمز الوصول للمصادقة غير صالح أو مفقود"
      }
    ]
  }
  ```

  ```json استجابة (404 Not Found) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "no_data_found",
        "id": "not_found",
        "value": "لم يتم العثور على بيانات للمعاملات المحددة"
      }
    ]
  }
  ```

  ```json استجابة (500 Internal Server Error) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "internal_server_error",
        "id": "server_error",
        "value": "حدث خطأ غير متوقع أثناء معالجة طلبك"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml ar/openapi/calendar-api.spec.yml GET /api/v2.1/calendar/earnings
openapi: 3.0.0
info:
  contact: {}
  description: >-
    تُعيد واجهة برمجة تطبيقات REST هذه بيانات مُنظَّمة لمكالمات المؤتمرات
    الهاتفية (conference calls)، وتوزيعات الأرباح (dividends)، والأرباح (بما في
    ذلك تواريخ الأرباح المستقبلية)، والبيانات الاقتصادية، وإعلانات شركات
    الأدوية، والتوجيّهات المستقبلية للشركات (guidance)، والاكتتابات العامة
    الأولية (IPOs)، والعروض الثانوية، والتقييمات (ratings)، وأنشطة الاندماجات
    والاستحواذات (M&A)، وتجزيئة الأسهم (splits).
  termsOfService: http://swagger.io/terms/
  title: Calendar API
  version: 2.1.0
servers:
  - url: https://api.benzinga.com
    description: PROD
security: []
paths:
  /api/v2.1/calendar/earnings:
    get:
      tags:
        - earnings
      summary: يُرجِع بيانات الأرباح
      description: >-
        تُرجِع بيانات الأرباح لفترة محددة و/أو ورقة مالية معينة. تتضمن البيانات
        قيم ربحية السهم الفعلية وأرقام الإيرادات، بالإضافة إلى التقديرات
        والمفاجآت والمقارنات التاريخية. تُعَدّ بيانات الأرباح أساسية للمستثمرين
        لتقييم أداء الشركة.
      operationId: get-earnings
      parameters:
        - description: >-
            يحدِّد تنسيق الاستجابة. تعمل معلمات الاستعلام بالطريقة نفسها في كلا
            التنسيقين
          in: header
          name: accept
          required: true
          schema:
            type: string
            enum:
              - application/json
            default: application/json
        - description: >-
            إزاحة الصفحة. لأسباب تتعلق بالتحسين والأداء والاعتبارات التقنية،
            تُقيَّد قيم إزاحة الصفحة بين 0 و100000. احصر نتائج الاستعلام
            باستخدام معاملات أخرى مثل التاريخ.
          in: query
          name: page
          schema:
            type: integer
            default: 0
        - description: عدد النتائج المُرجَعة. الحد الأقصى 1000
          in: query
          name: pagesize
          schema:
            type: integer
        - description: >-
            التاريخ المستخدم للاستعلام عن بيانات calendar. اختصار لـ date_from و
            date_to إذا كانتا متطابقتين. وفي حال عدم التحديد، تكون القيمة
            الافتراضية هي الأحدث
          in: query
          name: parameters[date]
          schema:
            type: string
            format: YYYY-MM-DD
        - description: تاريخ بدء الاستعلام كنقطة زمنية محددة
          in: query
          name: parameters[date_from]
          schema:
            type: string
            format: YYYY-MM-DD
        - description: تاريخ الاستعلام حتى هذه النقطة الزمنية
          in: query
          name: parameters[date_to]
          schema:
            type: string
            format: YYYY-MM-DD
        - description: >-
            خيار حقل الفرز لتقويم الأرباح. استخدم `:desc` أو `:asc` لترتيب
            النتائج
          in: query
          name: parameters[date_sort]
          schema:
            type: string
            enum:
              - date
        - description: >-
            مستوى الأهمية للتصفية حسبه. يستخدم مقارنة «أكبر من أو يساوي» مع
            مستوى الأهمية المحدد
          in: query
          name: parameters[importance]
          schema:
            type: integer
            enum:
              - 0
              - 1
              - 2
              - 3
              - 4
              - 5
        - description: رمز تداول واحد أو أكثر مفصولة بفواصل. الحد الأقصى 50 رمز تداول
          in: query
          name: parameters[tickers]
          schema:
            type: string
            format: csv
        - description: >-
            الطابع الزمني بنظام Unix (بتوقيت UTC) لآخر تحديث للسجلات. سيؤدي هذا
            إلى فرض ترتيب فرز بشرط أن يكون أكبر من أو يساوي الطابع الزمني
            المُشار إليه
          in: query
          name: parameters[updated]
          schema:
            type: integer
      responses:
        '200':
          description: نجاح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.EarningResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.EarningResponse'
        '400':
          description: طلب غير صالح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.ErrorResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.ErrorResponse'
        '500':
          description: خطأ داخلي في الخادم
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.ErrorResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    api.EarningResponse:
      description: استجابة واجهة برمجة التطبيقات API التي تتضمن مصفوفة سجلات للأرباح
      properties:
        earnings:
          items:
            $ref: '#/components/schemas/calendarapi.Earning'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.Earning:
      properties:
        currency:
          example: USD
          type: string
        cusip:
          example: 37833100
          type: string
        date:
          example: '2024-01-09T00:00:00.000Z'
          type: string
        date_confirmed:
          example: 1
          type: integer
        eps:
          example: '2.18'
          type: string
        eps_est:
          example: '2.10'
          type: string
        eps_prior:
          example: '1.88'
          type: string
        eps_surprise:
          example: '0.08'
          type: string
        eps_surprise_percent:
          example: '3.81'
          type: string
        eps_type:
          example: GAAP
          type: string
        exchange:
          example: NASDAQ
          type: string
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5a3
          type: string
        importance:
          example: 5
          type: integer
        isin:
          example: US0378331005
          type: string
        name:
          example: Apple Inc.
          type: string
        notes:
          example: Beat on EPS and revenue
          type: string
        period:
          example: Q1
          type: string
        period_year:
          example: 2024
          type: integer
        revenue:
          example: '89537000000'
          type: string
        revenue_est:
          example: '88500000000'
          type: string
        revenue_prior:
          example: '81800000000'
          type: string
        revenue_surprise:
          example: '1037000000'
          type: string
        revenue_surprise_percent:
          example: '1.17'
          type: string
        revenue_type:
          example: GAAP
          type: string
        ticker:
          example: AAPL
          type: string
        time:
          example: amc
          type: string
        updated:
          example: 1704819600
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````