Retrieve a company logo

Return a company logo as raw image bytes. You can select the output size, encoding, and greyscale treatment, then use the endpoint URL directly as an image source.

GET/v3.0.0/company/logo/{identifier}

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Parameters

Path parameters

identifierstringrequired

A company-profile ID (cmp_…), ticker ID (tkr_…), an exchange and symbol separated by a colon (e.g. NASDAQ:AAPL), or a FIGI.

Examples: NASDAQ:AAPLcmp_mN971Tvggqaf82BBG000B9XRY4

Query parameters

sizeintegeroptional

Square image size in pixels.

Default: 128Min: 16Max: 800

greyscalebooleanoptional

Remove color from the logo. Accepts only true or false.

Default: falseValues: truefalse

formatstringoptional

Image encoding. The endpoint defaults to WebP.

Default: webpValues: webppng

Request example

This request returns a 128-pixel WebP logo. Query authentication is useful when the URL must work as an image source.

curl "https://api.roic.ai/v3.0.0/company/logo/AAPL?size=128&format=webp&apikey=$ROIC_API_KEY" \
  --output apple.webp

Try it yourself

Select a ticker to preview its logo. The demo renders the same image bytes this endpoint returns.

Response

A successful request returns image/webp or image/png, not JSON. The logo keeps its aspect ratio, and the service doesn't upscale a smaller original.

Header	Meaning
`Content-Type`	Matches the requested `webp` or `png` format.
`ETag`	Identifies the exact source, size, format, and greyscale variant.
`Cache-Control`	Marks the response private for one day with seven days of stale revalidation.
`Request-Id`	Correlates this request with server traces.

Conditional requests

Send the previous ETag in If-None-Match. If the selected variant hasn't changed, the API returns 304 Not Modified with an empty body.

Error responses

Logo failures use the same JSON error envelope as every other v3 route. An unknown company or missing source logo returns 404 Not Found.

Read handle API responses for the complete failure contract.