> ## 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}
  {
    "offerings": [
      {
        "currency": "USD",
        "cusip": "73245B107",
        "date": "2025-12-29",
        "dollar_shares": "50000000.000",
        "exchange": "NASDAQ",
        "id": "69531bc06ab0a40001b39686",
        "importance": 2,
        "name": "SBC Medical Group Holding",
        "notes": "",
        "number_shares": 0,
        "offering_type": "",
        "price": "",
        "proceeds": "",
        "shelf": true,
        "ticker": "SBC",
        "time": "19:24:32",
        "updated": 1767054276,
        "url": ""
      }
    ]
  }
  ```

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

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

  ```json استجابة (500 خطأ في الخادم الداخلي) 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/offerings
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/offerings:
    get:
      tags:
        - offerings
      summary: يعيد بيانات الطرح الثانوي
      description: >-
        يُرجِع بيانات الطروحات الثانوية للشركات المساهمة العامة التي تُصدِر
        أسهماً إضافية بعد طرحها العام الأولي (IPO). تتضمن البيانات سعر الطرح،
        وحصيلة الطرح، وعدد الأسهم، والطروحات المسجلة على أساس الرف (Shelf
        Offerings)، وما إذا كانت الأوراق المالية تُباع على دفعات بمرور الوقت أو
        دفعة واحدة في تاريخ الطرح.
      operationId: get-offerings
      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[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.OfferingResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.OfferingResponse'
        '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.OfferingResponse:
      description: استجابة من واجهة برمجة التطبيقات API تتضمن مصفوفة من سجلات الطروحات
      properties:
        offerings:
          items:
            $ref: '#/components/schemas/calendarapi.Offering'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.Offering:
      properties:
        currency:
          example: USD
          type: string
        cusip:
          example: 88160R101
          type: string
        date:
          example: '2024-01-09T00:00:00.000Z'
          type: string
        dollar_shares:
          example: '5000000000'
          type: string
        exchange:
          example: NASDAQ
          type: string
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5ab
          type: string
        importance:
          example: 4
          type: integer
        name:
          example: Tesla Inc.
          type: string
        notes:
          example: Common stock offering
          type: string
        number_shares:
          example: 20592018
          type: integer
        offering_type:
          example: Follow-on
          type: string
        price:
          example: '242.84'
          type: string
        proceeds:
          example: '5000000000'
          type: string
        shelf:
          example: false
          type: boolean
        ticker:
          example: TSLA
          type: string
        time:
          example: '09:30:00'
          type: string
        updated:
          example: 1704819600
          type: integer
        url:
          example: https://www.benzinga.com/offering/123456
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````