---
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
      - `source` 'site' | 'logo' — Where the color was observed: 'site' colors come from the website's own theme signals (rendered page colors, manifest, theme-color meta), 'logo' colors from logo image pixels.
    - `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
  - `cache_metadata` CacheMetadata, required — Cache outcome for this response. Composite responses are hits only when every cache-controlled fetch contributing to the output was a hit; age_ms is the oldest contributing hit.
    - `status` 'hit' | 'miss' | 'zdr', required — Whether the response was served from cache, required fresh work, or honored zero-data-retention cache bypass.
    - `age_ms` integer, required — Age of the cached data in milliseconds. Zero for miss and zdr responses.
  - `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

## Changes

> 26 revisions in range; 19 could not be searched.

- **2026-07-31** `f5c503b03f98` — 4 warning
  - added the new `BATCH_LIMIT_EXCEEDED` enum value to the `error_code` response property for the response status `404`
  - added the new `BATCH_NOT_CANCELLABLE` enum value to the `error_code` response property for the response status `404`
  - added the new `BATCH_NOT_COMPLETED` enum value to the `error_code` response property for the response status `404`
  - added the new `IDEMPOTENCY_KEY_CONFLICT` enum value to the `error_code` response property for the response status `404`
- **2026-07-26** `35f1d8d4ea26` — 2 warning
  - added the new `MONITOR_NO_WEBHOOK` enum value to the `error_code` response property for the response status `404`
  - added the new `PAID_PLAN_REQUIRED` enum value to the `error_code` response property for the response status `404`
- **2026-07-21** `3764d9c86493` — 1 breaking, 9 warning, 2 info
  - for the `query` request parameter `domain`, the minLength was increased from `0` to `3`
  - added the new `COLLECTION_PAUSED` enum value to the `error_code` response property for the response status `404`
  - added the new `DISPOSABLE_EMAIL_DETECTED` enum value to the `error_code` response property for the response status `404`
  - added the new `FREE_EMAIL_DETECTED` enum value to the `error_code` response property for the response status `404`
  - …8 more

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

---

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