Requests and responses

Logo.dev serves brand assets from two hosts. Each host takes its own key and is billed on its own meter.

	Logo CDN	Logo API
Base URL	`https://img.logo.dev`	`https://api.logo.dev`
Returns	A logo image	JSON
Key	Publishable key (`pk_`) in the `token` query parameter	Secret key (`sk_`) in the `Authorization` header
Where to call it	Anywhere, including the browser	Your server only
Billing	Monthly logo requests	Credits

See API keys for where each key goes, domain restrictions, and rotation. Two services have their own host. The Transaction Enrichment API beta is at https://www.logo.dev/api/transaction and takes its own beta key. The MCP server is at https://mcp.logo.dev/mcp and signs you in with OAuth. The rest of this page covers api.logo.dev.

The response envelope

Every Logo API response that has a body and is not an error has the same two fields. A successful delete returns 204 with no body. data holds the result, and metadata describes the request. The response looks like:

{
  "data": { "object": "brand", "id": "brand_4x0wr3g0000g00400000000004", "...": "..." },
  "metadata": {
    "request_id": "request_01k6z8m2a4b5c6d7e8f9g0h1j2",
    "resolution": { "type": "domain", "value": "stripe.com", "method": "direct", "context": {} }
  }
}

Field	Present on	Meaning
`data`	Every response with a body	The brand, image, search results, subscription, or webhook endpoint. Every object has an `object` field that names its type.
`metadata.request_id`	Every response with a body	The request’s id. It matches the `Request-Id` header.
`metadata.resolution`	Brand and image lookups	The identifier you sent, its normalized value, and how it reached the brand. See resolution.
`metadata.pending`	`202` responses	When to retry a lookup that is still indexing. See still indexing.
`metadata.subscription`	Brand lookups from an account with webhooks on	What the automatic subscribe did. `status` is `subscribed`, or `quota_exceeded` when your account is at its subscription limit and this brand was not subscribed. `message` explains a `quota_exceeded`. See subscriptions.

A failed request returns an error object instead of the envelope. See errors for every code.

Response headers

Header	Returned on	Meaning
`Request-Id`	Every response	The request’s id. Include it when you contact support.
`Credits-Charged`	Brand, image, and search requests	`1` when this request spent credits, `0` when it was free under the billing rules. It is not the amount. Use `Credits-Remaining` to track your balance.
`Credits-Remaining`	Brand, image, and search requests, when the balance is known	Your credit balance after this request. Absent means unknown, not zero.
`RateLimit-Limit`	Brand, image, and search requests	Requests allowed in the current window
`RateLimit-Remaining`	Brand, image, and search requests	Requests left in the current window
`RateLimit-Reset`	Brand, image, and search requests	Seconds until the window resets
`Retry-After`	`202` responses	Seconds to wait before you retry

See rate limits for how limits and credits work.

Conventions

Timestamps are RFC 3339, in UTC.
Ids have a prefix that names what they point to: brand_ for a brand, sub_ for a subscription, evt_ for a webhook event, ep_ for a webhook endpoint, and request_ for a request. Treat every id as opaque.
Store brand ids, not domains. A brand keeps its id when its domain changes.
Field names are snake_case. A field with no value is null, maps omit absent keys, and an empty list is [].

Versioning

The Logo API version is in the path. Every route in this reference is under /v2. New fields and new routes can arrive inside /v2. A breaking change ships under a new prefix. The Logo CDN is not versioned. The v1 routes keep working. v1 search spends credits like v2 search, so it can return 402. See the changelog. Their v2 replacements differ in these ways:

Responses are wrapped in data and metadata, and errors use the error object.
GET /v2/brands replaces GET /brand/{domain} and GET /describe/{domain}. It also accepts a ticker, an ISIN, a crypto symbol, or a name.
Images are objects with a temporary download url, dimensions, format, and blurhash. They are not bare URLs.
Colors include OKLCH values next to RGB and hex.
GET /v2/search takes method (match or typeahead) instead of strategy, and adds limit.

Every Logo API route also has a tool on the MCP server.

Get started

CDN

API

Platform

Switch to Logo.dev

Integrations

Get your logo seen

Comparisons

Support

Requests and responses

The response envelope

Response headers

Conventions

Versioning

​The response envelope

​Response headers

​Conventions

​Versioning

The response envelope

Response headers

Conventions

Versioning