> ## 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}
  {
    "guidance": [
      {
        "currency": "USD",
        "cusip": "00BMCD000",
        "date": "2026-01-05",
        "eps_guidance_est": "",
        "eps_guidance_max": "",
        "eps_guidance_min": "",
        "eps_guidance_prior_max": "",
        "eps_guidance_prior_min": "",
        "eps_type": "",
        "exchange": "NASDAQ",
        "id": "695bcc0c83cac20001becbd4",
        "importance": 1,
        "is_primary": "Y",
        "name": "RedCloud Holdings",
        "notes": "",
        "period": "FY",
        "period_year": 2026,
        "prelim": "Y",
        "revenue_guidance_est": "91170920.000",
        "revenue_guidance_max": "100000000.000",
        "revenue_guidance_min": "100000000.000",
        "revenue_guidance_prior_max": "100000000",
        "revenue_guidance_prior_min": "100000000.000",
        "revenue_type": "GAAP",
        "ticker": "RCT",
        "time": "09:30:00",
        "updated": 1767623735
      }
    ]
  }
  ```

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

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

  ```json استجابة (500 Internal Server Error) 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.1/calendar/guidance
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/guidance:
    get:
      tags:
        - guidance
      summary: يُرجِع بيانات التوجيه
      description: >-
        يُرجِع بيانات توجيه الشركات، بما في ذلك توقعات الأرباح والإيرادات
        المستقبلية المقدَّمة من إدارة الشركة. يتضمن نطاقات توجيه ربحية السهم (حد
        أدنى/حد أقصى)، ونطاقات توجيه الإيرادات، ومقارنات مع التوجيهات السابقة.
        يُعَدّ هذا التوجيه عنصرًا حاسمًا لفهم توقعات الإدارة للأداء المستقبلي.
      operationId: get-guidance
      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: >-
            التاريخ المطلوب الاستعلام عنه للحصول على بيانات التقويم. يُعد
            اختصارًا للحقلين 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: >-
            يحدّد ما إذا كانت الإرشادات المُعادة أساسية أو ثانوية أو جميعها.
            القيمة الافتراضية هي Y
          in: query
          name: parameters[is_primary]
          schema:
            type: string
            enum:
              - 'Y'
              - 'N'
              - All
            default: 'Y'
        - 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.GuidanceResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.GuidanceResponse'
        '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.GuidanceResponse:
      description: استجابة من واجهة برمجة التطبيقات API تتضمن مصفوفة من سجلات التوجيهات
      properties:
        guidance:
          items:
            $ref: '#/components/schemas/calendarapi.Guidance'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.Guidance:
      properties:
        confirmed:
          type: boolean
        currency:
          example: USD
          type: string
        cusip:
          example: 37833100
          type: string
        date:
          example: '2024-01-09T00:00:00.000Z'
          type: string
        eps_guidance_est:
          example: '1.55'
          type: string
        eps_guidance_max:
          example: '1.60'
          type: string
        eps_guidance_min:
          example: '1.50'
          type: string
        eps_guidance_prior_max:
          example: '1.45'
          type: string
        eps_guidance_prior_min:
          example: '1.35'
          type: string
        eps_type:
          example: GAAP
          type: string
        exchange:
          example: NASDAQ
          type: string
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5b1
          type: string
        importance:
          example: 4
          type: integer
        is_primary:
          example: 'true'
          type: string
        name:
          example: Apple Inc.
          type: string
        notes:
          example: Raised guidance above analyst expectations
          type: string
        period:
          example: Q2
          type: string
        period_year:
          example: 2024
          type: integer
        prelim:
          example: 'false'
          type: string
        revenue_guidance_est:
          example: '93000000000'
          type: string
        revenue_guidance_max:
          example: '95000000000'
          type: string
        revenue_guidance_min:
          example: '91000000000'
          type: string
        revenue_guidance_prior_max:
          example: '89000000000'
          type: string
        revenue_guidance_prior_min:
          example: '87000000000'
          type: string
        revenue_type:
          example: GAAP
          type: string
        ticker:
          example: AAPL
          type: string
        time:
          example: '16:05:00'
          type: string
        updated:
          example: 1704819600
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````