> ## 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}
  {
    "dividends": [
      {
        "confirmed": false,
        "currency": "USD",
        "cusip": "33740U620",
        "date": "2026-12-31",
        "dividend": "0.1636",
        "dividend_prior": "0.1636",
        "dividend_type": "Cash",
        "dividend_yield": "",
        "end_regular_dividend": false,
        "ex_dividend_date": "2027-01-04",
        "exchange": "BATS",
        "frequency": 12,
        "id": "6958d4d893cde40001ee2606",
        "importance": 1,
        "isin": "US33740U6203",
        "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - March",
        "notes": "",
        "payable_date": "2027-01-05",
        "period": "JAN",
        "record_date": "2027-01-04",
        "ticker": "XIMR",
        "updated": 1767429336,
        "year": 2027
      },
      {
        "confirmed": false,
        "currency": "USD",
        "cusip": "33740F235",
        "date": "2026-12-31",
        "dividend": "0.1788",
        "dividend_prior": "0.1788",
        "dividend_type": "Cash",
        "dividend_yield": "",
        "end_regular_dividend": false,
        "ex_dividend_date": "2027-01-04",
        "exchange": "BATS",
        "frequency": 12,
        "id": "6958d4d393cde40001ee25f5",
        "importance": 1,
        "isin": "US33740F2359",
        "name": "First Trust Exchange-Traded Fund VIII FT Vest U.S. Equity Buffer & Premium Income ETF - June",
        "notes": "",
        "payable_date": "2027-01-05",
        "period": "JAN",
        "record_date": "2027-01-04",
        "ticker": "XIJN",
        "updated": 1767429331,
        "year": 2027
      }
    ]
  }
  ```

  ```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.2/calendar/dividends
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.2/calendar/dividends:
    get:
      tags:
        - Dividends
      summary: أحداث توزيعات الأرباح V2.2
      description: >-
        يُرجع بيانات توزيعات الأرباح لفترة و/أو ورقة مالية محددة، بما في ذلك
        تواريخ توزيعات الأرباح المؤكدة وغير المؤكدة. تتضمن V2.2 حقولًا إضافية:
        confirmed و period و year. يوفّر هذا الإصدار معلومات أكثر تفصيلاً حول
        حالة تأكيد توزيعات الأرباح ودوريتها.
      operationId: get-dividends-v22
      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: حقل تاريخ توزيع الأرباح للفرز (من الأحدث إلى الأقدم)
          in: query
          name: parameters[date_sort]
          schema:
            type: string
            enum:
              - announced
              - ex
              - payable
              - record
        - description: >-
            يحدد طريقة التصفية باستخدام عائد الأرباح (dividend yield). gt = أكبر
            من، gte = أكبر من أو يساوي، eq = يساوي، lt = أقل من، lte = أقل من أو
            يساوي
          in: query
          name: parameters[dividend_yield_operation]
          schema:
            type: string
            enum:
              - gt
              - gte
              - eq
              - lte
              - lt
        - description: >-
            قيمة عائد الأرباح (Dividend Yield) المستخدمة كمعيار للتصفية.
            افتراضيًا يُستخدم عامل المطابقة "يساوي" للقيمة المحددة. 1 = 100٪
          in: query
          name: parameters[dividend_yield]
          schema:
            type: number
        - 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 timestamp (UTC). سيؤدي هذا
            إلى فرض ترتيب فرز يكون أكبر من أو يساوي الطابع الزمني المحدَّد
          in: query
          name: parameters[updated]
          schema:
            type: integer
      responses:
        '200':
          description: نجاح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.DividendResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.DividendResponse'
        '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.DividendResponse:
      description: استجابة واجهة برمجة التطبيقات API التي تتضمن مصفوفة سجلات للتوزيعات
      properties:
        dividends:
          items:
            $ref: '#/components/schemas/calendarapi.Dividend'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.Dividend:
      properties:
        confirmed:
          example: true
          type: boolean
        currency:
          example: USD
          type: string
        cusip:
          example: 37833100
          type: string
        date:
          example: '2024-01-09T00:00:00.000Z'
          type: string
        dividend:
          example: '0.25'
          type: string
        dividend_prior:
          example: '0.24'
          type: string
        dividend_type:
          example: Cash
          type: string
        dividend_yield:
          example: '0.55'
          type: string
        end_regular_dividend:
          example: false
          type: boolean
        ex_dividend_date:
          example: '2024-01-12T00:00:00.000Z'
          type: string
        exchange:
          example: NASDAQ
          type: string
        frequency:
          example: 4
          type: integer
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5a7
          type: string
        importance:
          example: 3
          type: integer
        isin:
          example: US0378331005
          type: string
        name:
          example: Apple Inc.
          type: string
        notes:
          example: Regular quarterly dividend
          type: string
        payable_date:
          example: '2024-02-15T00:00:00.000Z'
          type: string
        period:
          example: Q1
          type: string
        record_date:
          example: '2024-01-15T00:00:00.000Z'
          type: string
        ticker:
          example: AAPL
          type: string
        updated:
          example: 1704819600
          type: integer
        year:
          example: 2024
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````