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

# الطروحات العامة الأولية IPOs

<ResponseExample>
  ```json استجابة (200 OK) theme={null}
  {
    "ipos": [
      {
        "currency": "USD",
        "date": "2026",
        "deal_status": "Withdrawn",
        "description": "",
        "exchange": "NASDAQ",
        "id": "604b6d8a36622a000186b793",
        "initial_filing_date": "",
        "insider_lockup_date": "",
        "insider_lockup_days": 180,
        "ipo_type": "SPAC Unit",
        "last_yr_income": 0,
        "last_yr_income_year": 0,
        "last_yr_revenue": 0,
        "last_yr_revenue_year": 0,
        "lead_underwriters": [
          "Citigroup",
          "JP Morgan"
        ],
        "market_cap_at_offer": 0,
        "name": "SEP Growth Holdings Corp",
        "notes": "",
        "offering_shares": 25000000,
        "offering_shares_ord_adr": 0,
        "offering_value": 0,
        "open_date_verified": false,
        "ord_shares_out_after_offer": 0,
        "other_underwriters": [],
        "price_max": "",
        "price_min": "",
        "price_open": "",
        "price_public_offering": "10.000",
        "pricing_date": "",
        "pricing_date_verified": false,
        "sec_accession_number": "",
        "sec_filing_url": "",
        "shares_outstanding": 0,
        "sic": 0,
        "spac_converted_to_target": false,
        "state_location": "",
        "ticker": "SEPGU",
        "time": "08:32:58",
        "underwriter_quiet_expiration_date": "",
        "underwriter_quiet_expiration_days": 0,
        "updated": 1767600431
      }
    ]
  }
  ```

  ```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/ipos
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/ipos:
    get:
      tags:
        - ipos
      summary: الاكتتابات العامة الأولية v2.1
      description: >-
        يُرجِع بيانات الطرح العام الأولي (IPO)، بما في ذلك معلومات التسعير،
        ومتعهدي التغطية، وحالة الصفقة، وتفاصيل الطرح
      operationId: get-ipos-v21
      parameters:
        - description: رقم الصفحة
          in: query
          name: page
          schema:
            type: integer
        - description: حجم الصفحة
          in: query
          name: pagesize
          schema:
            type: integer
        - description: >-
            تاريخ الطرح العام الأولي (IPO) بتنسيق YYYY-MM-DD ‏(مَعْلَمة جديدة
            ومفضَّلة)
          in: query
          name: ipo_date
          schema:
            type: string
            format: date
        - description: تاريخ الطرح العام الأولي بتنسيق YYYY-MM-DD ‏(مهمل)
          in: query
          name: parameters[ipo_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[tickers]
          schema:
            type: string
        - description: نوع الطرح العام الأولي
          in: query
          name: parameters[ipo_type]
          schema:
            type: string
        - description: وقت التحديث بصيغة Unix
          in: query
          name: parameters[updated]
          schema:
            type: string
            format: int64
      responses:
        '200':
          description: الطروحات العامة الأولية
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.IPOResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.IPOResponse'
        '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.IPOResponse:
      description: >-
        استجابة من واجهة برمجة التطبيقات API تتضمن مصفوفة من سجلات الاكتتابات
        العامة الأولية (IPO)
      properties:
        ipos:
          items:
            $ref: '#/components/schemas/calendarapi.IPO'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.IPO:
      properties:
        currency:
          example: USD
          type: string
        cusip:
          example: 38744101
          type: string
        date:
          example: '2024-01-09T00:00:00.000Z'
          type: string
        deal_status:
          example: Priced
          type: string
        description:
          example: Online marketplace for lodging and tourism experiences
          type: string
        exchange:
          example: NASDAQ
          type: string
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5a9
          type: string
        initial_filing_date:
          example: '2023-11-15T00:00:00.000Z'
          type: string
        insider_lockup_date:
          example: '2024-07-07T00:00:00.000Z'
          type: string
        insider_lockup_days:
          example: 180
          type: integer
        ipo_type:
          example: IPO
          type: string
        last_yr_income:
          example: -674000000
          type: integer
        last_yr_income_year:
          example: 2023
          type: integer
        last_yr_revenue:
          example: 4805000000
          type: integer
        last_yr_revenue_year:
          example: 2023
          type: integer
        lead_underwriters:
          example:
            - '[{"name":"Morgan Stanley"}]'
          items:
            type: string
          type: array
        market_cap_at_offer:
          example: 47000000000
          type: integer
        name:
          example: Airbnb Inc.
          type: string
        notes:
          example: Strong first day trading
          type: string
        offering_shares:
          example: 51500000
          type: integer
        offering_shares_ord_adr:
          example: 51500000
          type: integer
        offering_value:
          example: 3500000000
          type: integer
        open_date_verified:
          example: true
          type: boolean
        ord_shares_out_after_offer:
          example: 615000000
          type: integer
        other_underwriters:
          example:
            - '[{"name":"Goldman Sachs"}]'
          items:
            type: string
          type: array
        price_max:
          example: '50.00'
          type: string
        price_min:
          example: '44.00'
          type: string
        price_open:
          example: '146.00'
          type: string
        price_public_offering:
          example: '68.00'
          type: string
        pricing_date:
          example: '2024-01-08T00:00:00.000Z'
          type: string
        pricing_date_verified:
          example: true
          type: boolean
        sec_accession_number:
          example: 0001559720-20-000079
          type: string
        sec_filing_url:
          example: https://www.sec.gov/cgi-bin/browse-edgar
          type: string
        shares_outstanding:
          example: 615000000
          type: integer
        sic:
          example: 7389
          type: integer
        spac_converted_to_target:
          example: false
          type: boolean
        state_location:
          example: Delaware
          type: string
        ticker:
          example: ABNB
          type: string
        time:
          example: '09:30:00'
          type: string
        underwriter_quiet_expiration_date:
          example: '2024-02-03T00:00:00.000Z'
          type: string
        underwriter_quiet_expiration_days:
          example: 25
          type: integer
        updated:
          example: 1704819600
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````