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.
Query Parameters
domain
string
A company domain. Reduced to its registrable domain, so www.stripe.com looks up stripe.com. Send exactly one identifier.
Example:
"stripe.com"
ticker
string
The stock or ETF symbol, in any case, with no exchange prefix: aapl and AAPL return the same brand. A bare symbol resolves against US exchanges. For a listing on another exchange, add the exchange suffix, such as 7203.T. Send exactly one identifier.
Example:
"aapl"
isin
string
An ISIN. Case-insensitive. Send exactly one identifier.
Example:
"US0378331005"
crypto
string
A crypto token symbol. Case-insensitive. Send exactly one identifier.
Example:
"BTC"
name
string
A brand name. Resolved to the top search match. Send exactly one identifier.
Example:
"Stripe"
merchant
string
A card-statement merchant descriptor. Announced but not yet enabled for any account, so it currently answers 403. Send exactly one identifier.
Example:
"SQ *BLUE BOTTLE COFFEE"
Response
The brand is ready and has a logo.
data
object
required
Hide child attributes
data.object
string
required
Allowed value: "image"
data.kind
enum<string>
required
logo or brandmark.
Available options:
logo,
brandmark
data.brand_id
string
required
Example:
"brand_4x0wr3g0000g00400000000004"
data.status
string
required
Allowed value: "ready"
data.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.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.blurhash
string
required
Compact blurred placeholder for the image.
data.source
object
required
The source file behind the image.
Hide child attributes
data.source.width
integer
required
data.source.height
integer
required
data.source.has_transparency
boolean
required
data.source.is_vector
boolean
required
data.source.format
enum<string>
Omitted when the format is not recognized.
Available options:
png,
jpg,
svg,
webp,
gif,
ico,
avif
data.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.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/logos/get-a-logo","slug":"/api-reference/logos/get-a-logo","pageMetadata":{"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","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: \"Get a brand’s logo with a temporary download URL, dimensions, and blurhash.\"\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 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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/simplecasual/1d10373eb07f4b13/credits-pill.js"],"openApiReferenceData":{"operation":{"tags":["Logos"],"summary":"Get a logo","description":"Get a brand's logo with a temporary download URL, dimensions, and blurhash.","operationId":"v2GetBrandLogo","x-mint":{"metadata":{"description":"Get a brand's logo with a temporary download URL, dimensions, and blurhash.","tag":"2 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":["3f92163e-dd85-4fab-bd61-93f0eafe7b21"],"parameters":["2dd96d5c-d199-40d7-a2a1-11e2644e1139","782d4814-5af8-4093-99a6-bb6ed0c01d7b","29f209cd-e1a8-47de-b7e2-7a0c5e144559","c06cd2e1-fc4c-4ff4-8117-024bc29a08a2","830184d9-3b5f-4e12-839e-69bb1d6a0eaf","f0667eb7-deee-4fe6-be3b-94a94e206033"],"responses":{"200":"6c2bee0a-3a71-477d-95b1-34d42270c5f0","202":"d049dc35-5b74-4225-8d11-11ca47e7af1f","400":"b166c723-4555-4df4-8218-6312d35b8418","401":"0f829052-77c4-4baa-b690-503fd6066721","402":"8ad9d6ee-1149-4ce8-b7a7-fb5d37c9bdfc","403":"7714f856-34bd-4497-9ce1-7f070eec56d2","404":"4f8f569e-ac55-4738-be79-24db9e5297a8","429":"2646a300-2779-40a5-9df7-30b622789151","500":"e87ed056-975a-4931-813b-ad776b857714"},"x-codeSamples":[{"lang":"bash","label":"By domain","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?domain=stripe.com\""},{"lang":"bash","label":"By ticker","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?ticker=AAPL\""},{"lang":"bash","label":"By ISIN","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?isin=US0378331005\""},{"lang":"bash","label":"By crypto","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?crypto=BTC\""},{"lang":"bash","label":"By name","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?name=Stripe\""},{"lang":"javascript","label":"By domain","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?domain=stripe.com\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"lang":"javascript","label":"By ticker","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?ticker=AAPL\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"lang":"javascript","label":"By ISIN","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?isin=US0378331005\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"lang":"javascript","label":"By crypto","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?crypto=BTC\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"lang":"javascript","label":"By name","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?name=Stripe\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"lang":"python","label":"By domain","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"domain\": \"stripe.com\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"},{"lang":"python","label":"By ticker","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"ticker\": \"AAPL\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"},{"lang":"python","label":"By ISIN","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"isin\": \"US0378331005\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"},{"lang":"python","label":"By crypto","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"crypto\": \"BTC\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"},{"lang":"python","label":"By name","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"name\": \"Stripe\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"}],"method":"get","type":"path","servers":["fc356b30-93a5-48a5-83b2-bf6accbdb614"],"path":"/v2/brands/logo","baseUrlOptions":["https://api.logo.dev"],"title":"Get a logo","codeSamples":[{"label":"By domain","lang":"bash","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?domain=stripe.com\""},{"label":"By ticker","lang":"bash","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?ticker=AAPL\""},{"label":"By ISIN","lang":"bash","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?isin=US0378331005\""},{"label":"By crypto","lang":"bash","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?crypto=BTC\""},{"label":"By name","lang":"bash","source":"curl --header \"Authorization: Bearer $LOGO_DEV_SECRET_KEY\" \\\n \"https://api.logo.dev/v2/brands/logo?name=Stripe\""},{"label":"By domain","lang":"javascript","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?domain=stripe.com\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"label":"By ticker","lang":"javascript","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?ticker=AAPL\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"label":"By ISIN","lang":"javascript","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?isin=US0378331005\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"label":"By crypto","lang":"javascript","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?crypto=BTC\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"label":"By name","lang":"javascript","source":"const res = await fetch(\"https://api.logo.dev/v2/brands/logo?name=Stripe\", {\n headers: { Authorization: `Bearer ${process.env.LOGO_DEV_SECRET_KEY}` },\n});\nconst { data, metadata } = await res.json();"},{"label":"By domain","lang":"python","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"domain\": \"stripe.com\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"},{"label":"By ticker","lang":"python","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"ticker\": \"AAPL\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"},{"label":"By ISIN","lang":"python","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"isin\": \"US0378331005\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"},{"label":"By crypto","lang":"python","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"crypto\": \"BTC\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"},{"label":"By name","lang":"python","source":"import os, requests\n\nres = requests.get(\n \"https://api.logo.dev/v2/brands/logo\",\n params={\"name\": \"Stripe\"},\n headers={\"Authorization\": f\"Bearer {os.environ['LOGO_DEV_SECRET_KEY']}\"},\n)\ndata = res.json()[\"data\"]"}],"requestExampleLanguages":["bash","javascript","python","go","ruby","php"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"2dd96d5c-d199-40d7-a2a1-11e2644e1139":{"name":"domain","in":"query","required":false,"description":"A company domain. Reduced to its registrable domain, so `www.stripe.com` looks up `stripe.com`. Send exactly one identifier.","schema":{"type":"string","examples":["stripe.com"],"isRequired":false,"description":"A company domain. Reduced to its registrable domain, so `www.stripe.com` looks up `stripe.com`. Send exactly one identifier.","uniqueKey":"","typeLabel":"string"}},"782d4814-5af8-4093-99a6-bb6ed0c01d7b":{"name":"ticker","in":"query","required":false,"description":"The stock or ETF symbol, in any case, with no exchange prefix: `aapl` and `AAPL` return the same brand. A bare symbol resolves against US exchanges. For a listing on another exchange, add the [exchange suffix](/logo-images/ticker#exchange-suffixes), such as `7203.T`. Send exactly one identifier.","schema":{"type":"string","examples":["aapl"],"isRequired":false,"description":"The stock or ETF symbol, in any case, with no exchange prefix: `aapl` and `AAPL` return the same brand. A bare symbol resolves against US exchanges. For a listing on another exchange, add the [exchange suffix](/logo-images/ticker#exchange-suffixes), such as `7203.T`. Send exactly one identifier.","uniqueKey":"","typeLabel":"string"}},"29f209cd-e1a8-47de-b7e2-7a0c5e144559":{"name":"isin","in":"query","required":false,"description":"An ISIN. Case-insensitive. Send exactly one identifier.","schema":{"type":"string","examples":["US0378331005"],"isRequired":false,"description":"An ISIN. Case-insensitive. Send exactly one identifier.","uniqueKey":"","typeLabel":"string"}},"c06cd2e1-fc4c-4ff4-8117-024bc29a08a2":{"name":"crypto","in":"query","required":false,"description":"A crypto token symbol. Case-insensitive. Send exactly one identifier.","schema":{"type":"string","examples":["BTC"],"isRequired":false,"description":"A crypto token symbol. Case-insensitive. Send exactly one identifier.","uniqueKey":"","typeLabel":"string"}},"830184d9-3b5f-4e12-839e-69bb1d6a0eaf":{"name":"name","in":"query","required":false,"description":"A brand name. Resolved to the top search match. Send exactly one identifier.","schema":{"type":"string","examples":["Stripe"],"isRequired":false,"description":"A brand name. Resolved to the top search match. Send exactly one identifier.","uniqueKey":"","typeLabel":"string"}},"f0667eb7-deee-4fe6-be3b-94a94e206033":{"name":"merchant","in":"query","required":false,"description":"A card-statement merchant descriptor. Announced but not yet enabled for any account, so it currently answers `403`. Send exactly one identifier.","schema":{"type":"string","examples":["SQ *BLUE BOTTLE COFFEE"],"isRequired":false,"description":"A card-statement merchant descriptor. Announced but not yet enabled for any account, so it currently answers `403`. Send exactly one identifier.","uniqueKey":"","typeLabel":"string"}}},"responses":{"6c2bee0a-3a71-477d-95b1-34d42270c5f0":{"description":"The brand is ready and has a logo.","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","required":["url","etag","blurhash","source","last_updated_at","expires_at","object","kind","brand_id","status"],"properties":{"object":{"type":"string","const":"image","isRequired":true,"uniqueKey":"data.object","typeLabel":"string"},"kind":{"type":"string","enum":["logo","brandmark"],"description":"`logo` or `brandmark`.","isRequired":true,"uniqueKey":"data.kind","typeLabel":"enum\u003cstring>"},"brand_id":{"type":"string","examples":["brand_4x0wr3g0000g00400000000004"],"isRequired":true,"uniqueKey":"data.brand_id","typeLabel":"string"},"status":{"type":"string","const":"ready","isRequired":true,"uniqueKey":"data.status","typeLabel":"string"},"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.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.etag","typeLabel":"string"},"blurhash":{"type":"string","description":"Compact blurred placeholder for the image.","isRequired":true,"uniqueKey":"data.blurhash","typeLabel":"string"},"source":{"type":"object","description":"The source file behind the image.","properties":{"width":{"type":"integer","isRequired":true,"uniqueKey":"data.source.width","typeLabel":"integer"},"height":{"type":"integer","isRequired":true,"uniqueKey":"data.source.height","typeLabel":"integer"},"has_transparency":{"type":"boolean","isRequired":true,"uniqueKey":"data.source.has_transparency","typeLabel":"boolean"},"is_vector":{"type":"boolean","isRequired":true,"uniqueKey":"data.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.source.format","typeLabel":"enum\u003cstring>"}},"required":["width","height","has_transparency","is_vector"],"isRequired":true,"uniqueKey":"data.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.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.last_updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.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.expires_at","typeLabel":"string\u003cdate-time>"}},"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":"image","kind":"logo","brand_id":"brand_4x0wr3g0000g00400000000004","status":"ready","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"},"metadata":{"request_id":"request_01k6z8m2a4b5c6d7e8f9g0h1j2","resolution":{"type":"domain","value":"stripe.com","method":"direct","context":{}}}},"examples":{"Example":{"title":"Example","value":{"data":{"object":"image","kind":"logo","brand_id":"brand_4x0wr3g0000g00400000000004","status":"ready","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"},"metadata":{"request_id":"request_01k6z8m2a4b5c6d7e8f9g0h1j2","resolution":{"type":"domain","value":"stripe.com","method":"direct","context":{}}}}}},"exampleType":"examples"}},"exampleType":"examples"},"d049dc35-5b74-4225-8d11-11ca47e7af1f":{"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":"image","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":"image","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"},"b166c723-4555-4df4-8218-6312d35b8418":{"description":"Send exactly one identifier, in a valid format.","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":"exactly one of domain, ticker, isin, crypto, name, merchant is required"},"docs_url":"https://www.logo.dev/docs/platform/errors"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"exactly one of domain, ticker, isin, crypto, name, merchant is required"},"docs_url":"https://www.logo.dev/docs/platform/errors"}}},"exampleType":"examples"}},"exampleType":"examples"},"0f829052-77c4-4baa-b690-503fd6066721":{"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"},"8ad9d6ee-1149-4ce8-b7a7-fb5d37c9bdfc":{"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"},"7714f856-34bd-4497-9ce1-7f070eec56d2":{"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"},"4f8f569e-ac55-4738-be79-24db9e5297a8":{"description":"No brand matches, or the brand has no logo.","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":"image","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":"image","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"},"2646a300-2779-40a5-9df7-30b622789151":{"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"},"e87ed056-975a-4931-813b-ad776b857714":{"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":{"3f92163e-dd85-4fab-bd61-93f0eafe7b21":{"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 logo - Logo.dev","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T00:24:21.927Z","originalFileLocation":"api-reference/logos/get-a-logo.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=\"Get a brand\u0026#x27;s logo with a temporary download URL, dimensions, and blurhash.\">\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 logo - Logo.dev\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a brand\u0026#x27;s logo with a temporary download URL, dimensions, and blurhash.\">\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/logos/get-a-logo\">\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=Logo\u0026amp;title=Get+a+logo\u0026amp;description=Get+a+brand%27s+logo+with+a+temporary+download+URL%2C+dimensions%2C+and+blurhash.\u0026amp;theme=3b0378da97241ff015d8a070\u0026amp;signature=da23c3e7571582daa4a05d8e8f8dea144f3486e8eddf00adca7c654ca6eaf3b6\">\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 logo - Logo.dev\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a brand\u0026#x27;s logo with a temporary download URL, dimensions, and blurhash.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://simplecasual.mintlify.site/docs/_mintlify/api/og/v2?division=Logo\u0026amp;title=Get+a+logo\u0026amp;description=Get+a+brand%27s+logo+with+a+temporary+download+URL%2C+dimensions%2C+and+blurhash.\u0026amp;theme=3b0378da97241ff015d8a070\u0026amp;signature=da23c3e7571582daa4a05d8e8f8dea144f3486e8eddf00adca7c654ca6eaf3b6\">\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/logos/get-a-logo\">\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/logos/get-a-logo.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/logos/get-a-logo#webpage\",\"url\":\"https://www.logo.dev/docs/api-reference/logos/get-a-logo\",\"name\":\"Get a logo\",\"description\":\"Get a brand's logo with a temporary download URL, dimensions, and blurhash.\",\"dateModified\":\"2026-11-12T00:24:21.927Z\",\"isPartOf\":{\"@id\":\"https://www.logo.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.logo.dev/docs/api-reference/logos/get-a-logo#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.logo.dev/docs/api-reference/logos/get-a-logo#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\":\"Get a logo\",\"item\":\"https://www.logo.dev/docs/api-reference/logos/get-a-logo\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.logo.dev/docs/api-reference/logos/get-a-logo#apireference\",\"headline\":\"Get a logo\",\"name\":\"Get a logo\",\"description\":\"Get a brand's logo with a temporary download URL, dimensions, and blurhash.\",\"url\":\"https://www.logo.dev/docs/api-reference/logos/get-a-logo\",\"mainEntityOfPage\":{\"@id\":\"https://www.logo.dev/docs/api-reference/logos/get-a-logo#webpage\"},\"dateModified\":\"2026-11-12T00:24:21.927Z\",\"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/logos/get-a-logo.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","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","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"}]},{"group":"Logo","expanded":true,"pages":[{"title":"Get a logo","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","description":"Get a brand's brandmark with a temporary download URL, dimensions, and blurhash.","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 logo - 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"]}