```
```
## **Explicit Type Routes**
To prevent naming collisions between identifier types, we've also introduced explicit type routes with the pattern `{type}/{identifier}` where `type` can be `domain`, `ticker`, `isin`, or `crypto`. While the original routes still work with auto-detection, **we recommend using explicit type routes** for accurate results.
**Examples:**
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered when a brand is claimed by the brand owner. * **Event type**: `brand.deleted`
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered when a brand is soft-deleted. This is exceedingly rare and usually related to a take-down request by the brand's owner. * **Event type**: `brand.updated`
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered anytime a brand's data is updated. * **Event type**: `brand.company.updated`
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered anytime a brand's company data is updated. * **Event type**: `brand.verified`
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered when a brand's data is human-reviewed (by our curation team). # Overview Source: https://docs.brandfetch.com/delivery-methods/webhooks/overview Get notified of changes by receiving events at your webhook URL. ## Why use webhooks When building Brandfetch integrations, you might want your applications to receive events as they occur for brands you're interested in, so that your backend systems can execute actions accordingly. To enable webhook events, you need to [register webhook endpoints](/delivery-methods/webhooks/setup#register-your-endpoint). After you register them, Brandfetch can push real-time event data to your application’s webhook endpoint when things happen. Brandfetch uses HTTPS to send webhook payloads to your app as a JSON payload that includes an Event object. The implementation follows the v1 of the [Standard Webhooks](https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md) specification. Receiving webhook events is particularly useful for listening to asynchronous events such as when a brand’s logo changes, a company detail is updated, or when we index new data. ## Pricing and eligibility Webhooks are available on every paid plan, with no contract and no sales call. They do require an active paid subscription, either a self-serve plan or a custom contract: without one, creating a webhook is declined with the code `NO_ACTIVE_SUBSCRIPTION` and the message "Webhooks require an active paid subscription." Registering an endpoint costs nothing, and neither does receiving deliveries, however many events your brands generate. What consumes API credits is each brand you subscribe a webhook to. | Action | Cost | | --------------------------------------------------- | --------------------------------- | | Registering a webhook endpoint | Free | | Receiving event deliveries | Free, at any volume | | Subscribing a webhook to a brand | 1 API credit, charged on creation | | Holding that subscription into a new calendar month | 1 API credit per month | | Subscribing to `brandfetch.com` | Free of credits | The creation credit is consumed as soon as the subscription exists, even if you remove it moments later, and it is not pro-rated. There are no refunds, so removing a brand and adding it back charges again. A subscription you created during the current month has already paid for that month, and renews at the start of the next one.
**Christian Meisser - CEO of LEXR Law Switzerland AG** To help you stay compliant, Brandfetch provides the most up-to-date logos. If you're unsure, seek permission from the logo owner, email us, or consult a lawyer. *** *Logos are the property of their respective trademark owners. Logo usage must comply with the principles of "fair use," which allow referencing a brand without endorsement, misrepresentation, or alteration. If you're unsure, consult a legal professional.* # Migrating from Clearbit to Brandfetch Logo API Source: https://docs.brandfetch.com/guides/migrate-from-clearbit-logo-api Complete guide to replacing Clearbit's deprecated Logo API with Brandfetch
```
```html Ticker theme={null}
```
```html Crypto theme={null}
```
```html ISIN theme={null}
```
```html Auto-detection (legacy) theme={null}
```
```
```html Ticker theme={null}
```
```html Crypto theme={null}
```
```
### Logo sizing / Retina
Customize the logo’s dimensions by adding `w` (width) and `h` (height) query parameters to the URL. The ratio of the logo is always respected.
For Retina displays, double the size values for optimal display. e.g., for a 64x64 icon display, set `h=128` and `w=128`.
```html theme={null}
```
### Type variants
Request different types of logos by using the `type` path parameter.
Available variants are: `icon`, `symbol`, and `logo`.
```html theme={null}
```
### Dark and light themes
Ensure the logo looks great regardless of the background color of your application.
```html theme={null}
```
### Multiple fallbacks
Specify a fallback option to be used when the a logo is not available.
[See all fallbacks](/logo-api/parameters).
```html theme={null}
```
## Usage guidelines
```
```
```html Ticker theme={null}
```
```html ISIN theme={null}
```
```html Crypto theme={null}
```
```html Auto-detection (legacy) theme={null}
```
```
```html Ticker theme={null}
```
```html ISIN theme={null}
```
```html Crypto theme={null}
```
```html Auto-detection (legacy) theme={null}
```
```
```html Ticker theme={null}
```
```html ISIN theme={null}
```
```html Crypto theme={null}
```
```html Auto-detection (legacy) theme={null}
```
setOpen(true)}
onChange={(e: ChangeEvent) => {
setQuery(e.target.value);
setSelected(null);
setOpen(true);
}}
/>
{open && query.trim() && !selected && (
{results.length === 0 ? (
)}
{selected && (
{loading ? "Searching…" : `No brands found for “${query.trim()}”`}
) : (
results.map((r) => (
))
)}
{selected.name || selected.domain}
{selected.domain} · {selected.brandId}
Insert brand logo
) => {
setQuery(e.target.value);
setPicked(null);
}}
/>
{results.map((r) => {
const isPicked = picked?.brandId === r.brandId;
return (
);
})}
{results.length === 0 && (
{loading ? "Searching…" : query.trim() ? `No brands found for “${query.trim()}”` : "Search for a brand to see its logo"}
)}
) => setEmail(e.target.value)}
placeholder="you@company.com"
/>
{brand ? (
) : (
);
}
```
We found your company
{brand.name}
{brand.colors.map((c) => (
))}
{brand.description}
{[brand.industry, `Founded ${brand.founded}`, `${brand.employees} employees`].map((t) => (
{t}
))}
Enter a work email to personalize your workspace.
)}
Stripe
Financial infrastructure for the internet
🌐 stripe.com
👥 8,000 employees
📍 San Francisco
{ACCOUNTS.map((acc) => (
))}
);
}
```
{acc.name}
{acc.meta}
{JOBS.map((job) => (
))}
);
}
```
{job.title}
{job.company}
{DOMAINS.map((domain) => (
);
}
```
{/* theme/dark returns the dark-on-light logo; invert it to white in dark mode */}
))}
{tiles.map(({ a, b, d, i }) => (
})
})
))}
);
}
```
{track.map((domain, i) => (
))}
))}
Trusted by
{DOMAINS.map((d, i) => (
})
))}
and 20,000+ teams
);
}
```
{BRANDS.map((b) => (
))}
2026 · All hands
Q3 Business Review
{active.name} · Confidential
{active.domain}
{active.palette.map((c) => (
))}
{BRANDS.map((b) => (
))}
Welcome to {active.name} 👋
Thanks for signing up. Let's get your account set up, it only takes a minute to send your first request.
Sent by {active.name} · You can unsubscribe at any time.
{HOLDINGS.map((h) => (
))}
);
}
```
{h.symbol}
{h.name}
${h.price}
{h.change}
NVDA
NVIDIA Corp.
$4,142.10
▲ $103.50 (3.45%) today
30 shares
Avg $130.24
{TXNS.map((t) => (
))}
);
}
```
{t.merchant}
{t.raw}
-${t.amount}
{t.date}
Raw descriptor
SQ *BLUE BOTTLE COFFEE OAKLAND
↓
Recognized merchant
Blue Bottle Coffee
bluebottlecoffee.com · Food & Beverage