---
title: "Retrieve simplified brand data by domain"
method: GET
path: "/brand/retrieve-simplified"
tags: ["Retrieve Brand"]
---

# Retrieve simplified brand data by domain

`GET /brand/retrieve-simplified`

Returns a simplified version of brand data containing only essential information: domain, title, colors, logos, and backdrops. This endpoint is optimized for faster responses and reduced data transfer.

## Query parameters

- `domain` string, required
- `timeoutMS` integer

## Response `200`

Successful response

- object
  - `status` string — Status of the response, e.g., 'ok'
  - `brand` object — Simplified brand information
    - `domain` string — The domain name of the brand
    - `title` string — The title or name of the brand
    - `colors` object[] — An array of brand colors
      - `hex` string — Color in hexadecimal format
      - `name` string — Name of the color
    - `logos` object[] — An array of logos associated with the brand
      - `url` string — CDN hosted url of the logo (ready for display)
      - `mode` 'light' | 'dark' | 'has_opaque_background' — Indicates when this logo is best used: 'light' = best for light mode, 'dark' = best for dark mode, 'has_opaque_background' = can be used for either as image has its own background
      - `colors` object[] — Array of colors in the logo
        - `hex` string — Color in hexadecimal format
        - `name` string — Name of the color
      - `resolution` object — Resolution of the logo image
        - `width` integer — Width of the image in pixels
        - `height` integer — Height of the image in pixels
        - `aspect_ratio` number — Aspect ratio of the image (width/height)
      - `type` 'icon' | 'logo' — Type of the logo based on resolution (e.g., 'icon', 'logo')
    - `backdrops` object[] — An array of backdrop images for the brand
      - `url` string — URL of the backdrop image
      - `colors` object[] — Array of colors in the backdrop image
        - `hex` string — Color in hexadecimal format
        - `name` string — Name of the color
      - `resolution` object — Resolution of the backdrop image
        - `width` integer — Width of the image in pixels
        - `height` integer — Height of the image in pixels
        - `aspect_ratio` number — Aspect ratio of the image (width/height)
  - `code` integer — HTTP status code of the response

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Brand not found.
- `408` — Request Timeout
- `500` — Internal server error

## Changes

- **2026-02-12** `ec0e897d65be` — 1 breaking
  - for the `query` request parameter `timeoutMS`, the min was increased from `1.00` to `1000.00`

[Change history](https://skmtc.dev/context/apis/brand-api/changes/brand/retrieve-simplified/get.md)

---

[API](https://skmtc.dev/context/apis/brand-api.md) · [All operations](https://skmtc.dev/context/apis/brand-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/context/brand-api/revisions/05a30711e18b/schema)