Errors & troubleshooting

HTTP	Code	Action
400	bad_request	Check parameters and identifier encoding; search limits must be whole numbers from 1–50; black/brand themes require SVG
401	missing_key	Supply a publishable token or secret Bearer header
401	invalid_key	Check key spelling, revocation, and account access
401	unauthorized	Sign in again or request a fresh one-time account link
403	secret_key_required	Move JSON requests to your server with an sk_ key
403	domain_not_allowed	Check the configured allowed domain and referrer
404	not_found	Verify identifier, route, and asset availability
405	method_not_allowed	Use GET
429	rate_limited	Wait for Retry-After before a bounded retry
429	quota_exceeded	The account used its monthly requests; resume after the UTC month reset in Retry-After
500	internal	Retry briefly; contact support if persistent

The beta API returns { "error": { "code": "…", "message": "…" } }. Static host errors have a different response format.

A logo looks blank or blurry

White art disappears on white backgrounds: choose a dark surface or theme=color. Use SVG in compatible apps and a sufficiently large PNG for email. Keep object-fit: contain and avoid stretching a full logo into a square.

The wrong company appears

Look up company metadata, inspect its domain and tickers, and save its stable ID. For unresolved ambiguity or outdated artwork, use claim or correct a logo.

A spreadsheet shows an error

Use a public PNG URL, verify the exact file key, and open the URL directly. Check your spreadsheet’s external-image permissions. SVG support differs from browser image support.