Returns upcoming birthdays for the organization.
Note: This endpoint will always only return the first 15 people having a birthday in the next 30 days, ordered by birthday, ascending.
| Property | Value |
|---|---|
| Product | People (pco.people, API version 2026-10-05) |
| Resource type | BirthdayPeople |
| TypeScript | People.BirthdayPeople, attributes People.BirthdayPeopleAttributes, schema People.BirthdayPeopleSchema |
| Planning Center path | /people/v2/birthday_people |
| Planning Center docs | BirthdayPeople |
How to reach it
| Client path | Returns | Filters | Create |
|---|---|---|---|
pco.people.birthday_people |
Collection | No |
From a collection, .id(birthdayPeopleId) addresses one BirthdayPeople: pco.people.birthday_people.id(birthdayPeopleId). Collections support where, include, order, and pagination; single resources have get().
Attributes
This resource has no documented attributes.
Querying
No documented where fields.
No documented order fields.
Edges
This resource has no documented edges.
Writing
| Property | Value |
|---|---|
| Create | No |
| Update | No |
| Delete | No |
Example
import type { People } from '@mackenly/planningcenterkit';
const page = await pco.people.birthday_people.perPage(25).list();
const items: People.BirthdayPeople[] = page.data;