List first-time guests
People whose check-in to an event was their first, in a date range.
GET https://cotlet.dev/api/v1/planning-center/first-timers
read
Returns the check-ins marked as a first time for the event, one row per person with the date. Visitors checked in by label only are not saved in People and are not returned. Use person_id with get_person.
Parameters
| Name | Type | Description |
|---|---|---|
| event string required | string | Check-Ins event name, for example Sunday Gathering. |
| from date | date | First day to include. |
| to date | date | Last day to include. |
Request
curl "https://cotlet.dev/api/v1/planning-center/first-timers?event=event" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("planning-center", "list_first_timers", {"event":"event"})const result = await cotlet.call('planning-center', 'list_first_timers', {"event":"event"});cotlet call planning-center list_first_timers --data '{"event":"event"}'Example response
{
"first_timers": [
{
"person_id": "51207",
"name": "Hannah Cole",
"checked_in": "2026-10-18"
},
{
"person_id": "51330",
"name": "Ben Ortiz",
"checked_in": "2026-10-18"
},
{
"person_id": "51402",
"name": "Maya Singh",
"checked_in": "2026-10-18"
}
]
}