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

# Search Logos

> Search Logos

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "ok": true,
    "data": [
      {
        "id": "efc3943a-ddac-4f59-a2cc-47a67583068b",
        "search_key": "TSLA",
        "created_at": "2022-05-18T05:19:45.008547Z",
        "updated_at": "2025-02-05T09:43:14.303261Z",
        "colors": {
          "background_light": "#FFFFFF",
          "background_dark": "#000000"
        },
        "files": {
          "logo_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_light.png?x-bz-cred=...",
          "logo_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_dark.png?x-bz-cred=...",
          "logo_vector_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_vector_light.svg?x-bz-cred=...",
          "logo_vector_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/logo_vector_dark.svg?x-bz-cred=...",
          "mark_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_light.png?x-bz-cred=...",
          "mark_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_dark.png?x-bz-cred=...",
          "mark_composite_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_composite_light.png?x-bz-cred=...",
          "mark_composite_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_composite_dark.png?x-bz-cred=...",
          "mark_vector_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_vector_light.svg?x-bz-cred=...",
          "mark_vector_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_vector_dark.svg?x-bz-cred=...",
          "mark_vector_composite_light": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_vector_composite_light.svg?x-bz-cred=...",
          "mark_vector_composite_dark": "https://image-util.benzinga.com/api/v2/logos/file/image/1318605/mark_vector_composite_dark.svg?x-bz-cred=..."
        },
        "securities": [
          {
            "symbol": "TSLA",
            "name": "TESLA INC",
            "cik": "1318605",
            "exchange": "NASDAQ",
            "mic_code": "XNAS",
            "exchange_name": "NASDAQ Global Select Consolidated",
            "cusip": "88160R101",
            "isin": "US88160R1014",
            "country": "US",
            "figi_share_class": "BBG001SQKGD7",
            "figi": "BBG000N9MNX3",
            "security_type": "Common Stock"
          },
          {
            "symbol": "TL0",
            "name": "TESLA INC",
            "cik": "1318605",
            "exchange": "MUN",
            "mic_code": "XMUN",
            "exchange_name": "Munich Stock Exchange",
            "cusip": "88160R101",
            "isin": "US88160R1014",
            "country": "DE",
            "figi_share_class": "BBG001SQKGD7",
            "figi": "BBG000WGWVP7",
            "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"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml /openapi/logo-api_api.spec.yml GET /api/v2/logos/search
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/logos/search:
    get:
      tags:
        - logos
      summary: Search Logos
      description: Search Logos
      operationId: get-search-logos
      parameters:
        - description: >-
            Comma-separated list of security identifiers. Maximum 100
            identifiers. 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
          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
          schema:
            type: string
        - description: >-
            If true and no logo exists, generates a composite image based on
            company name and brand colors
          in: query
          name: composite_auto
          schema:
            type: boolean
        - 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
        - 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: Maximum width constraint for scaled images in pixels
          in: query
          name: max_width
          schema:
            type: string
        - description: >-
            If true, adds flutter_compatible=true query parameter to SVG URLs
            for flutter_svg library compatibility
          in: query
          name: flutter_compatible
          schema:
            type: boolean
      responses:
        '200':
          description: >-
            Success response with array of LogoClientResponse 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 for the specified search keys
          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

````