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

# 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. Optimized for faster responses and reduced data transfer.

## Query parameters

- `domain` string, required — Domain name to retrieve simplified brand data for
- `maxAgeMs` integer, nullable — Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms) are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1 year.
- `timeoutMS` integer — Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).
- `theme` 'light' | 'dark' — Optional theme preference used when selecting brand assets.
- `tags` string[] — Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

## Response `200`

Successful response

- SimplifiedBrandResponse
  - `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
  - `key_metadata` KeyMetadata — Metadata about the API key used for the request. Included in every response whenever a valid API key is provided, even when the response status is not 200.
    - `credits_consumed` integer, required — The number of credits consumed by this request.
    - `credits_remaining` integer, required — The number of credits remaining for your organization after this request.

## Other responses

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

---

[API](https://skmtc.net/context/apis/context-dev.md) · [All operations](https://skmtc.net/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/context/context-dev/versions/182f532c2552/schema)