List persons

Returns all participants registered for a group shoot gallery.

Written by Exportlab · Updated March 2026

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

Returns all participants registered for a group shoot gallery.

When nextCursor is null, you have reached the last page.

bash

Copied

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

json

Copied

{
  "ok": true,
  "galleryToken": "iURWUkHo",
  "requestId": "6322678e-7898-43eb-baeb-5de42b07ca7f",
  "total": 250,
  "limit": 100,
  "nextCursor": "MTAw",
  "persons": [
    {
      "personId": "mZTZBszq",
      "name": "Max Mustermann",
      "email": "max@example.com",
      "employeeId": "EMP-001",
      "shootingDayId": "day-abc123",
      "selectedPackageId": "pkg-xyz456",
      "code": "LWR7",
      "photoCount": 3,
      "checkedInAt": "2026-03-06T13:27:11.409Z",
      "createdAt": "2026-03-06T13:27:11.409Z",
      "customFields": {
        "custom-a1b2c3d4-...": "L"
      }
    }
  ]
}

Path parameter	Type	Description
token	string	The gallery token (visible in the admin URL)

Query parameter	Type	Required	Description
employeeId	string	No	Filter to return only the person with this employee ID
shootingDayId	string	No	Filter to return only persons assigned to this shooting day ID
limit	number	No	Page size, 1-100. Default: 100
cursor	string	No	Pagination cursor from the previous response's nextCursor

Person field	Type	Description
personId	string	Unique person ID within this gallery
name	string	Full name
email	string \| null	Email address if provided at check-in
employeeId	string \| null	HR system employee ID if provided
shootingDayId	string \| null	ID of the assigned shooting day. null if no day is assigned
selectedPackageId	string \| null	ID of the selected package, if any
code	string	4-character personal access code (example: LWR7)
photoCount	number	Number of photos assigned to this person
checkedInAt	ISO 8601 \| null	When the person checked in. null if added manually by admin
createdAt	ISO 8601	When the record was created
customFields	object \| —	Key-value map of custom form field responses (only present when configured)