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

# Splits de acciones

<ResponseExample>
  ```json Respuesta (200 OK) theme={null}
  {
    "splits": [
      {
        "cusip": "87807D509",
        "date_announced": "2025-12-30",
        "date_distribution": "2025-01-06",
        "date_ex": "2025-01-07",
        "date_recorded": "2025-01-02",
        "exchange": "NASDAQ",
        "id": "677675329a903000017cb6f1",
        "importance": 1,
        "name": "TC BioPharm (Holdings)",
        "notes": "",
        "optionable": false,
        "ratio": "1.25:1",
        "split_type": "ADR Ratio Change",
        "ticker": "TCBP",
        "updated": 1735816783
      }
    ]
  }
  ```

  ```json Respuesta (401 No autorizado) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "auth_failed",
        "id": "unauthorized",
        "value": "Token de autenticación no válido o faltante"
      }
    ]
  }
  ```

  ```json Respuesta (404 No encontrado) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "no_data_found",
        "id": "not_found",
        "value": "No se encontraron datos para los parámetros especificados"
      }
    ]
  }
  ```

  ```json Respuesta (500 Error interno del servidor) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "internal_server_error",
        "id": "server_error",
        "value": "Se produjo un error inesperado al procesar la solicitud"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml es/openapi/calendar-api.spec.yml GET /api/v2.1/calendar/splits
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/splits:
    get:
      tags:
        - splits
      summary: يُرجِع بيانات calendar لتجزئات الأسهم
      description: >-
        تُرجِع بيانات تجزئة الأسهم بما في ذلك نسب التجزئة، تواريخ الإعلان،
        تواريخ الاستحقاق (ex-dates)، وتواريخ التوزيع. تحدث تجزئة الأسهم عندما
        تزيد الشركة أو تُنقِص عدد الأسهم القائمة لضبط سعر السهم. تتضمن البيانات
        معلومات حول ما إذا كان السهم قابلاً لتداول عقود الخيارات أم لا.
      operationId: get-splits
      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: >-
            التاريخ الذي تُستخدم على أساسه تصفية بيانات calendar وفرزها. القيمة
            الافتراضية هي `announced`
          in: query
          name: parameters[date_search_field]
          schema:
            type: string
            enum:
              - announced
              - ex
            default: announced
        - 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.SplitResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.SplitResponse'
        '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.SplitResponse:
      description: >-
        استجابة من واجهة برمجة التطبيقات API تتضمن مصفوفة من سجلات عمليات تجزئة
        الأسهم
      properties:
        splits:
          items:
            $ref: '#/components/schemas/calendarapi.Split'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.Split:
      properties:
        cusip:
          example: 88160R101
          type: string
        date_announced:
          example: '2024-01-09T00:00:00.000Z'
          type: string
        date_distribution:
          example: '2024-02-15T00:00:00.000Z'
          type: string
        date_ex:
          example: '2024-02-14T00:00:00.000Z'
          type: string
        date_recorded:
          example: '2024-02-10T00:00:00.000Z'
          type: string
        exchange:
          example: NASDAQ
          type: string
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5a8
          type: string
        importance:
          example: 4
          type: integer
        name:
          example: Tesla Inc.
          type: string
        notes:
          example: Forward stock split
          type: string
        optionable:
          example: true
          type: boolean
        ratio:
          example: 3-1
          type: string
        split_type:
          example: Split
          type: string
        ticker:
          example: TSLA
          type: string
        updated:
          example: 1704819600
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````