Get gallery stats

Returns aggregated stats for a group shoot gallery.

Written by Exportlab · Updated March 2026

GET /group-shoot/checkin/{token}/stats

Returns aggregated statistics for a group shoot gallery, useful for dashboards, progress tracking, or reporting.

bash

Copied

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

json

Copied

{
  "ok": true,
  "requestId": "a1b2c3d4-...",
  "galleryToken": "iURWUkHo",
  "totalPersons": 250,
  "checkedInCount": 187,
  "checkInRate": 74.8,
  "personsWithPhotos": 156,
  "personsWithoutPhotos": 31,
  "uniquePhotosAssigned": 468,
  "totalAssignments": 512,
  "personsWithFavorites": 89,
  "totalFavorites": 102,
  "byShootingDay": [
    {
      "shootingDayId": "abc12345",
      "date": "2026-04-10",
      "label": "Team A – Morning",
      "totalPersons": 45,
      "checkedInCount": 30,
      "personsWithPhotos": 28
    }
  ],
  "unassignedPersonsCount": 10
}

Path parameter	Type	Description
token	string	The gallery token

Response field	Type	Description
totalPersons	number	Total number of persons registered for this gallery
checkedInCount	number	Persons who checked in via the self-service form
checkInRate	number	Percentage of persons checked in (0–100, one decimal)
personsWithPhotos	number	Persons with at least one assigned photo
personsWithoutPhotos	number	Persons with no photos assigned yet
uniquePhotosAssigned	number	Number of unique photos assigned across all persons
totalAssignments	number	Total photo-person assignments
personsWithFavorites	number	Persons who have at least one favorite photo set
totalFavorites	number	Total number of favorite photo marks across all persons
byShootingDay	array	Per-day breakdown. Empty array if no shooting days are configured
byShootingDay[].shootingDayId	string	Shooting day ID
byShootingDay[].date	string	Date in YYYY-MM-DD format
byShootingDay[].label	string \| null	Day label, or null if not set
byShootingDay[].totalPersons	number	Persons assigned to this day
byShootingDay[].checkedInCount	number	Persons for this day who checked in
byShootingDay[].personsWithPhotos	number	Persons for this day with at least one photo
unassignedPersonsCount	number	Persons not assigned to any shooting day (only present when gallery has shooting days)