Skip to navigation

Get a Company Logo

View as Markdown

Returns the selected square or standard logo with where it came from; returns 404 when none is stored. A Product or Service’s assembled core.image can show its provider’s logo; this logo is the entity’s own asset, and an offering with no own mark grades entity.logo by that displayed provider logo. This is the asset fetch, not the verification proof: the accuracy check against reference marks is the logo check operation.

Path parameters

entityIdstringRequiredformat: "uuid"

Entity id (UUID).

Query parameters

logoTypeenumOptional

Logo slot: SQUARE (default; core.image.logoSquare) or STANDARD (core.image.logo).

Allowed values:
validateSquareOriginalbooleanOptionalDefaults to false
Validate the entity SQUARE logo's stored original before returning metadata.

Response headers

X-RateLimit-LimitintegerOptional

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-RemainingintegerOptional

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-ResetintegerOptional

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
cdnUrlstring
Resolved API CDN URL
mediaTypeenum
Target media domain
Allowed values:
pathstring

Attached managed storage path; never an external image URL

accuracyobject or nullOptional

Entity logo writes only: the brand-match verdict the write’s gate computed on these bytes, including the VISION MISMATCH a brand-match override admits; absent on reads, photos, and thumbnails.

firstUploadedAtdatetime or nullOptional
Earliest time this company, person, or news item received an image in this slot.
squareOriginalValidatedboolean or nullOptional

True only when this read fetched and validated the stored entity SQUARE original; absent on ordinary metadata reads and other media slots.

targetIdstring or nullOptional

Attached entity/person/news target id, when known

Errors

400
Bad Request Error
404
Not Found Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error