Get photos for a person

Returns all photos assigned to a specific person with signed CDN URLs.

Written by Exportlab · Updated March 2026

GET /group-shoot/checkin/{token}/persons/{personId}/photos

Returns all photos assigned to a specific person, including signed CDN URLs for full resolution, thumbnail, and mini variants. URLs are valid for 24 hours.

If no photos are assigned yet, photos is an empty array.

bash

Copied

curl -X GET "https://api.exportlab.io/v1/group-shoot/checkin/{TOKEN}/persons/{PERSON_ID}/photos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Tenant-Slug: YOUR_TENANT"

json

Copied

{
  "ok": true,
  "requestId": "3fe4f8f8-b006-4d99-ab78-cf1b95edc102",
  "person": {
    "personId": "mZTZBszq",
    "name": "Max Mustermann",
    "employeeId": "EMP-001",
    "favoriteCount": 1
  },
  "photos": [
    {
      "filename": "5fdf5fdf-bb19-4aa1-8a0c-c6d189b66351-DSC01909.jpg",
      "isFavorite": true,
      "url": "https://cdn.exportlab.io/...",
      "thumbUrl": "https://cdn.exportlab.io/....thumb.jpg",
      "miniUrl": "https://cdn.exportlab.io/....mini.jpg",
      "width": 4000,
      "height": 6000,
      "size": 267297,
      "takenAt": "2026-03-06T12:18:27.157Z",
      "createdAt": "2026-03-06T12:18:27.049Z"
    }
  ]
}

Favorites

Favorites must be enabled per gallery in the admin settings. If disabled, isFavorite is always false and ?filter=favorites returns an empty array.

Path parameter	Type	Description
token	string	The gallery token
personId	string	The person ID from the list endpoint

Query parameter	Type	Required	Description
filter	string	No	Use favorites to return only photos marked as favorite

Photo field	Type	Description
filename	string	Original filename
isFavorite	boolean	Whether this photo is marked as favorite
url	string	Signed URL, full resolution original (valid 24h)
thumbUrl	string	Signed URL, thumbnail variant, ~512px wide (valid 24h)
miniUrl	string	Signed URL, mini variant, ~128px wide (valid 24h)
width	number \| null	Width in pixels
height	number \| null	Height in pixels
size	number \| null	File size in bytes
takenAt	ISO 8601 \| null	EXIF capture time if available
createdAt	ISO 8601	Upload timestamp