Fetch Company Logo
GET
/api/companies/logo
Try Me!
Query Parameters
Response Schema
| Field | Type | Description |
|---|---|---|
| image | multipart/form | Image with company logo |
Summary
Returns the logo (in a browser-friendly image format) of the company whose slug is passed.
This endpoint is designed for read-only access and is commonly used by client applications to populate selectors such as dropdowns, filters, and search facets.
Description
The Fetch Company Logo API retrieves the logo belonging to the specified company (if one exists).
Key characteristics of this endpoint:
- Publicly accessible (no authentication required)
- One query parameter, one optional header, and no request body
- Clear separation between database errors and unexpected server failures
This endpoint serves all the company logos used throughout the application.
Endpoint
GET /api/companies/logoRequest
This endpoint accepts a singular parameter: company_slug
Parameters
| Parameters | Required | Type | Description |
|---|---|---|---|
company_slug | mandatory | string | The slug of the company whose logo you wish to download |
Headers
This endpoint accepts a singular optional header, but changing the value is highly recommended to prevent browser/terminal from hanging.
| Header | Required | Description |
|---|---|---|
Accept | optional | Defaults to application/json, but needs to be image/png for the image to not get stuck in DOM rendering |
Response Schema
Success - 200 OK
FileObjectEmpty Response
If the requested logo is not available, no download happens.
Error Codes & Response Types
404 Not Found
Returned when the requested logo does not exist on the server.
500 Internal Server Error
Returned when an unexpected server-side error occurs.
Response Body
{
"detail" : "Internal server error"
}Typical Causes
- Unhandled runtime exception
- Application-level failure.