> ## 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}
  {
    "events": [
      {
        "date_end": "2026-01-13",
        "date_start": "2026-01-13",
        "event_name": "28th Annual Needham Growth Conference",
        "event_type": "Corporate conference presentation",
        "id": "695b762f1bd4be000196669c",
        "importance": 3,
        "international_number": "",
        "location": "New York",
        "phone_number": "",
        "securities": [
          {
            "country": "USA",
            "cusip": "346375108",
            "exchange": "NASDAQ",
            "isin": "US3463751087",
            "symbol": "FORM"
          }
        ],
        "source_link": "https://www.formfactor.com/events/",
        "start_time": "15:00:00",
        "tags": [
          "Needham Growth Conference"
        ],
        "updated": 1767602218,
        "webcast_link": ""
      }
    ]
  }

  ```

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

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

  ```json استجابة (500 خطأ في الخادم الداخلي) 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/calendar-api.spec.yml GET /api/v2/calendar/events
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/calendar/events:
    get:
      tags:
        - events
      summary: الأحداث
      description: >-
        يُرجِع فعاليات الشركات، بما في ذلك اجتماعات المستثمرين والمؤتمرات
        والإعلانات الخاصة
      operationId: get-events
      parameters:
        - description: >-
            إزاحة الصفحة. لأسباب تتعلق بالأداء والتحسين والاعتبارات التقنية،
            تقتصر قيم إزاحة الصفحة على النطاق من 0 إلى 100000. قيّد نتائج
            الاستعلام باستخدام معايير أخرى مثل التاريخ. القيمة الافتراضية هي 0
          in: query
          name: page
          schema:
            type: integer
            default: 0
        - description: عدد النتائج المعادة. الحد الأقصى 1000
          in: query
          name: pageSize
          schema:
            type: integer
            default: 100
        - description: >-
            التاريخ المطلوب الاستعلام عنه للحصول على بيانات calendar. يُستخدم
            كاختصار لـ date_from و date_to إذا كانا متطابقين. في حال عدم
            التحديد، تكون القيمة الافتراضية هي أحدث تاريخ.
          in: query
          name: parameters[date]
          schema:
            type: string
            format: date
        - description: تاريخ البدء بالتنسيق YYYY-MM-DD
          in: query
          name: parameters[date_from]
          schema:
            type: string
            format: date
        - description: تاريخ الانتهاء بالصيغة YYYY-MM-DD
          in: query
          name: parameters[date_to]
          schema:
            type: string
            format: 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
        - description: نوع مفاتيح البحث
          in: query
          name: search_keys_type
          schema:
            type: string
            enum:
              - event_type
        - description: مفاتيح البحث
          in: query
          name: search_keys
          schema:
            type: string
      responses:
        '200':
          description: الأحداث
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.EventsResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.EventsResponse'
        '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.EventsResponse:
      description: استجابة واجهة برمجة التطبيقات API التي تتضمن مصفوفة سجلات للأحداث
      properties:
        events:
          items:
            $ref: '#/components/schemas/calendarapi.Events'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.Events:
      properties:
        date_end:
          example: '2024-01-11T00:00:00.000Z'
          type: string
        date_start:
          example: '2024-01-09T00:00:00.000Z'
          type: string
        event_name:
          example: CES 2024
          type: string
        event_type:
          example: Conference
          type: string
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5bc
          type: string
        importance:
          example: 3
          type: integer
        international_number:
          example: +1-212-555-0100
          type: string
        location:
          example: Las Vegas Convention Center
          type: string
        phone_number:
          example: 1-800-555-0100
          type: string
        securities:
          items:
            $ref: '#/components/schemas/calendarapi.Securities'
          type: array
        source_link:
          example: https://www.example.com/event-details
          type: string
        start_time:
          example: '09:00:00'
          type: string
        tags:
          example:
            - '["Technology"'
            - '"Innovation"]'
          items:
            type: string
          type: array
        updated:
          example: 1704819600
          type: integer
        webcast_link:
          example: https://webcast.example.com/event123
          type: string
      type: object
    calendarapi.Securities:
      properties:
        country:
          example: US
          type: string
        cusip:
          example: 37833100
          type: string
        exchange:
          example: NASDAQ
          type: string
        isin:
          example: US0378331005
          type: string
        symbol:
          example: AAPL
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````