Your dashboard has a publishable key for the Logo.dev CDN and a secret key for the Logo.dev API. Every plan includes both.
Authorizations
Authorization
string
header
required
Your secret key (sk_), as Bearer sk_.... Call the Logo.dev API only from your server.
Path Parameters
id
string
required
A brand id, as returned in data.id.
Example:
"brand_4x0wr3g0000g00400000000004"
Query Parameters
nosubscribe
enum<string>
Send true to skip the automatic subscription to this brand. Only matters when webhooks are enabled on your account.
Available options:
true
Response
The brand is ready.
data
object
required
Hide child attributes
data.object
string
required
Allowed value: "brand"
data.id
string
required
The brand's id. Stable across domain changes; use it to key your records.
Example:
"brand_4x0wr3g0000g00400000000004"
data.slug
string
required
Readable label for display. It can change and is not accepted for lookups; use id.
data.domain
string | null
required
The brand's own domain, which can differ from the one you sent. null for brands with no website, such as some crypto tokens.
data.status
string
required
Allowed value: "ready"
data.name
string
required
data.description
string | null
required
data.indexed_at
string<date-time>
required
When the record was last refreshed.
data.is_profane
boolean
required
true when the brand may carry NSFW imagery.
data.socials
object
required
Profile URLs keyed by network. Networks with no profile are omitted.
Hide child attributes
data.socials.{key}
string<uri>
data.colors
object[]
required
Brand colors, most dominant first.
Hide child attributes
data.colors.r
integer
required
Required range: 0 <= x <= 255
data.colors.g
integer
required
Required range: 0 <= x <= 255
data.colors.b
integer
required
Required range: 0 <= x <= 255
data.colors.hex
string
required
Example:
"#635bff"
data.colors.oklch
object
required
Hide child attributes
data.colors.oklch.l
number
required
Lightness, 0 to 1.
data.colors.oklch.c
number
required
Chroma. Usually below 0.4.
data.colors.oklch.h
number
required
Hue in degrees, 0 to 360. 0 when chroma is 0.
data.logo
object | null
required
The primary logo. null when the brand has none.
Hide child attributes
data.logo.url
string<uri>
required
Temporary signed download URL. It stops working at expires_at: download and host the image yourself. Add size, format (png, jpg, webp), or theme (light, dark) to format the download. Downloads do not count toward CDN image usage.
data.logo.etag
string
required
Identifies this version of the source image, and is the same on every route. Save it and download again only when it changes.
data.logo.blurhash
string
required
Compact blurred placeholder for the image.
data.logo.source
object
required
The source file behind the image.
Hide child attributes
data.logo.source.width
integer
required
data.logo.source.height
integer
required
data.logo.source.has_transparency
boolean
required
data.logo.source.is_vector
boolean
required
data.logo.source.format
enum<string>
Omitted when the format is not recognized.
Available options:
png,
jpg,
svg,
webp,
gif,
ico,
avif
data.logo.last_updated_at
string<date-time> | null
required
When the image last changed. null if it has not changed since the brand was indexed.
data.logo.expires_at
string<date-time>
required
When url stops working, about 24 hours after the request.
data.brandmark
object | null
required
The wide logo lockup: the symbol and wordmark together for most brands, or the wordmark alone for pure-type brands. null when the brand has none. See brandmark.
Hide child attributes
data.brandmark.url
string<uri>
required
Temporary signed download URL. It stops working at expires_at: download and host the image yourself. Add size, format (png, jpg, webp), or theme (light, dark) to format the download. Downloads do not count toward CDN image usage.
data.brandmark.etag
string
required
Identifies this version of the source image, and is the same on every route. Save it and download again only when it changes.
data.brandmark.blurhash
string
required
Compact blurred placeholder for the image.
data.brandmark.source
object
required
The source file behind the image.
Hide child attributes
data.brandmark.source.width
integer
required
data.brandmark.source.height
integer
required
data.brandmark.source.has_transparency
boolean
required
data.brandmark.source.is_vector
boolean
required
data.brandmark.source.format
enum<string>
Omitted when the format is not recognized.
Available options:
png,
jpg,
svg,
webp,
gif,
ico,
avif
data.brandmark.last_updated_at
string<date-time> | null
required
When the image last changed. null if it has not changed since the brand was indexed.
data.brandmark.expires_at
string<date-time>
required
When url stops working, about 24 hours after the request.
data.social_banners
object[]
required
Banner images. Empty when there are none.
Hide child attributes
data.social_banners.url
string<uri>
required
Temporary signed download URL. It stops working at expires_at: download and host the image yourself. Add size, format (png, jpg, webp), or theme (light, dark) to format the download. Downloads do not count toward CDN image usage.
data.social_banners.etag
string
required
Identifies this version of the source image, and is the same on every route. Save it and download again only when it changes.
data.social_banners.blurhash
string
required
Compact blurred placeholder for the image.
data.social_banners.source
object
required
The source file behind the image.
Hide child attributes
data.social_banners.source.width
integer
required
data.social_banners.source.height
integer
required
data.social_banners.source.has_transparency
boolean
required
data.social_banners.source.is_vector
boolean
required
data.social_banners.source.format
enum<string>
Omitted when the format is not recognized.
Available options:
png,
jpg,
svg,
webp,
gif,
ico,
avif
data.social_banners.last_updated_at
string<date-time> | null
required
When the image last changed. null if it has not changed since the brand was indexed.
data.social_banners.expires_at
string<date-time>
required
When url stops working, about 24 hours after the request.
metadata
object
required
Hide child attributes
metadata.request_id
string
required
Unique id for this request. Also sent as the Request-Id header.
Example:
"request_01k6z8m2a4b5c6d7e8f9g0h1j2"
metadata.resolution
object
Brand and image lookups only.
Hide child attributes
metadata.resolution.type
enum<string>
required
Which identifier the request used.
Available options:
domain,
ticker,
isin,
crypto,
name,
brand_id
metadata.resolution.value
string
required
The identifier after normalization: the registrable domain, an upper-cased ticker, and so on.
metadata.resolution.method
enum<string>
required
How the identifier reached the brand. direct is a brand id or a domain that is its own brand; domain went through an alias or redirect; security is a ticker or ISIN; crypto is a crypto token symbol; search is a name lookup. Empty on a cached miss.
Available options:
direct,
domain,
security,
crypto,
search,
metadata.resolution.context
object
required
Reserved for brands involved in a merchant lookup. Always {} today.
metadata.pending
object
202 responses only.
Hide child attributes
metadata.pending.reason
enum<string>
required
indexing is a brand's first crawl; resolving means the identifier is still being matched to a brand.
Available options:
indexing,
resolving
metadata.pending.message
string
required
metadata.pending.retry_after_seconds
integer
required
Wait this long before retrying. Matches the Retry-After header.
Example:
30
metadata.pending.expires_in_seconds
integer
required
Stop polling after this long.
Example:
300
metadata.pending.webhook
boolean
required
Whether a brand.indexed webhook event carrying this request's request_id will be sent when the lookup settles.
metadata.pending.doc_url
string<uri>
required
metadata.subscription
object
Present when a brand lookup (GET /v2/brands or GET /v2/brands/{id}) ran the automatic subscribe: webhooks are on for the account, and nosubscribe is not true. See automatic subscriptions.
Hide child attributes
metadata.subscription.status
enum<string>
required
subscribed: the account is subscribed to the brand. quota_exceeded: the account is at its plan's subscription limit, so the brand was not subscribed. The lookup is answered and billed either way.
Available options:
subscribed,
quota_exceeded
metadata.subscription.message
string
Why the subscribe was refused. Only with quota_exceeded.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Logo.dev","colors":{"primary":"#212121","light":"#FFFFFF","dark":"#333333"},"logo":{"light":"https://mintcdn.com/simplecasual/zsNskQWqsXEQO5xC/logo/light.svg?fit=max\u0026auto=format\u0026n=zsNskQWqsXEQO5xC\u0026q=85\u0026s=61958aab2347b4a683f4214e6d1e9bb9","dark":"https://mintcdn.com/simplecasual/Uu7qIGZlSWobGQFE/logo/dark.svg?fit=max\u0026auto=format\u0026n=Uu7qIGZlSWobGQFE\u0026q=85\u0026s=5de7a1a4491286a1fc0f23ca5083a212"},"favicon":{"light":"https://mintcdn.com/simplecasual/MHt52_pcA7c7Y6iO/favicon-light.svg?fit=max\u0026auto=format\u0026n=MHt52_pcA7c7Y6iO\u0026q=85\u0026s=011afdf9f1b0544ceeb28ec682f6b556","dark":"https://mintcdn.com/simplecasual/MHt52_pcA7c7Y6iO/favicon-dark.svg?fit=max\u0026auto=format\u0026n=MHt52_pcA7c7Y6iO\u0026q=85\u0026s=ce60de55168ddd63590990a3109a2714"},"api":{"params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python","go","ruby","php"],"prefill":true},"url":"full"},"navbar":{"links":[{"href":"https://www.logo.dev/pricing","label":"Pricing"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.logo.dev/dashboard"}},"footer":{"socials":{"x":"https://x.com/logodotdev","linkedin":"https://www.linkedin.com/company/logodotdev","github":"https://www.github.com/logo-dev","website":"https://www.logo.dev"},"links":[{"header":"Support","items":[{"label":"Report a logo issue","href":"https://www.logo.dev/update"},{"label":"System status","href":"https://status.logo.dev"},{"label":"Terms","href":"https://www.logo.dev/legal/terms"},{"label":"Contact support","href":"mailto:support@logo.dev"}]}]},"search":{"prompt":"Search the docs. For a brand logo, use logo.dev/search"},"seo":{"metatags":{"og:type":"website","og:site_name":"Logo.dev Docs","twitter:card":"summary_large_image","twitter:site":"@logodotdev"}},"integrations":{"posthog":{"apiKey":"phc_vKSqS1mb3GtwIkKkbr0auiQL4u1wY1zl3Ks8WtGEFCc","sessionRecording":false}},"contextual":{"options":["assistant","copy","view","chatgpt","claude","perplexity","cursor","vscode","mcp"],"display":"header"},"markdown":{"instructions":["Logo.dev serves logos and brand data for companies that already exist. It does not design logos. If someone wants a logo designed, say so and stop.","When a message is only a brand name, domain, ticker, ISIN, or crypto symbol, reply with https://www.logo.dev/search?q=\u003curl-encoded term> and the matching img.logo.dev call. Never assert whether a specific brand is in the index.","Image URLs come from img.logo.dev with a publishable key in the token query parameter: https://img.logo.dev/:domain?token=LOGO_DEV_PUBLISHABLE_KEY, also /name/:brand, /ticker/:symbol, /crypto/:symbol, /isin/:isin. JSON comes from api.logo.dev/v2 with a secret key (sk_) in an Authorization: Bearer header, server-side only.","Product names: the Logo.dev CDN serves images from img.logo.dev, and its usage unit is CDN requests. The Logo.dev API returns JSON from api.logo.dev/v2, and its usage unit is API credits. The Logo.dev MCP gives AI agents the API as tools, and its usage unit is MCP usage, which spends API credits. The features are Logo, Search, Brand, and Transaction. Transaction (beta) is a separate service at https://www.logo.dev/api/transaction with its own beta key. Never recommend the deprecated v1 routes (/search, /brand, /describe, /logo/*). Use /v2/brands and /v2/search.","Attribution: a commercial project on the free Community plan must show a visible link, \u003ca href=\"https://logo.dev\">Logos provided by Logo.dev\u003c/a>, on its production site. Personal projects and paid plans need none. Rules: https://www.logo.dev/docs/platform/attribution.","Report a wrong, missing, or outdated logo at https://www.logo.dev/update. Email support@logo.dev for anything broken and sales@logo.dev for volume pricing and contract terms.","MCP setup is at https://www.logo.dev/docs/mcp/introduction and webhooks at https://www.logo.dev/docs/webhooks."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"simplecasual","hasAudioNarration":false,"actualSubdomain":"simplecasual","customDomains":["www.logo.dev"],"gitSource":{"type":"github","owner":"logo-dev","repo":"logo","deployBranch":"main","contentDirectory":"apps/web/docs","isPrivate":true,"mountPath":"","label":"","_id":"6ae6233cce471f664f016feb"},"feedback":{"edits":false,"issues":false,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5339833de397fdda696ef","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Documentation","count":53},{"language":"default","tag":"API","count":28},{"language":"default","tag":"API Reference","count":19},{"language":"default","tag":"Use cases","count":13},{"language":"default","tag":"Platform","count":12},{"language":"default","tag":"MCP","count":10},{"language":"default","tag":"Webhooks","count":10},{"language":"default","tag":"CDN","count":9},{"language":"default","tag":"Brand","count":8},{"language":"default","tag":"Integrations","count":8}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"deflection":{"enabled":true,"email":"support@logo.dev","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6af50212f018ab3ae8cfe1dc","deploymentId":"65ff2d3ac6e196e6136bd874","questionText":"What are the rate limits on my plan?","status":"active","generatedBy":"manual","createdAt":"2026-11-12T00:02:26.196Z","updatedAt":"2026-11-12T00:02:26.196Z","__v":0},{"_id":"6af50206f018ab3ae8cfe0ee","deploymentId":"65ff2d3ac6e196e6136bd874","questionText":"How do I get a logo for a company?","status":"active","generatedBy":"manual","createdAt":"2026-11-12T00:02:14.466Z","updatedAt":"2026-11-12T00:02:14.466Z","__v":0},{"_id":"6af50201f018ab3ae8cfe08e","deploymentId":"65ff2d3ac6e196e6136bd874","questionText":"How do I fix a logo that is missing or wrong?","status":"active","generatedBy":"manual","createdAt":"2026-11-12T00:02:09.438Z","updatedAt":"2026-11-12T00:02:09.438Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html:not(.dark) #banner a{color:#ffffff!important;text-decoration:none}#banner a{text-decoration:none}.nav-tag-pill:has([data-nav-tag$=\" credits\"]),.nav-tag-pill:has([data-nav-tag$=\" credit\"]),.nav-tag-pill:has([data-nav-tag*=\" credit / \"]),.nav-tag-pill:has([data-nav-tag=\"Pro or Enterprise\"]){display:none}.credits-pill{display:inline-flex;align-items:center;gap:0.5rem;margin-top:1rem;padding:0.375rem 0.75rem;border:1px solid #fde68a;border-radius:0.5rem;background:#fefce8;color:#713f12;font-size:0.875rem;font-weight:600;line-height:1.25rem;text-decoration:none}.credits-pill:hover{border-color:#fcd34d;background:#fef9c3}.credits-pill svg{width:1rem;height:1rem;flex-shrink:0}html.dark .credits-pill{border-color:rgba(161, 98, 7, 0.6);background:rgba(113, 63, 18, 0.25);color:#fef08a}html.dark .credits-pill:hover{background:rgba(113, 63, 18, 0.4)}"}],"page":{"pagePath":"api-reference/brands/get-a-brand-by-id","slug":"/api-reference/brands/get-a-brand-by-id","pageMetadata":{"title":"Get a brand by id","description":"Fetch a brand's profile by its stable brand id.","deprecated":null,"version":null,"tag":"5 credits","openapi":"/openapi.json get /v2/brands/{id}","href":"/api-reference/brands/get-a-brand-by-id","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Fetch a brand’s profile by its stable brand id.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components},{Card}=_components;if(!Card)_missingMdxReference(`Card`,true);return _jsx(Card,{title:`Get your API keys`,icon:`key`,href:`https://www.logo.dev/dashboard/api-keys`,horizontal:true,arrow:true,children:_jsx(_components.p,{children:`Your dashboard has a publishable key for the Logo.dev CDN and a secret key for the Logo.dev API. Every plan includes both.`})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a brand by id","description":"Fetch a brand's profile by its stable brand id.","deprecated":null,"version":null,"tag":"5 credits","openapi":"/openapi.json get /v2/brands/{id}","href":"/api-reference/brands/get-a-brand-by-id","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/simplecasual/1d10373eb07f4b13/credits-pill.js"],"openApiReferenceData":{"operation":{"tags":["Brands"],"summary":"Get a brand by id","description":"Fetch a brand's profile by its stable brand id.","operationId":"v2GetBrandById","x-mint":{"metadata":{"description":"Fetch a brand's profile by its stable brand id.","tag":"5 credits"},"content":"\u003cCard title=\"Get your API keys\" icon=\"key\" href=\"https://www.logo.dev/dashboard/api-keys\" horizontal arrow>\n Your dashboard has a publishable key for the Logo.dev CDN and a secret key for the Logo.dev API. Every plan includes both.\n\u003c/Card>"},"security":["d50840da-83df-4a54-a3ec-b47f44a10772"],"parameters":["6a87d73f-543d-4293-940f-c088c4f28ec6","d60eb06a-e72f-4513-a101-906fe0147b35"],"responses":{"200":"6ab0d424-58c9-464d-8f17-eadddaa463f2","202":"f3fedec0-03bc-4153-9694-cf014859d244","400":"88d25dde-a262-4220-b0db-e409293e153d","401":"d1c40757-2ffc-4600-83bd-3ad7432234d8","402":"3d00fe74-d60d-4e4a-8493-d37e49fd6e86","403":"706823f2-6028-4da9-9413-e65c881e353d","404":"2129c5aa-32db-439e-ad2c-07c17fe115b4","429":"f45868f6-dfbd-4faa-a87e-349d53d03a0c","500":"a75ea841-960e-4602-9123-32fec44fa362"},"method":"get","type":"path","servers":["fc356b30-93a5-48a5-83b2-bf6accbdb614"],"path":"/v2/brands/{id}","baseUrlOptions":["https://api.logo.dev"],"title":"Get a brand by id","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","go","ruby","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"6a87d73f-543d-4293-940f-c088c4f28ec6":{"name":"id","in":"path","required":true,"description":"A brand id, as returned in `data.id`.","schema":{"type":"string","examples":["brand_4x0wr3g0000g00400000000004"],"isRequired":true,"description":"A brand id, as returned in `data.id`.","uniqueKey":"","typeLabel":"string"}},"d60eb06a-e72f-4513-a101-906fe0147b35":{"name":"nosubscribe","in":"query","required":false,"description":"Send `true` to skip the automatic subscription to this brand. Only matters when webhooks are enabled on your account.","schema":{"type":"string","enum":["true"],"isRequired":false,"description":"Send `true` to skip the automatic subscription to this brand. Only matters when webhooks are enabled on your account.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"6ab0d424-58c9-464d-8f17-eadddaa463f2":{"description":"The brand is ready.","headers":{"Request-Id":{"description":"Unique id for this request. Include it when you contact support.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Brand requests allowed per minute for your account.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Brand requests left in the current minute.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Credits-Charged":{"description":"`1` when this request was billed, `0` when it was not.","schema":{"type":"integer","enum":[0,1]}},"Credits-Remaining":{"description":"Your remaining API credit balance. Omitted when no balance is available.","schema":{"type":"string","examples":["18966.99"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"object":{"type":"string","const":"brand","isRequired":true,"uniqueKey":"data.object","typeLabel":"string"},"id":{"type":"string","description":"The brand's id. Stable across domain changes; use it to key your records.","examples":["brand_4x0wr3g0000g00400000000004"],"isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"slug":{"type":"string","description":"Readable label for display. It can change and is not accepted for lookups; use `id`.","isRequired":true,"uniqueKey":"data.slug","typeLabel":"string"},"domain":{"oneOf":[{"type":"string","description":"The brand's own domain, which can differ from the one you sent. `null` for brands with no website, such as some crypto tokens.","isRequired":true,"uniqueKey":"data.domain.oneOf.0","typeLabel":"string"},{"type":"null","description":"The brand's own domain, which can differ from the one you sent. `null` for brands with no website, such as some crypto tokens.","isRequired":true,"uniqueKey":"data.domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.domain","typeLabel":"string | null"},"status":{"type":"string","const":"ready","isRequired":true,"uniqueKey":"data.status","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.description","typeLabel":"string | null"},"indexed_at":{"type":"string","format":"date-time","description":"When the record was last refreshed.","isRequired":true,"uniqueKey":"data.indexed_at","typeLabel":"string\u003cdate-time>"},"is_profane":{"type":"boolean","description":"`true` when the brand may carry NSFW imagery.","isRequired":true,"uniqueKey":"data.is_profane","typeLabel":"boolean"},"socials":{"type":"object","description":"Profile URLs keyed by network. Networks with no profile are omitted.","propertyNames":{"enum":["facebook","github","instagram","linkedin","pinterest","reddit","snapchat","telegram","tumblr","twitter","wechat","whatsapp","wikipedia","youtube"]},"additionalProperties":{"type":"string","format":"uri","uniqueKey":"data.socials.additionalProperties","typeLabel":"string\u003curi>"},"isRequired":true,"uniqueKey":"data.socials","typeLabel":"object"},"colors":{"type":"array","items":{"type":"object","properties":{"r":{"type":"integer","minimum":0,"maximum":255,"isRequired":true,"uniqueKey":"data.colors.items.[INDEX].r","typeLabel":"integer"},"g":{"type":"integer","minimum":0,"maximum":255,"isRequired":true,"uniqueKey":"data.colors.items.[INDEX].g","typeLabel":"integer"},"b":{"type":"integer","minimum":0,"maximum":255,"isRequired":true,"uniqueKey":"data.colors.items.[INDEX].b","typeLabel":"integer"},"hex":{"type":"string","examples":["#635bff"],"isRequired":true,"uniqueKey":"data.colors.items.[INDEX].hex","typeLabel":"string"},"oklch":{"type":"object","properties":{"l":{"type":"number","description":"Lightness, 0 to 1.","isRequired":true,"uniqueKey":"data.colors.items.[INDEX].oklch.l","typeLabel":"number"},"c":{"type":"number","description":"Chroma. Usually below 0.4.","isRequired":true,"uniqueKey":"data.colors.items.[INDEX].oklch.c","typeLabel":"number"},"h":{"type":"number","description":"Hue in degrees, 0 to 360. `0` when chroma is 0.","isRequired":true,"uniqueKey":"data.colors.items.[INDEX].oklch.h","typeLabel":"number"}},"required":["l","c","h"],"isRequired":true,"uniqueKey":"data.colors.items.[INDEX].oklch","typeLabel":"object"}},"required":["r","g","b","hex","oklch"],"uniqueKey":"data.colors.items.[INDEX]","typeLabel":"object"},"description":"Brand colors, most dominant first.","isRequired":true,"uniqueKey":"data.colors","typeLabel":"object[]"},"logo":{"oneOf":[{"type":"object","description":"The primary logo. `null` when the brand has none.","required":["url","etag","blurhash","source","last_updated_at","expires_at"],"properties":{"url":{"type":"string","format":"uri","description":"Temporary signed download URL. It stops working at `expires_at`: download and host the image yourself. Add `size`, `format` (`png`, `jpg`, `webp`), or `theme` (`light`, `dark`) to format the download. Downloads do not count toward CDN image usage.","isRequired":true,"uniqueKey":"data.logo.oneOf.0.url","typeLabel":"string\u003curi>"},"etag":{"type":"string","description":"Identifies this version of the source image, and is the same on every route. Save it and download again only when it changes.","isRequired":true,"uniqueKey":"data.logo.oneOf.0.etag","typeLabel":"string"},"blurhash":{"type":"string","description":"Compact blurred placeholder for the image.","isRequired":true,"uniqueKey":"data.logo.oneOf.0.blurhash","typeLabel":"string"},"source":{"type":"object","description":"The source file behind the image.","properties":{"width":{"type":"integer","isRequired":true,"uniqueKey":"data.logo.oneOf.0.source.width","typeLabel":"integer"},"height":{"type":"integer","isRequired":true,"uniqueKey":"data.logo.oneOf.0.source.height","typeLabel":"integer"},"has_transparency":{"type":"boolean","isRequired":true,"uniqueKey":"data.logo.oneOf.0.source.has_transparency","typeLabel":"boolean"},"is_vector":{"type":"boolean","isRequired":true,"uniqueKey":"data.logo.oneOf.0.source.is_vector","typeLabel":"boolean"},"format":{"type":"string","enum":["png","jpg","svg","webp","gif","ico","avif"],"description":"Omitted when the format is not recognized.","uniqueKey":"data.logo.oneOf.0.source.format","typeLabel":"enum\u003cstring>"}},"required":["width","height","has_transparency","is_vector"],"isRequired":true,"uniqueKey":"data.logo.oneOf.0.source","typeLabel":"object"},"last_updated_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the image last changed. `null` if it has not changed since the brand was indexed.","isRequired":true,"uniqueKey":"data.logo.oneOf.0.last_updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the image last changed. `null` if it has not changed since the brand was indexed.","isRequired":true,"uniqueKey":"data.logo.oneOf.0.last_updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.logo.oneOf.0.last_updated_at","typeLabel":"string\u003cdate-time> | null"},"expires_at":{"type":"string","format":"date-time","description":"When `url` stops working, about 24 hours after the request.","isRequired":true,"uniqueKey":"data.logo.oneOf.0.expires_at","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"data.logo.oneOf.0","typeLabel":"object"},{"type":"null","description":"The primary logo. `null` when the brand has none.","isRequired":true,"uniqueKey":"data.logo.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.logo","typeLabel":"object | null"},"brandmark":{"oneOf":[{"type":"object","description":"The wide logo lockup: the symbol and wordmark together for most brands, or the wordmark alone for pure-type brands. `null` when the brand has none. See [brandmark](/concepts#brandmark).","required":["url","etag","blurhash","source","last_updated_at","expires_at"],"properties":{"url":{"type":"string","format":"uri","description":"Temporary signed download URL. It stops working at `expires_at`: download and host the image yourself. Add `size`, `format` (`png`, `jpg`, `webp`), or `theme` (`light`, `dark`) to format the download. Downloads do not count toward CDN image usage.","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.url","typeLabel":"string\u003curi>"},"etag":{"type":"string","description":"Identifies this version of the source image, and is the same on every route. Save it and download again only when it changes.","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.etag","typeLabel":"string"},"blurhash":{"type":"string","description":"Compact blurred placeholder for the image.","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.blurhash","typeLabel":"string"},"source":{"type":"object","description":"The source file behind the image.","properties":{"width":{"type":"integer","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.source.width","typeLabel":"integer"},"height":{"type":"integer","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.source.height","typeLabel":"integer"},"has_transparency":{"type":"boolean","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.source.has_transparency","typeLabel":"boolean"},"is_vector":{"type":"boolean","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.source.is_vector","typeLabel":"boolean"},"format":{"type":"string","enum":["png","jpg","svg","webp","gif","ico","avif"],"description":"Omitted when the format is not recognized.","uniqueKey":"data.brandmark.oneOf.0.source.format","typeLabel":"enum\u003cstring>"}},"required":["width","height","has_transparency","is_vector"],"isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.source","typeLabel":"object"},"last_updated_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the image last changed. `null` if it has not changed since the brand was indexed.","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.last_updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the image last changed. `null` if it has not changed since the brand was indexed.","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.last_updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.last_updated_at","typeLabel":"string\u003cdate-time> | null"},"expires_at":{"type":"string","format":"date-time","description":"When `url` stops working, about 24 hours after the request.","isRequired":true,"uniqueKey":"data.brandmark.oneOf.0.expires_at","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"data.brandmark.oneOf.0","typeLabel":"object"},{"type":"null","description":"The wide logo lockup: the symbol and wordmark together for most brands, or the wordmark alone for pure-type brands. `null` when the brand has none. See [brandmark](/concepts#brandmark).","isRequired":true,"uniqueKey":"data.brandmark.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.brandmark","typeLabel":"object | null"},"social_banners":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Temporary signed download URL. It stops working at `expires_at`: download and host the image yourself. Add `size`, `format` (`png`, `jpg`, `webp`), or `theme` (`light`, `dark`) to format the download. Downloads do not count toward CDN image usage.","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].url","typeLabel":"string\u003curi>"},"etag":{"type":"string","description":"Identifies this version of the source image, and is the same on every route. Save it and download again only when it changes.","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].etag","typeLabel":"string"},"blurhash":{"type":"string","description":"Compact blurred placeholder for the image.","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].blurhash","typeLabel":"string"},"source":{"type":"object","description":"The source file behind the image.","properties":{"width":{"type":"integer","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].source.width","typeLabel":"integer"},"height":{"type":"integer","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].source.height","typeLabel":"integer"},"has_transparency":{"type":"boolean","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].source.has_transparency","typeLabel":"boolean"},"is_vector":{"type":"boolean","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].source.is_vector","typeLabel":"boolean"},"format":{"type":"string","enum":["png","jpg","svg","webp","gif","ico","avif"],"description":"Omitted when the format is not recognized.","uniqueKey":"data.social_banners.items.[INDEX].source.format","typeLabel":"enum\u003cstring>"}},"required":["width","height","has_transparency","is_vector"],"isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].source","typeLabel":"object"},"last_updated_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the image last changed. `null` if it has not changed since the brand was indexed.","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].last_updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the image last changed. `null` if it has not changed since the brand was indexed.","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].last_updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].last_updated_at","typeLabel":"string\u003cdate-time> | null"},"expires_at":{"type":"string","format":"date-time","description":"When `url` stops working, about 24 hours after the request.","isRequired":true,"uniqueKey":"data.social_banners.items.[INDEX].expires_at","typeLabel":"string\u003cdate-time>"}},"required":["url","etag","blurhash","source","last_updated_at","expires_at"],"uniqueKey":"data.social_banners.items.[INDEX]","typeLabel":"object"},"description":"Banner images. Empty when there are none.","isRequired":true,"uniqueKey":"data.social_banners","typeLabel":"object[]"}},"required":["object","id","slug","domain","status","name","description","indexed_at","is_profane","socials","colors","logo","brandmark","social_banners"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"metadata":{"type":"object","properties":{"request_id":{"type":"string","description":"Unique id for this request. Also sent as the `Request-Id` header.","examples":["request_01k6z8m2a4b5c6d7e8f9g0h1j2"],"isRequired":true,"uniqueKey":"metadata.request_id","typeLabel":"string"},"resolution":{"type":"object","description":"Brand and image lookups only.","required":["type","value","method","context"],"properties":{"type":{"type":"string","enum":["domain","ticker","isin","crypto","name","brand_id"],"description":"Which identifier the request used.","isRequired":true,"uniqueKey":"metadata.resolution.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"The identifier after normalization: the registrable domain, an upper-cased ticker, and so on.","isRequired":true,"uniqueKey":"metadata.resolution.value","typeLabel":"string"},"method":{"type":"string","enum":["direct","domain","security","crypto","search",""],"description":"How the identifier reached the brand. `direct` is a brand id or a domain that is its own brand; `domain` went through an alias or redirect; `security` is a ticker or ISIN; `crypto` is a crypto token symbol; `search` is a name lookup. Empty on a cached miss.","isRequired":true,"uniqueKey":"metadata.resolution.method","typeLabel":"enum\u003cstring>"},"context":{"type":"object","description":"Reserved for brands involved in a merchant lookup. Always `{}` today.","isRequired":true,"uniqueKey":"metadata.resolution.context","typeLabel":"object"}},"uniqueKey":"metadata.resolution","typeLabel":"object"},"pending":{"type":"object","description":"`202` responses only.","required":["reason","message","retry_after_seconds","expires_in_seconds","webhook","doc_url"],"properties":{"reason":{"type":"string","enum":["indexing","resolving"],"description":"`indexing` is a brand's first crawl; `resolving` means the identifier is still being matched to a brand.","isRequired":true,"uniqueKey":"metadata.pending.reason","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"metadata.pending.message","typeLabel":"string"},"retry_after_seconds":{"type":"integer","description":"Wait this long before retrying. Matches the `Retry-After` header.","examples":[30],"isRequired":true,"uniqueKey":"metadata.pending.retry_after_seconds","typeLabel":"integer"},"expires_in_seconds":{"type":"integer","description":"Stop polling after this long.","examples":[300],"isRequired":true,"uniqueKey":"metadata.pending.expires_in_seconds","typeLabel":"integer"},"webhook":{"type":"boolean","description":"Whether a `brand.indexed` webhook event carrying this request's `request_id` will be sent when the lookup settles.","isRequired":true,"uniqueKey":"metadata.pending.webhook","typeLabel":"boolean"},"doc_url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"metadata.pending.doc_url","typeLabel":"string\u003curi>"}},"uniqueKey":"metadata.pending","typeLabel":"object"},"subscription":{"type":"object","description":"Present when a brand lookup (`GET /v2/brands` or `GET /v2/brands/{id}`) ran the automatic subscribe: webhooks are on for the account, and `nosubscribe` is not `true`. See [automatic subscriptions](/brand/introduction#automatic-subscriptions).","properties":{"status":{"type":"string","enum":["subscribed","quota_exceeded"],"description":"`subscribed`: the account is subscribed to the brand. `quota_exceeded`: the account is at its plan's subscription limit, so the brand was not subscribed. The lookup is answered and billed either way.","isRequired":true,"uniqueKey":"metadata.subscription.status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Why the subscribe was refused. Only with `quota_exceeded`.","uniqueKey":"metadata.subscription.message","typeLabel":"string"}},"required":["status"],"uniqueKey":"metadata.subscription","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"metadata","typeLabel":"object"}},"required":["data","metadata"],"uniqueKey":"","typeLabel":"object"},"example":{"data":{"object":"brand","id":"brand_4x0wr3g0000g00400000000004","slug":"stripe","domain":"stripe.com","status":"ready","name":"Stripe","description":"Payments infrastructure for the internet.","indexed_at":"2026-09-01T12:00:00Z","is_profane":false,"socials":{"twitter":"https://x.com/stripe","linkedin":"https://www.linkedin.com/company/stripe"},"colors":[{"r":99,"g":91,"b":255,"hex":"#635bff","oklch":{"l":0.5854,"c":0.2416,"h":277.12}}],"logo":{"url":"https://img.logo.dev/assets/SEALED_TOKEN","etag":"9f2c1e7a4b8d3f60","blurhash":"LKO2?U%2Tw=w]~RBVZRi};RPxuwH","source":{"width":512,"height":512,"format":"svg","has_transparency":true,"is_vector":true},"last_updated_at":"2026-08-01T09:00:00Z","expires_at":"2026-09-28T13:00:00Z"},"brandmark":null,"social_banners":[]},"metadata":{"request_id":"request_01k6z8m2a4b5c6d7e8f9g0h1j2","resolution":{"type":"domain","value":"stripe.com","method":"direct","context":{}},"subscription":{"status":"subscribed"}}},"examples":{"Example":{"title":"Example","value":{"data":{"object":"brand","id":"brand_4x0wr3g0000g00400000000004","slug":"stripe","domain":"stripe.com","status":"ready","name":"Stripe","description":"Payments infrastructure for the internet.","indexed_at":"2026-09-01T12:00:00Z","is_profane":false,"socials":{"twitter":"https://x.com/stripe","linkedin":"https://www.linkedin.com/company/stripe"},"colors":[{"r":99,"g":91,"b":255,"hex":"#635bff","oklch":{"l":0.5854,"c":0.2416,"h":277.12}}],"logo":{"url":"https://img.logo.dev/assets/SEALED_TOKEN","etag":"9f2c1e7a4b8d3f60","blurhash":"LKO2?U%2Tw=w]~RBVZRi};RPxuwH","source":{"width":512,"height":512,"format":"svg","has_transparency":true,"is_vector":true},"last_updated_at":"2026-08-01T09:00:00Z","expires_at":"2026-09-28T13:00:00Z"},"brandmark":null,"social_banners":[]},"metadata":{"request_id":"request_01k6z8m2a4b5c6d7e8f9g0h1j2","resolution":{"type":"domain","value":"stripe.com","method":"direct","context":{}},"subscription":{"status":"subscribed"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"f3fedec0-03bc-4153-9694-cf014859d244":{"description":"Logo.dev is still indexing this brand. Retry after `Retry-After` seconds; retries are not billed.","headers":{"Retry-After":{"description":"Seconds to wait before retrying. Always `30`.","schema":{"type":"integer","examples":[30]}},"Request-Id":{"description":"Unique id for this request. Include it when you contact support.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Brand requests allowed per minute for your account.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Brand requests left in the current minute.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Credits-Charged":{"description":"`1` when this request was billed, `0` when it was not.","schema":{"type":"integer","enum":[0,1]}},"Credits-Remaining":{"description":"Your remaining API credit balance. Omitted when no balance is available.","schema":{"type":"string","examples":["18966.99"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"Body of a `202` or `404` lookup: only the object type and status.","properties":{"object":{"type":"string","enum":["brand","image"],"isRequired":true,"uniqueKey":"data.object","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["not_indexed","not_found"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"}},"required":["object","status"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"metadata":{"type":"object","properties":{"request_id":{"type":"string","description":"Unique id for this request. Also sent as the `Request-Id` header.","examples":["request_01k6z8m2a4b5c6d7e8f9g0h1j2"],"isRequired":true,"uniqueKey":"metadata.request_id","typeLabel":"string"},"resolution":{"type":"object","description":"Brand and image lookups only.","required":["type","value","method","context"],"properties":{"type":{"type":"string","enum":["domain","ticker","isin","crypto","name","brand_id"],"description":"Which identifier the request used.","isRequired":true,"uniqueKey":"metadata.resolution.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"The identifier after normalization: the registrable domain, an upper-cased ticker, and so on.","isRequired":true,"uniqueKey":"metadata.resolution.value","typeLabel":"string"},"method":{"type":"string","enum":["direct","domain","security","crypto","search",""],"description":"How the identifier reached the brand. `direct` is a brand id or a domain that is its own brand; `domain` went through an alias or redirect; `security` is a ticker or ISIN; `crypto` is a crypto token symbol; `search` is a name lookup. Empty on a cached miss.","isRequired":true,"uniqueKey":"metadata.resolution.method","typeLabel":"enum\u003cstring>"},"context":{"type":"object","description":"Reserved for brands involved in a merchant lookup. Always `{}` today.","isRequired":true,"uniqueKey":"metadata.resolution.context","typeLabel":"object"}},"uniqueKey":"metadata.resolution","typeLabel":"object"},"pending":{"type":"object","description":"`202` responses only.","required":["reason","message","retry_after_seconds","expires_in_seconds","webhook","doc_url"],"properties":{"reason":{"type":"string","enum":["indexing","resolving"],"description":"`indexing` is a brand's first crawl; `resolving` means the identifier is still being matched to a brand.","isRequired":true,"uniqueKey":"metadata.pending.reason","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"metadata.pending.message","typeLabel":"string"},"retry_after_seconds":{"type":"integer","description":"Wait this long before retrying. Matches the `Retry-After` header.","examples":[30],"isRequired":true,"uniqueKey":"metadata.pending.retry_after_seconds","typeLabel":"integer"},"expires_in_seconds":{"type":"integer","description":"Stop polling after this long.","examples":[300],"isRequired":true,"uniqueKey":"metadata.pending.expires_in_seconds","typeLabel":"integer"},"webhook":{"type":"boolean","description":"Whether a `brand.indexed` webhook event carrying this request's `request_id` will be sent when the lookup settles.","isRequired":true,"uniqueKey":"metadata.pending.webhook","typeLabel":"boolean"},"doc_url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"metadata.pending.doc_url","typeLabel":"string\u003curi>"}},"uniqueKey":"metadata.pending","typeLabel":"object"},"subscription":{"type":"object","description":"Present when a brand lookup (`GET /v2/brands` or `GET /v2/brands/{id}`) ran the automatic subscribe: webhooks are on for the account, and `nosubscribe` is not `true`. See [automatic subscriptions](/brand/introduction#automatic-subscriptions).","properties":{"status":{"type":"string","enum":["subscribed","quota_exceeded"],"description":"`subscribed`: the account is subscribed to the brand. `quota_exceeded`: the account is at its plan's subscription limit, so the brand was not subscribed. The lookup is answered and billed either way.","isRequired":true,"uniqueKey":"metadata.subscription.status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Why the subscribe was refused. Only with `quota_exceeded`.","uniqueKey":"metadata.subscription.message","typeLabel":"string"}},"required":["status"],"uniqueKey":"metadata.subscription","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"metadata","typeLabel":"object"}},"required":["data","metadata"],"uniqueKey":"","typeLabel":"object"},"example":{"data":{"object":"brand","status":"not_indexed"},"metadata":{"request_id":"request_01k6z8m2a4b5c6d7e8f9g0h1j2","resolution":{"type":"domain","value":"stripe.com","method":"direct","context":{}},"pending":{"reason":"indexing","message":"This brand is being indexed for the first time and is usually ready within a minute. Retry the same request after 30 seconds; retries are not billed.","retry_after_seconds":30,"expires_in_seconds":300,"webhook":false,"doc_url":"https://www.logo.dev/docs/platform/errors#not-found-vs-still-indexing-202"}}},"examples":{"Example":{"title":"Example","value":{"data":{"object":"brand","status":"not_indexed"},"metadata":{"request_id":"request_01k6z8m2a4b5c6d7e8f9g0h1j2","resolution":{"type":"domain","value":"stripe.com","method":"direct","context":{}},"pending":{"reason":"indexing","message":"This brand is being indexed for the first time and is usually ready within a minute. Retry the same request after 30 seconds; retries are not billed.","retry_after_seconds":30,"expires_in_seconds":300,"webhook":false,"doc_url":"https://www.logo.dev/docs/platform/errors#not-found-vs-still-indexing-202"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"88d25dde-a262-4220-b0db-e409293e153d":{"description":"The brand id is malformed.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope for v2 routes.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","resource_missing","insufficient_credits","rate_limited","limit_exceeded","internal"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"target":{"type":"string","description":"The parameter at fault, when there is exactly one.","uniqueKey":"error.target","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"docs_url":{"type":"string","format":"uri","description":"Documentation for this class of error.","uniqueKey":"docs_url","typeLabel":"string\u003curi>"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_request","message":"id must start with \"brand_\": bad format","target":"id"},"docs_url":"https://www.logo.dev/docs/platform/errors"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"id must start with \"brand_\": bad format","target":"id"},"docs_url":"https://www.logo.dev/docs/platform/errors"}}},"exampleType":"examples"}},"exampleType":"examples"},"d1c40757-2ffc-4600-83bd-3ad7432234d8":{"description":"The secret key is missing, malformed, unknown, or disabled. A publishable key (`pk_`) is refused.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Returned when the secret key is missing, malformed, unknown, or disabled, before the request reaches the v2 route.","required":["msg"],"properties":{"msg":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.msg","typeLabel":"string"},"docs_url":{"type":"string","format":"uri","uniqueKey":"oneOf.0.docs_url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Error envelope for v2 routes.","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","resource_missing","insufficient_credits","rate_limited","limit_exceeded","internal"],"isRequired":true,"uniqueKey":"oneOf.1.error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"},"target":{"type":"string","description":"The parameter at fault, when there is exactly one.","uniqueKey":"oneOf.1.error.target","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"},"docs_url":{"type":"string","format":"uri","description":"Documentation for this class of error.","uniqueKey":"oneOf.1.docs_url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"example":{"msg":"invalid api token. make sure to use your secret key.","docs_url":"https://www.logo.dev/docs/platform/api-keys"},"examples":{"Example":{"title":"Example","value":{"msg":"invalid api token. make sure to use your secret key.","docs_url":"https://www.logo.dev/docs/platform/api-keys"}}},"exampleType":"examples"}},"exampleType":"examples"},"3d00fe74-d60d-4e4a-8493-d37e49fd6e86":{"description":"Your account is out of API credits.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope for v2 routes.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","resource_missing","insufficient_credits","rate_limited","limit_exceeded","internal"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"target":{"type":"string","description":"The parameter at fault, when there is exactly one.","uniqueKey":"error.target","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"docs_url":{"type":"string","format":"uri","description":"Documentation for this class of error.","uniqueKey":"docs_url","typeLabel":"string\u003curi>"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"insufficient_credits","message":"out of credits for the brand API. purchase credits at https://www.logo.dev/dashboard"},"docs_url":"https://www.logo.dev/docs/platform/errors"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"insufficient_credits","message":"out of credits for the brand API. purchase credits at https://www.logo.dev/dashboard"},"docs_url":"https://www.logo.dev/docs/platform/errors"}}},"exampleType":"examples"}},"exampleType":"examples"},"706823f2-6028-4da9-9413-e65c881e353d":{"description":"The request is refused. Not billed. The identifier type you sent is not yet enabled for any account (`merchant`), the account is suspended, or personal keys are turned off because you belong to a team. The last two return a `msg` field, as an authentication error does.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Error envelope for v2 routes.","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","resource_missing","insufficient_credits","rate_limited","limit_exceeded","internal"],"isRequired":true,"uniqueKey":"oneOf.0.error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.message","typeLabel":"string"},"target":{"type":"string","description":"The parameter at fault, when there is exactly one.","uniqueKey":"oneOf.0.error.target","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"object"},"docs_url":{"type":"string","format":"uri","description":"Documentation for this class of error.","uniqueKey":"oneOf.0.docs_url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Returned when the secret key is missing, malformed, unknown, or disabled, before the request reaches the v2 route.","required":["msg"],"properties":{"msg":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.msg","typeLabel":"string"},"docs_url":{"type":"string","format":"uri","uniqueKey":"oneOf.1.docs_url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"merchant":{"title":"merchant","value":{"error":{"code":"forbidden","message":"merchant lookups are not yet available","target":"merchant"},"docs_url":"https://www.logo.dev/docs/platform/errors"}},"suspended":{"title":"suspended","value":{"msg":"account suspended. contact team@logo.dev for more information","docs_url":"https://www.logo.dev/docs/platform/errors"}}},"exampleType":"examples"}},"exampleType":"examples"},"2129c5aa-32db-439e-ad2c-07c17fe115b4":{"description":"No brand matches this identifier.","headers":{"Request-Id":{"description":"Unique id for this request. Include it when you contact support.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Brand requests allowed per minute for your account.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Brand requests left in the current minute.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Credits-Charged":{"description":"`1` when this request was billed, `0` when it was not.","schema":{"type":"integer","enum":[0,1]}},"Credits-Remaining":{"description":"Your remaining API credit balance. Omitted when no balance is available.","schema":{"type":"string","examples":["18966.99"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"Body of a `202` or `404` lookup: only the object type and status.","properties":{"object":{"type":"string","enum":["brand","image"],"isRequired":true,"uniqueKey":"data.object","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["not_indexed","not_found"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"}},"required":["object","status"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"metadata":{"type":"object","properties":{"request_id":{"type":"string","description":"Unique id for this request. Also sent as the `Request-Id` header.","examples":["request_01k6z8m2a4b5c6d7e8f9g0h1j2"],"isRequired":true,"uniqueKey":"metadata.request_id","typeLabel":"string"},"resolution":{"type":"object","description":"Brand and image lookups only.","required":["type","value","method","context"],"properties":{"type":{"type":"string","enum":["domain","ticker","isin","crypto","name","brand_id"],"description":"Which identifier the request used.","isRequired":true,"uniqueKey":"metadata.resolution.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"The identifier after normalization: the registrable domain, an upper-cased ticker, and so on.","isRequired":true,"uniqueKey":"metadata.resolution.value","typeLabel":"string"},"method":{"type":"string","enum":["direct","domain","security","crypto","search",""],"description":"How the identifier reached the brand. `direct` is a brand id or a domain that is its own brand; `domain` went through an alias or redirect; `security` is a ticker or ISIN; `crypto` is a crypto token symbol; `search` is a name lookup. Empty on a cached miss.","isRequired":true,"uniqueKey":"metadata.resolution.method","typeLabel":"enum\u003cstring>"},"context":{"type":"object","description":"Reserved for brands involved in a merchant lookup. Always `{}` today.","isRequired":true,"uniqueKey":"metadata.resolution.context","typeLabel":"object"}},"uniqueKey":"metadata.resolution","typeLabel":"object"},"pending":{"type":"object","description":"`202` responses only.","required":["reason","message","retry_after_seconds","expires_in_seconds","webhook","doc_url"],"properties":{"reason":{"type":"string","enum":["indexing","resolving"],"description":"`indexing` is a brand's first crawl; `resolving` means the identifier is still being matched to a brand.","isRequired":true,"uniqueKey":"metadata.pending.reason","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"metadata.pending.message","typeLabel":"string"},"retry_after_seconds":{"type":"integer","description":"Wait this long before retrying. Matches the `Retry-After` header.","examples":[30],"isRequired":true,"uniqueKey":"metadata.pending.retry_after_seconds","typeLabel":"integer"},"expires_in_seconds":{"type":"integer","description":"Stop polling after this long.","examples":[300],"isRequired":true,"uniqueKey":"metadata.pending.expires_in_seconds","typeLabel":"integer"},"webhook":{"type":"boolean","description":"Whether a `brand.indexed` webhook event carrying this request's `request_id` will be sent when the lookup settles.","isRequired":true,"uniqueKey":"metadata.pending.webhook","typeLabel":"boolean"},"doc_url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"metadata.pending.doc_url","typeLabel":"string\u003curi>"}},"uniqueKey":"metadata.pending","typeLabel":"object"},"subscription":{"type":"object","description":"Present when a brand lookup (`GET /v2/brands` or `GET /v2/brands/{id}`) ran the automatic subscribe: webhooks are on for the account, and `nosubscribe` is not `true`. See [automatic subscriptions](/brand/introduction#automatic-subscriptions).","properties":{"status":{"type":"string","enum":["subscribed","quota_exceeded"],"description":"`subscribed`: the account is subscribed to the brand. `quota_exceeded`: the account is at its plan's subscription limit, so the brand was not subscribed. The lookup is answered and billed either way.","isRequired":true,"uniqueKey":"metadata.subscription.status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Why the subscribe was refused. Only with `quota_exceeded`.","uniqueKey":"metadata.subscription.message","typeLabel":"string"}},"required":["status"],"uniqueKey":"metadata.subscription","typeLabel":"object"}},"required":["request_id"],"isRequired":true,"uniqueKey":"metadata","typeLabel":"object"},"docs_url":{"type":"string","format":"uri","description":"Documentation for this status.","uniqueKey":"docs_url","typeLabel":"string\u003curi>"}},"required":["data","metadata"],"uniqueKey":"","typeLabel":"object"},"example":{"data":{"object":"brand","status":"not_found"},"metadata":{"request_id":"request_01k6z8m2a4b5c6d7e8f9g0h1j2","resolution":{"type":"domain","value":"stripe.com","method":"direct","context":{}}},"docs_url":"https://www.logo.dev/docs/platform/errors"},"examples":{"Example":{"title":"Example","value":{"data":{"object":"brand","status":"not_found"},"metadata":{"request_id":"request_01k6z8m2a4b5c6d7e8f9g0h1j2","resolution":{"type":"domain","value":"stripe.com","method":"direct","context":{}}},"docs_url":"https://www.logo.dev/docs/platform/errors"}}},"exampleType":"examples"}},"exampleType":"examples"},"f45868f6-dfbd-4faa-a87e-349d53d03a0c":{"description":"Too many brand requests per minute, or too many open at once. Wait for `RateLimit-Reset` seconds.","headers":{"RateLimit-Limit":{"description":"Brand requests allowed per minute for your account.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Brand requests left in the current minute.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","description":"Error envelope for v2 routes.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","resource_missing","insufficient_credits","rate_limited","limit_exceeded","internal"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"target":{"type":"string","description":"The parameter at fault, when there is exactly one.","uniqueKey":"error.target","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"docs_url":{"type":"string","format":"uri","description":"Documentation for this class of error.","uniqueKey":"docs_url","typeLabel":"string\u003curi>"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limited","message":"rate limit reached. no more than 100 brand requests per minute per account."},"docs_url":"https://www.logo.dev/docs/platform/rate-limits"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limited","message":"rate limit reached. no more than 100 brand requests per minute per account."},"docs_url":"https://www.logo.dev/docs/platform/rate-limits"}}},"exampleType":"examples"}},"exampleType":"examples"},"a75ea841-960e-4602-9123-32fec44fa362":{"description":"Something failed on our side. Retry, and contact support with the `Request-Id` if it persists.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope for v2 routes.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","unauthorized","forbidden","resource_missing","insufficient_credits","rate_limited","limit_exceeded","internal"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"target":{"type":"string","description":"The parameter at fault, when there is exactly one.","uniqueKey":"error.target","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"docs_url":{"type":"string","format":"uri","description":"Documentation for this class of error.","uniqueKey":"docs_url","typeLabel":"string\u003curi>"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"internal","message":"failed to resolve brand"},"docs_url":"https://www.logo.dev/docs/platform/errors"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"internal","message":"failed to resolve brand"},"docs_url":"https://www.logo.dev/docs/platform/errors"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"d50840da-83df-4a54-a3ec-b47f44a10772":{"secretKey":{"type":"http","scheme":"bearer","description":"Your secret key (`sk_`), as `Bearer sk_...`. Call the Logo.dev API only from your server.","scopes":[],"schemeName":"secretKey"}}},"servers":{"fc356b30-93a5-48a5-83b2-bf6accbdb614":{"url":"https://api.logo.dev","description":"REST APIs (Brand Search, Brand Data)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your secret key (`sk_`), as `Bearer sk_...`. Call the Logo.dev API only from your server.","scopes":[],"schemeName":"secretKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your secret key (`sk_`), as `Bearer sk_...`. Call the Logo.dev API only from your server.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"secretKey","name":"Authorization"}],"title":"secretKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"simplecasual","siteName":"Logo.dev","title":"Get a brand by id - Logo.dev","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T00:24:21.916Z","originalFileLocation":"api-reference/brands/get-a-brand-by-id.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Fetch a brand\u0026#x27;s profile by its stable brand id.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Logo.dev\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a brand by id - Logo.dev\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fetch a brand\u0026#x27;s profile by its stable brand id.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Logo.dev Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://simplecasual.mintlify.site/docs/_mintlify/api/og/v2?division=Brand\u0026amp;title=Get+a+brand+by+id\u0026amp;description=Fetch+a+brand%27s+profile+by+its+stable+brand+id.\u0026amp;theme=3b0378da97241ff015d8a070\u0026amp;signature=d6e8201f1f0c5ad5e24ec3d8e66b26be3b01e40ce27755edac430453f28a874d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a brand by id - Logo.dev\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fetch a brand\u0026#x27;s profile by its stable brand id.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://simplecasual.mintlify.site/docs/_mintlify/api/og/v2?division=Brand\u0026amp;title=Get+a+brand+by+id\u0026amp;description=Fetch+a+brand%27s+profile+by+its+stable+brand+id.\u0026amp;theme=3b0378da97241ff015d8a070\u0026amp;signature=d6e8201f1f0c5ad5e24ec3d8e66b26be3b01e40ce27755edac430453f28a874d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/simplecasual/ffjd0p23NsA8r6u7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Logo.dev\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#212121\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/brands/get-a-brand-by-id.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.logo.dev/#organization\",\"name\":\"Logo.dev\",\"url\":\"https://www.logo.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/simplecasual/zsNskQWqsXEQO5xC/logo/light.svg?fit=max\u0026auto=format\u0026n=zsNskQWqsXEQO5xC\u0026q=85\u0026s=61958aab2347b4a683f4214e6d1e9bb9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.logo.dev/docs#website\",\"name\":\"Logo.dev\",\"url\":\"https://www.logo.dev/docs\",\"publisher\":{\"@id\":\"https://www.logo.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id#webpage\",\"url\":\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id\",\"name\":\"Get a brand by id\",\"description\":\"Fetch a brand's profile by its stable brand id.\",\"dateModified\":\"2026-11-12T00:24:21.916Z\",\"isPartOf\":{\"@id\":\"https://www.logo.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API\",\"item\":\"https://www.logo.dev/docs/api-reference/brands/look-up-a-brand\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Brand\",\"item\":\"https://www.logo.dev/docs/api-reference/brands/look-up-a-brand\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get a brand by id\",\"item\":\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id#apireference\",\"headline\":\"Get a brand by id\",\"name\":\"Get a brand by id\",\"description\":\"Fetch a brand's profile by its stable brand id.\",\"url\":\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id\",\"mainEntityOfPage\":{\"@id\":\"https://www.logo.dev/docs/api-reference/brands/get-a-brand-by-id#webpage\"},\"dateModified\":\"2026-11-12T00:24:21.916Z\",\"publisher\":{\"@id\":\"https://www.logo.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://www.logo.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Logo.dev\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Logo.dev\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/brands/get-a-brand-by-id.md","siteName":"Logo.dev","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"CDN","pages":[{"title":"Get a logo","deprecated":null,"version":null,"openapi":"/openapi.json get /{domain}","href":"/api-reference/logo-cdn/get-a-logo"}]},{"group":"API","pages":[{"group":"Brand","expanded":true,"pages":[{"title":"Look up a brand","description":"Look up a brand by domain, ticker, ISIN, crypto symbol, or name and get its name, colors, socials, logo, and brandmark.","deprecated":null,"version":null,"tag":"5 credits","openapi":"/openapi.json get /v2/brands","href":"/api-reference/brands/look-up-a-brand"},{"title":"Get a brand by id","deprecated":null,"version":null,"tag":"5 credits","openapi":"/openapi.json get /v2/brands/{id}","href":"/api-reference/brands/get-a-brand-by-id"}]},{"group":"Logo","expanded":true,"pages":[{"title":"Get a logo","description":"Get a brand's logo with a temporary download URL, dimensions, and blurhash.","deprecated":null,"version":null,"tag":"2 credits","openapi":"/openapi.json get /v2/brands/logo","href":"/api-reference/logos/get-a-logo"},{"title":"Get a brandmark","deprecated":null,"version":null,"tag":"3 credits","openapi":"/openapi.json get /v2/brands/brandmark","href":"/api-reference/logos/get-a-brandmark"}]},{"group":"Search","expanded":true,"pages":[{"title":"Search brands","deprecated":null,"version":null,"tag":"1 credit / 1,000 searches","openapi":"/openapi.json get /v2/search","href":"/api-reference/search/search-brands"}]},{"group":"Account","expanded":true,"pages":[{"title":"Get your account","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/account","href":"/api-reference/account/get-your-account"}]},{"group":"Webhooks","pages":[{"group":"Subscriptions","pages":[{"title":"Get a brand subscription","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/brands/{id}/subscription","href":"/api-reference/subscriptions/get-a-brand-subscription"},{"title":"Subscribe to a brand","deprecated":null,"version":null,"openapi":"/openapi.json put /v2/brands/{id}/subscription","href":"/api-reference/subscriptions/subscribe-to-a-brand"},{"title":"Unsubscribe from a brand","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/brands/{id}/subscription","href":"/api-reference/subscriptions/unsubscribe-from-a-brand"}]},{"group":"Endpoints","pages":[{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/webhook_endpoints","href":"/api-reference/webhook-endpoints/create-a-webhook-endpoint"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/webhook_endpoints","href":"/api-reference/webhook-endpoints/list-webhook-endpoints"},{"title":"Get a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/webhook_endpoints/{id}","href":"/api-reference/webhook-endpoints/get-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /v2/webhook_endpoints/{id}","href":"/api-reference/webhook-endpoints/update-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /v2/webhook_endpoints/{id}","href":"/api-reference/webhook-endpoints/delete-a-webhook-endpoint"},{"title":"Get a webhook signing secret","deprecated":null,"version":null,"openapi":"/openapi.json get /v2/webhook_endpoints/{id}/secret","href":"/api-reference/webhook-endpoints/get-a-webhook-signing-secret"},{"title":"Rotate a webhook signing secret","deprecated":null,"version":null,"openapi":"/openapi.json post /v2/webhook_endpoints/{id}/secret","href":"/api-reference/webhook-endpoints/rotate-a-webhook-signing-secret"}]}]},{"group":"Flags","expanded":true,"pages":[{"title":"Flag domains for review","deprecated":null,"version":null,"tag":"Pro or Enterprise","openapi":"/openapi.json post /v2/flag","href":"/api-reference/flags/flag-domains-for-review"}]},{"group":"Transaction","tag":"Beta","pages":[{"title":"Identify a merchant","deprecated":null,"version":null,"openapi":"/openapi.json post /transaction","href":"/api-reference/transaction-enrichment-api/identify-a-merchant"}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/introduction"}]},{"tab":"Use cases","pages":[{"title":"Use cases","href":"/use-cases/logo-from-domain"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Get a brand by id - Logo.dev","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CQGbdtm4.js","utils-D88A1f-Z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChqWdz1A.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-yBrxdh_6.js","snippetPresets-BgqDrFJC.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Duxc2rZw.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C7jidOil.js","shallow-xkjpHm-U.js","getApiPlaygroundDisplay-fE3rVpvL.js","CodeSnippet-LgxljKed.js","CodeSnippets-D-pXWDHq.js","Page-C2-BijcO.js","getPastedJson-CLRcu-uo.js","icon-Cxirpjgo.js","MethodPill-D49eqY5e.js","DuplicateIcon-CivCz5Rp.js","createIcon-D71qL3f5.js","DynamicMarkdown-BcGRTrw6.js","SectionHeading-DzaqmmSD.js","axios-vUo_bRtp.js","Markdown-CZqUYmMp.js","clsx-B6IZIRsp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B0ZV6X5T.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-MqLyPtsW.js"]}