---
title: "Prefetch brand data"
method: POST
path: "/utility/prefetch"
tags: ["Utility"]
---

# Prefetch brand data

`POST /utility/prefetch`

Signal that you may fetch brand data soon to improve latency. The type field selects what to prefetch (currently only 'brand') and identifier carries exactly one lookup key: a domain, or an email whose domain is extracted and validated (free email providers and disposable email addresses are not allowed).

## Request body

- object
  - `type` 'brand', required — What to prefetch. Currently only 'brand' is supported.
  - `identifier` union, required — Identifier of the brand to prefetch. Provide exactly one of domain or email.
    - UtilityPrefetchDomainIdentifier — Prefetch brand data by domain.
      - `domain` string, required — Domain name to prefetch brand data for
    - UtilityPrefetchEmailIdentifier — Prefetch brand data by email. The domain will be extracted and validated.
      - `email` string, email, required — Email address to prefetch brand data for. The domain will be extracted from the email. Free email providers (gmail.com, yahoo.com, etc.) and disposable email addresses are not allowed.
  - `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).
  - `tags` string[] — Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

## Response `200`

Successful response

- object
  - `status` string — Status of the response, e.g., 'ok'
  - `message` string — Success message
  - `type` 'brand' — The type of prefetch that was queued, echoed from the request (currently always 'brand')
  - `domain` string — The domain that was queued for prefetching
  - `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 - validation error
- `401` — Unauthorized
- `403` — Forbidden - Paid subscription required
- `408` — Request Timeout
- `422` — Unprocessable Entity - Free email or disposable email detected
- `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)