Get person photo

GET

https://api.aventure.vc/v1/people/:personId/photo

GET

/v1/people/:personId/photo

curl https://api.aventure.vc/v1/people/personId/photo

{
  "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 person’s attached photo with its stored provenance; an empty slot returns 404, so read presence from core.image.picture and core.image.isMonogram on people get.

Path parameters

personIdstringRequiredformat: "uuid"

Canonical person UUID

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