> ## Documentation Index
> Fetch the complete documentation index at: https://docs.logoo.useora.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Logo by slug

> Returns the logo for a brand or product by its slug

Put the key in `?token=`. Products without their own domain, like `microsoft-word`, live under a slug. A product with no logo of its own returns its parent brand's logo.

![Microsoft Word icon](https://api.logoo.useora.co/by/microsoft-word?size=128)

`GET /by/microsoft-word?size=128`


## OpenAPI

````yaml GET /by/{slug}
openapi: 3.1.0
info:
  title: Logoo API Reference (by Ora)
  description: Logoo API Reference Documentation
  version: 1.0.0
servers:
  - description: Production
    url: https://api.logoo.useora.co
  - description: Local development
    url: http://localhost:8787
security: []
tags:
  - description: Health checks and system status
    name: System
  - description: Serve brand logos by domain or name
    name: Logos
  - description: Search and discover brands
    name: Search
  - description: Company metadata and enrichment
    name: Brand Info
  - description: Authenticated user self-service (profile, subscription, usage)
    name: Me
  - description: Brand asset management (requires API key)
    name: Admin
  - description: Checkout, portal, and webhook endpoints
    name: Billing
paths:
  /by/{slug}:
    get:
      tags:
        - Logos
      summary: Get logo by slug
      description: >-
        Serve a brand or product logo by slug (e.g. `microsoft-word`). Same
        query params as `/:domain`. For products with no logo of their own,
        walks `parentBrandId` to serve the parent's logo unless
        `disableLogoInheritance` is set.
      operationId: getByBySlug
      parameters:
        - in: path
          name: slug
          schema:
            type: string
            pattern: ^[a-z0-9]([a-z0-9.-]{0,62}[a-z0-9])?$
          required: true
        - in: query
          name: apiKey
          schema:
            type: string
        - in: query
          name: fallback
          schema:
            enum:
              - monogram
              - '404'
            type: string
        - in: query
          name: format
          schema:
            enum:
              - png
              - jpg
              - webp
              - avif
              - svg
            type: string
        - in: query
          name: greyscale
          schema:
            enum:
              - 'true'
              - 'false'
            type: string
        - in: query
          name: kind
          schema:
            enum:
              - icon
              - logo
              - logomark
              - wordmark
              - symbol
              - combined
              - banner
            type: string
        - in: query
          name: pad
          schema:
            enum:
              - 'true'
              - 'false'
            type: string
        - in: query
          name: retina
          schema:
            enum:
              - 'true'
              - 'false'
            type: string
        - in: query
          name: size
          schema:
            type: string
        - in: query
          name: style
          schema:
            type: string
            pattern: ^[a-z0-9-]{1,32}$
        - in: query
          name: theme
          schema:
            enum:
              - auto
              - color
              - light
              - dark
            type: string
        - in: query
          name: token
          schema:
            type: string
        - in: query
          name: v
          schema:
            type: string
        - in: query
          name: variant
          schema:
            enum:
              - icon
              - logo
              - symbol
            type: string
      responses:
        '200':
          content:
            image/avif: {}
            image/jpeg: {}
            image/png: {}
            image/svg+xml: {}
            image/webp: {}
          description: Logo image (or monogram fallback)
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          required:
                            - message
                          additionalProperties: false
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
          description: Validation error
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          required:
                            - message
                          additionalProperties: false
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
          description: Unauthorized — missing or invalid API key
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          required:
                            - message
                          additionalProperties: false
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
          description: Resource not found
        '429':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      details:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            message:
                              type: string
                          required:
                            - message
                          additionalProperties: false
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - error
                additionalProperties: false
          description: Too Many Requests — rate limit exceeded
      security:
        - apiKeyQuery: []
        - {}
components:
  securitySchemes:
    apiKeyQuery:
      description: >-
        API key (la_...) passed as `?token=` query param. Use this form for <img
        src="..."> embeds where custom headers aren't possible. `?apiKey=` is
        also accepted as an alias.
      in: query
      name: token
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.