> ## 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}
  {
    "ok": true,
    "data": [
      {
        "fields": {
          "logo_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/KYG7387B1225/logo_dark__fe4a5fc01881264700de033abe9fc151.png?x-bz-cred=...",
          "logo_light": "https://image-util.benzinga.com/api/v2/logos/file/image/KYG7387B1225/logo_light__3f6f778449138931036ca9c624143ff7.png?x-bz-cred=...",
          "mark_vector_composite_light": "https://image-util.benzinga.com/api/v2/logos/file/image/KYG7387B1225/mark_vector_composite_light__1684a8ad97472e1b9fb5b639995e8245.svg?x-bz-cred=..."
        },
        "updated": "2025-12-09T11:36:51.357671Z",
        "created": "2025-12-09T11:36:51.357671Z",
        "securities": [
          {
            "symbol": "QUMSU",
            "name": "QUANTUMSPHERE ACQUISITION CO",
            "cik": "2070900",
            "exchange": "NASDAQ",
            "mic_code": "XNAS",
            "exchange_name": "NASDAQ Global Market Consolidated",
            "cusip": "G7387B122",
            "isin": "KYG7387B1225",
            "country": "US",
            "figi_share_class": "BBG01VBMFN66",
            "figi": "BBG01VBMFLS6",
            "security_type": "Unit"
          }
        ]
      },
      {
        "fields": {
          "logo_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/KYG7387B1068/logo_dark__fe4a5fc01881264700de033abe9fc151.png?x-bz-cred=...",
          "logo_light": "https://image-util.benzinga.com/api/v2/logos/file/image/KYG7387B1068/logo_light__3f6f778449138931036ca9c624143ff7.png?x-bz-cred=...",
          "mark_vector_composite_light": "https://image-util.benzinga.com/api/v2/logos/file/image/KYG7387B1068/mark_vector_composite_light__1684a8ad97472e1b9fb5b639995e8245.svg?x-bz-cred=..."
        },
        "updated": "2025-12-09T11:35:11.711467Z",
        "created": "2025-12-09T11:35:11.711467Z",
        "securities": [
          {
            "symbol": "QUMS",
            "name": "QUANTUMSPHERE ACQUISITION CO",
            "cik": "2070900",
            "exchange": "NASDAQ",
            "mic_code": "XNAS",
            "exchange_name": "NASDAQ Global Market Consolidated",
            "cusip": "G7387B106",
            "isin": "KYG7387B1068",
            "country": "US",
            "figi_share_class": "BBG01WHBTBN4",
            "figi": "BBG01WHBT9P7",
            "security_type": "Common Stock"
          }
        ]
      }
    ]
  }
  ```

  ```json استجابة (400 طلب غير صالح) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "bad_request",
        "id": "invalid_parameter",
        "value": "المعلمة search_keys_type غير صالحة"
      }
    ]
  }
  ```

  ```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/logo-api.spec.yml GET /api/v2.1/logos/sync
openapi: 3.0.0
info:
  contact: {}
  description: >-
    توفّر واجهة برمجة التطبيقات REST هذه نقاط نهاية للبحث عن الشعارات واسترجاع
    تفاصيلها.
  termsOfService: http://swagger.io/terms/
  title: Logo API
  version: 2.1.0
servers:
  - url: https://api.benzinga.com
    description: PROD
security: []
paths:
  /api/v2.1/logos/sync:
    get:
      tags:
        - logos
      summary: مزامنة الشعارات بالجملة
      description: مزامنة الشعارات بالجملة
      operationId: logo-bulk-sync
      parameters:
        - description: >-
            قائمة مفصولة بفواصل لمعرّفات الأوراق المالية أو رموز MIC الخاصة
            بالبورصات (لشعارات البورصات في v2.1). يتوقّف النوع على قيمة معامل
            search_keys_type.
          in: query
          name: search_keys
          required: true
          schema:
            type: string
        - description: >-
            نوع المعرّف المراد البحث عنه. الأنواع المدعومة: symbol (الافتراضي)،
            CIK، CUSIP، رقم التعريف الدولي للأوراق المالية ISIN، exchange (في
            v2.1 فقط)
          in: query
          name: search_keys_type
          schema:
            type: string
        - description: >-
            قائمة بحقول الشعارات المطلوب إرجاعها، مفصولة بفواصل. الحد الأقصى 12
            حقلًا. المتاح: logo_light, logo_dark, logo_vector_light,
            logo_vector_dark, mark_light, mark_dark, mark_vector_light,
            mark_vector_dark, mark_composite_light, mark_composite_dark,
            mark_vector_composite_light, mark_vector_composite_dark, colors
          in: query
          name: fields
          required: true
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
        - description: >-
            رقم الصفحة لأغراض ترقيم الصفحات (pagination). يُستخدم مع pagesize في
            عمليات المزامنة الجماعية (bulk sync).
          in: query
          name: page
          schema:
            type: integer
        - description: 'عدد النتائج لكل صفحة. القيمة الافتراضية: 100. الحد الأقصى: 1000'
          in: query
          name: pagesize
          schema:
            type: integer
        - description: >-
            طابع زمني من نوع Unix ‏(UTC). يُرجِع الشعارات التي تم تحديثها بعد
            هذا الطابع الزمني.
          in: query
          name: updated_since
          schema:
            type: string
        - description: >-
            قم بضبط أبعاد الصورة بصيغة WIDTHxHEIGHT (على سبيل المثال 300x300).
            تُصغَّر الصور فقط ولا تُكبَّر مطلقًا. القيمة الافتراضية: 300x300
          in: query
          name: scale
          schema:
            type: string
        - description: >-
            نصف قطر زوايا الصور المركّبة كنسبة مئوية. النطاق من 0 إلى 50، حيث
            تؤدي القيمة 50 إلى إنشاء دائرة. القيمة الافتراضية: 0
          in: query
          name: composite_radius
          schema:
            type: integer
      responses:
        '200':
          description: استجابة ناجحة تتضمن مصفوفة من كائنات BulkSyncResponse ضمن الحقل data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '400':
          description: طلب غير صالح - معلمات غير صالحة أو مفقودة
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '404':
          description: غير موجود - لم يتم العثور على شعارات تطابق المعايير
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
        '500':
          description: خطأ داخلي في الخادم
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bzhttp.Resp'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    bzhttp.Resp:
      properties:
        data:
          additionalProperties: true
          type: object
        errors:
          items:
            $ref: '#/components/schemas/bzhttp.Error'
          type: array
        ok:
          type: boolean
      type: object
    bzhttp.Error:
      properties:
        code:
          $ref: '#/components/schemas/bzhttp.ErrorCode'
        id:
          type: string
        value:
          type: string
      type: object
    bzhttp.ErrorCode:
      enum:
        - json_unmarshaling_error
        - no_data_found
        - no_matching_endpoint
        - bad_request
        - db_error
        - internal_server_error
        - auth_failed
        - forbidden
        - failed_dependency
        - service_unavailable
        - upstream_api_error
        - unsupported_message_type
        - database_query_error
      type: string
      x-enum-varnames:
        - ErrorJSONUnmarshaling
        - ErrorNoDataFound
        - ErrorNoMatchingEndpoint
        - ErrorBadRequest
        - ErrorDBError
        - ErrorInternalServerError
        - ErrorAuthFailed
        - ErrorForbidden
        - ErrorFailedDependency
        - ErrorServiceUnavailable
        - ErrorUpstreamAPIError
        - ErrorUnsupportedMessageType
        - ErrorDBQueryError
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: token
      type: apiKey

````