Fetch company logo
Retrieve a company logo as a PNG image using a known Demandbase company ID. Choose a supported size and use the returned image in account research, internal applications, or other company-data workflows.
Choose the right logo size
The endpoint supports three predefined sizes. Select the size that best matches how prominently the logo will appear in your application.
Lists and dense layouts
Use the 100-pixel asset for compact account lists, search results, tables, and other space-conscious interfaces.
Profiles and detail views
Use the 200-pixel asset as a balanced default for company profiles, account cards, and research workspaces.
Prominent presentation
Use the 400-pixel asset when the logo is displayed prominently or when your layout benefits from a larger source image.
Common requests
Fetch a compact logo
Fetch a standard logo
Fetch a large logo
Quickstart
Replace COMPANY_ID with a numeric company ID returned by Company Search, Company Match, or another B2B API workflow.
Download the image
Handle the response as an image
The example writes the response to disk
The --output company-logo.png option prevents curl from writing binary image data to your terminal.
Your application should likewise process a successful response as bytes or an image stream.
Request anatomy
Identify the company
Place the integer Demandbase company ID in the request path.
companyId |
Required company identifier |
Select an available size
Add one supported size directly after /logos/.
logoSize |
100, 200, or 400 |
Authenticate and request PNG
Send a valid bearer token and indicate that the client accepts a PNG response.
Authorization |
Bearer access token |
Accept |
image/png |
Response handling
Check the HTTP status and content type before processing the response. Success and error responses use different representations.
Process raw PNG data
Status |
200 OK |
Content-Type |
image/png |
Body |
Binary PNG image data |
Read the structured error
Content-Type |
application/json or application/xml |
errorCode |
Demandbase error identifier |
errorMessage |
Human-readable explanation |
diagnosticCode |
Identifier for troubleshooting |
Do not parse a successful response as JSON
A successful request returns image bytes directly. Configure your HTTP client to receive a byte array, stream, blob, or file rather than a JSON object.
Important rules
Use an integer company ID
The companyId path value is required and must be an integer.
Use an exact size value
The logoSize path value must be exactly 100, 200, or 400.
Not every logo size is available
A valid company ID and size do not guarantee that the requested logo asset exists. Handle a missing-logo response in your application.
Retrieve logos through an authenticated request
Include the bearer token with every request. Keep API tokens out of public repositories and client-side application code.
Parameters
| Parameter | Location | Required | Use it to | Example |
|---|---|---|---|---|
companyId |
Path | Yes | Identify the company whose logo to retrieve. | 725771 |
logoSize |
Path | Yes | Select one of the supported PNG image sizes. | 200 |
Common errors
| Status | Error | How to fix it |
|---|---|---|
400-103 |
companyId must be an integer. |
Use the numeric company ID returned by Company Search or another B2B API workflow. |
400-115 |
Invalid value for size. | Set logoSize to exactly 100, 200, or 400. |
401 |
Authentication failed. | Generate a valid token and send it in the Authorization: Bearer YOUR_ACCESS_TOKEN header. |
404-103 |
The company logo is not present. | Try another supported size or provide a fallback image when no logo is available. |
Next steps
Open the interactive logo reference, retrieve the associated company profile, or find a company ID through Company Search.
Try company logo fetch → · Company details → · Company Search →