Get Company Logo
Retrieve the logo image for any public company or ETF. The response is an image with support for custom sizing and format parameters. Use this endpoint to populate company logos on financial dashboards, portfolio trackers, watchlists, and market research tools.
You can look up a logo by ticker symbol (AAPL), CIK (0000320193), CUSIP (037833100), or ISIN (US0378331005). Ticker lookups can also include an exchange suffix (SBRY.L, 7203.T); Logos are available for all public companies on every plan.
https://api.roic.ai/v2/company/logo/{identifier}Parameters
Path Parameters
identifierstringrequiredCompany identifier — supports ticker symbol (e.g., `AAPL`), CIK, CUSIP, or ISIN. For tickers on non-US exchanges, append the exchange shortcode with a dot (e.g., `SBRY.L` for London, `7203.T` for Tokyo, `BMW.DE` for Xetra).
AAPLQuery Parameters
apikeystringrequiredYour API key for authentication.
sizenumberoptionalDesired logo image dimension in pixels. The logo is resized to fit within a square of this size while preserving aspect ratio.
128Min: 16Max: 800greyscalebooleanoptionalReturn a greyscale (black and white) version of the logo.
falseTry it yourself
Select a stock ticker symbol below to see the company logo. Supports NYSE, NASDAQ, and global exchanges.
Response
A successful request returns the raw image bytes — not JSON, and not a URL to an image. The logo is always re-encoded as WebP, whatever format the original was stored in, so the endpoint URL works directly as an image source.
The logo fits within a size × size box and keeps its aspect ratio: a square source at size=128 comes back 128×128, while a wider logo comes back 128 pixels wide and proportionally shorter. Logos are never upscaled — if the stored original is smaller than size, you get the original dimensions.
Response Headers
| Header | Value | Description |
|---|---|---|
Content-Type | image/webp | The body is always a WebP image |
Cache-Control | public, max-age=86400, stale-while-revalidate=604800 | Fresh for 1 day; a stale copy may be served for up to 7 more days while revalidating |
ETag | "af3c9b12-128-g" | Changes when the source logo, size, or greyscale value changes |
To revalidate a cached logo, send the ETag value in an If-None-Match request header. If the logo has not changed, the API returns 304 Not Modified with an empty body — keep your cached copy.
Every response also carries the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers described in Plans & Rate Limits.
Error Responses
Errors return JSON with a single error field:
{ "error": "Invalid or missing API key. Get one at https://roic.ai/account." }| Status | When |
|---|---|
401 | Missing or invalid API key |
404 | Unknown identifier, or no logo is stored for the company |
422 | Invalid query parameter, such as size above 800 |
429 | Rate limit exceeded — wait for the number of seconds in the Retry-After header |
Use Cases
- Populate company logos on financial dashboards, portfolio trackers, and watchlists
- Display stock ticker logos on brokerage or investment platforms
- Build screener result tables with company branding for visual recognition
- Generate blog posts, newsletters, or research reports with company logos embedded
- Enrich ETF and mutual fund holdings views with the underlying company logos
Exchange Coverage
View supported exchange shortcodes77 entries
Append the shortcode to the ticker when targeting a non-default exchange, for example SBRY.L or 7203.T.
| Shortcode | Exchange |
|---|---|
None | Nasdaq Stock Exchange |
None | OTC Markets Group |
.BA | Buenos Aires Stock Exchange (BYMA) |
.VI | Vienna Stock Exchange |
.AX | Australian Stock Exchange (ASX) |
.XA | Cboe Australia |
.BR | Euronext Brussels |
.SA | Sao Paolo Stock Exchange (BOVESPA) |
.CN | Canadian Securities Exchange |
.NE | Cboe Canada |
.TO | Toronto Stock Exchange (TSX) |
.V | TSX Venture Exchange (TSXV) |
.SN | Santiago Stock Exchange |
.SS | Shanghai Stock Exchange |
.SZ | Shenzhen Stock Exchange |
.CL | Colombia Stock Exchange |
.PR | Prague Stock Exchange |
.CO | Nasdaq OMX Copenhagen |
.CA | Egyptian Exchange |
.TL | Nasdaq OMX Tallinn |
.XD | Cboe Europe |
.NX | Euronext |
.HE | Nasdaq OMX Helsinki |
.PA | Euronext Paris |
.BE | Berlin Stock Exchange |
.BM | Bremen Stock Exchange |
.DU | Dusseldorf Stock Exchange |
.F | Frankfurt Stock Exchange |
.HM | Hamburg Stock Exchange |
.HA | Hanover Stock Exchange |
.MU | Munich Stock Exchange |
.SG | Stuttgart Stock Exchange |
.DE | Deutsche Boerse XETRA |
.AT | Athens Stock Exchange (ATHEX) |
.HK | Hong Kong Stock Exchange (HKEX) |
.BD | Budapest Stock Exchange |
.IC | Nasdaq OMX Iceland |
.BO | Bombay Stock Exchange |
.NS | National Stock Exchange of India |
.JK | Indonesia Stock Exchange (IDX) |
.IR | Euronext Dublin |
.TA | Tel Aviv Stock Exchange |
.TI | EuroTLX |
.MI | Italian Stock Exchange |
.T | Tokyo Stock Exchange |
.KW | Boursa Kuwait |
.RG | Nasdaq OMX Riga |
.VS | Nasdaq OMX Vilnius |
.KL | Malaysian Stock Exchange |
.MX | Mexico Stock Exchange (BMV) |
.AS | Euronext Amsterdam |
.NZ | New Zealand Stock Exchange (NZX) |
.OL | Oslo Stock Exchange |
.PS | Philippine Stock Exchange |
.WA | Warsaw Stock Exchange |
.LS | Euronext Lisbon |
.QA | Qatar Stock Exchange |
.RO | Bucharest Stock Exchange |
.SI | Singapore Stock Exchange (SGX) |
.JO | Johannesburg Stock Exchange |
.KS | Korea Stock Exchange |
.KQ | KOSDAQ |
.MC | Madrid Stock Exchange (BME) |
.SAU | Saudi Stock Exchange (Tadawul) |
.ST | Nasdaq OMX Stockholm |
.SW | Swiss Exchange (SIX) |
.TWO | Taiwan OTC Exchange |
.TW | Taiwan Stock Exchange (TWSE) |
.BK | Stock Exchange of Thailand (SET) |
.IS | Borsa İstanbul |
.AE | Dubai Financial Market |
.AQ | Aquis Exchange AQSE |
.XC | Cboe UK |
.L | London Stock Exchange |
.IL | London Stock Exchange |
.CR | Caracas Stock Exchange |
.VN | Ho Chi Minh City Stock Exchange |
Related Endpoints
- Company Profile - Get the full company profile including sector, industry, and market cap
- Company News - Get the latest news articles for the same company
- Search Tickers - Find the ticker symbol for a company by name
- List Tickers - Browse all available ticker symbols