> ## 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}
  {
    "ratings": [
      {
        "action_company": "Maintains",
        "action_pt": "Lowers",
        "adjusted_pt_current": "260.00",
        "adjusted_pt_prior": "300.00",
        "analyst": "Jefferies",
        "analyst_id": "57fe0358ac6af40001334e62",
        "analyst_name": "Brent Thill",
        "currency": "USD",
        "cusip": "001176213",
        "date": "2026-01-05",
        "exchange": "NASDAQ",
        "id": "695c16678f047b0001fee512",
        "importance": 3,
        "isin": "IL0011762130",
        "name": "Monday.Com",
        "notes": "",
        "pt_current": "260.0000",
        "pt_pct_change": "-13.33",
        "pt_prior": "300.00",
        "rating_current": "Buy",
        "rating_prior": "Buy",
        "ticker": "MNDY",
        "time": "14:52:07",
        "updated": 1767642765,
        "url": "https://www.benzinga.com/quote/MNDY/analyst-ratings",
        "url_calendar": "https://www.benzinga.com/quote/MNDY/analyst-ratings",
        "url_news": "https://www.benzinga.com/stock-articles/MNDY/analyst-ratings"
      }
    ]
  }
  ```

  ```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/ratings
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/ratings:
    get:
      tags:
        - ratings
      summary: يُرجِع بيانات توصيات المحللين
      description: >-
        يُرجِع بيانات تقييمات المحللين، بما في ذلك رفع التصنيف، وخفضه، وبدء
        التغطية، وتغييرات السعر المستهدف من محللي وول ستريت. يتضمن التصنيفات
        الحالية والسابقة، والأسعار المستهدفة، ومعلومات عن المحللين، ومقاييس دقة
        التصنيفات عند توفرها.
      operationId: get-ratings
      parameters:
        - description: >-
            يُحدِّد تنسيق الإرجاع. تعمل معاملات الاستعلام بالطريقة نفسها في كلا
            التنسيقين
          in: header
          name: accept
          required: true
          schema:
            type: string
            enum:
              - application/json
            default: application/json
        - description: >-
            قائمة بالحقول المطلوب إرجاعها مفصولة بفواصل. الحقول المتاحة: id،
            date، time، ticker، exchange، name، currency، action_pt،
            action_company، rating_current، pt_current، rating_prior، pt_prior،
            pt_pct_change، url، url_calendar، url_news، analyst، analyst_id،
            analyst_name، ratings_accuracy، importance، notes، updated. استخدم *
            لإرجاع جميع الحقول بما في ذلك ratings_accuracy
          in: query
          name: fields
          schema:
            type: string
            format: csv
        - 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
        - description: معرّف محلّل واحد أو أكثر (analyst_id) تفصل بينها فواصل
          in: query
          name: parameters[analyst_id]
          schema:
            type: string
            format: csv
        - description: معرّف شركة واحد أو أكثر (firm_id)، مفصولة بفواصل
          in: query
          name: parameters[firm_id]
          schema:
            type: string
            format: csv
        - description: >-
            تصفية النتائج حسب action_company محدد (الإجراء الخاص بالتقييم). لاحظ
            أن جميع هذه المصطلحات محددة بدقة
          in: query
          name: parameters[action]
          schema:
            type: string
            enum:
              - Downgrades
              - Maintains
              - Reinstates
              - Reiterates
              - Upgrades
              - Assumes
              - Initiates Coverage On
              - Terminates Coverage On
              - Removes
              - Suspends
              - Firm Dissolved
        - description: >-
            قائمة من معرّفات المحللين (الأشخاص) مفصولة بفواصل لإرجاعها. إذا تم
            إغفالها سيتم إرجاع جميع المحللين المتاحين
          in: query
          name: analyst
          schema:
            type: string
            format: csv
        - description: >-
            قائمة بمعرّفات شركات المحللين مفصولة بفواصل ليتم إرجاعها. في حال عدم
            تحديدها، سيتم إرجاع جميع الشركات المتاحة
          in: query
          name: firm
          schema:
            type: string
            format: csv
        - description: بسّط التصنيفات إلى فئات معيارية موحّدة
          in: query
          name: simplify
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: نجاح
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.RatingResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/api.RatingResponse'
        '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.RatingResponse:
      description: استجابة من واجهة برمجة التطبيقات API تتضمن مصفوفة من تقييمات المحللين
      properties:
        ratings:
          items:
            $ref: '#/components/schemas/calendarapi.Rating'
          type: array
      type: object
    api.ErrorResponse:
      properties:
        text:
          type: string
      type: object
    calendarapi.Rating:
      properties:
        action_company:
          example: Goldman Sachs
          type: string
        action_pt:
          example: Raises
          type: string
        adjusted_pt_current:
          example: '200.00'
          type: string
        adjusted_pt_prior:
          example: '185.00'
          type: string
        analyst:
          example: Goldman Sachs
          type: string
        analyst_id:
          example: 60a7f5e8e4b0f5a3c8e9f5a6
          type: string
        analyst_name:
          example: John Smith
          type: string
        currency:
          example: USD
          type: string
        cusip:
          example: 37833100
          type: string
        date:
          example: '2024-01-09T00:00:00.000Z'
          type: string
        exchange:
          example: NASDAQ
          type: string
        firm_id:
          example: 60a7f5e8e4b0f5a3c8e9f5a5
          type: string
        id:
          example: 60a7f5e8e4b0f5a3c8e9f5a4
          type: string
        importance:
          example: 3
          type: integer
        isin:
          example: US0378331005
          type: string
        name:
          example: Apple Inc.
          type: string
        notes:
          example: Upgraded due to strong quarterly performance
          type: string
        pt_current:
          example: '200.00'
          type: string
        pt_prior:
          example: '185.00'
          type: string
        rating_current:
          example: Buy
          type: string
        rating_prior:
          example: Neutral
          type: string
        ticker:
          example: AAPL
          type: string
        time:
          example: '09:30:00'
          type: string
        updated:
          example: 1704819600
          type: integer
        url:
          example: https://www.benzinga.com/ratings/123456
          type: string
        url_calendar:
          example: https://www.benzinga.com/calendar/ratings/123456
          type: string
        url_news:
          example: https://www.benzinga.com/news/123456
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````