Image delivery

Beta image endpoint

GET https://brandmarks-api.brandmarks-web.workers.dev/v1/logo/{identifier}?token=YOUR_PUBLISHABLE_KEY

Use a domain, stock ticker, or stable company ID. This endpoint returns SVG by default, not JSON. For names, search first.

Parameter	Values	Default
token	Your publishable key	Required unless using a Bearer header
variant	auto, logo, mark	auto
theme	color, white, black, brand	color
format	svg, png	svg
size	Integer 1–4000	Original stored size
fallback	monogram	Unknown identifiers return 404

size selects a stored color PNG rendition; it does not resize SVGs or promise an exact PNG width. Black and brand themes are SVG only. See formats and sizing before constructing URLs.

Successful images support cross-origin loading. Error responses are JSON, so an image element needs its own error handling. See fallbacks and CORS.

Public static files

For a known file key, use static delivery without authentication. Static URLs do not accept the beta endpoint’s transformations or identifier resolution.