> ## 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. # Sync Logos in bulk > Bulk logos sync ```json Response (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 Response (400 Bad Request) theme={null} { "ok": false, "errors": [ { "code": "bad_request", "id": "invalid_parameter", "value": "Invalid search_keys_type parameter" } ] } ``` ```json Response (401 Unauthorized) theme={null} { "ok": false, "errors": [ { "code": "auth_failed", "id": "unauthorized", "value": "Invalid or missing authentication token" } ] } ``` ```json Response (404 Not Found) theme={null} { "ok": false, "errors": [ { "code": "no_data_found", "id": "not_found", "value": "No logos found for the specified search key" } ] } ``` ```json Response (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" } ] } ``` ## OpenAPI ````yaml /openapi/logo-api_api.spec.yml GET /api/v2.1/logos/sync openapi: 3.0.0 info: contact: {} description: This REST API provides endpoints to search for logos and get logo details. 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: Bulk logos sync description: Bulk logos sync operationId: logo-bulk-sync parameters: - description: >- Comma-separated list of security identifiers or exchange MIC codes (for v2.1 exchange logos). Type depends on search_keys_type parameter. in: query name: search_keys required: true schema: type: string - description: >- Type of identifier being searched. Supported types: symbol (default), cik, cusip, isin, exchange (v2.1 only) in: query name: search_keys_type schema: type: string - description: >- Comma-separated list of logo fields to return. Maximum 12 fields. Available: 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: >- Page number for pagination. Used with pagesize for bulk sync operations. in: query name: page schema: type: integer - description: 'Number of results per page. Default: 100. Maximum: 1000' in: query name: pagesize schema: type: integer - description: Unix timestamp (UTC). Returns logos updated after this timestamp. in: query name: updated_since schema: type: string - description: >- Scale image dimensions in WIDTHxHEIGHT format (e.g., 300x300). Images scale down only, never up. Default: 300x300 in: query name: scale schema: type: string - description: >- Border radius for composite images in percentage. Range 0-50 where 50 creates a circle. Default: 0 in: query name: composite_radius schema: type: integer responses: '200': description: >- Success response with array of BulkSyncResponse objects in data field content: application/json: schema: $ref: '#/components/schemas/bzhttp.Resp' '400': description: Bad request - invalid or missing parameters content: application/json: schema: $ref: '#/components/schemas/bzhttp.Resp' '404': description: Not found - no logos found matching the criteria content: application/json: schema: $ref: '#/components/schemas/bzhttp.Resp' '500': description: Internal server error 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 ````