Get a company logo

GET

https://api.aventure.vc/v1/entities/:entityId/logo

GET

/v1/entities/:entityId/logo

curl https://api.aventure.vc/v1/entities/entityId/logo

{
  "cdnUrl": "string",
  "mediaType": "ENTITY",
  "path": "string",
  "accuracy": {
    "confidence": "HIGH",
    "method": "PERCEPTUAL_HASH",
    "outcome": "MATCH",
    "reference": [
      {
        "hammingDistance": 1,
        "url": "string"
      }
    ],
    "approval": {
      "changedAt": "2024-01-15T09:30:00Z",
      "dataSourceUpdatedAt": "2024-01-15T09:30:00Z",
      "detail": "string",
      "kind": "string",
      "pendingApproval": 1,
      "sourceId": "string",
      "status": "string"
    },
    "candidateObserved": "string",
    "referenceObserved": "string",
    "sharedFeature": "string"
  },
  "firstUploadedAt": "2024-01-15T09:30:00Z",
  "provenance": {
    "changedAt": "2024-01-15T09:30:00Z",
    "dataSourceUpdatedAt": "2024-01-15T09:30:00Z",
    "detail": "string",
    "kind": "string",
    "pendingApproval": 1,
    "sourceId": "string",
    "status": "string"
  },
  "targetId": "string"
}

Returns the selected square or standard logo with its stored provenance; an empty slot returns 404. A Product or Service’s assembled core.image can show its provider’s logo; this slot and entity.logo coverage grade the entity’s own asset.

Path parameters

entityIdstringRequiredformat: "uuid"

Canonical entity UUID

Query parameters

logoTypeenumOptional

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

Allowed values:

Response headers

X-RateLimit-Limitinteger

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

X-RateLimit-Remaininginteger

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

X-RateLimit-Resetinteger

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

Response

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; absent on reads, photos, thumbnails, and brand-match overrides.

firstUploadedAtdatetime or nullOptional

Earliest recorded write timestamp for this media asset slot from res_provenance_event (when this entity/person/news first received any image in this slot).

provenanceobject or nullOptional

Latest write source for this media asset slot from res_provenance_event. changedAt is the last-modified timestamp of the current attached file.

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