---
title: "Attendee (Registrations)"
description: "An Attendee is a person registered for a signup."
---

> Documentation Index
> Fetch the complete documentation index at: https://planningcenterkit.mackenly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Attendee (Registrations)

An `Attendee` is a person registered for a signup.

| Property | Value |
| --- | --- |
| Product | [Registrations](/reference/registrations/) (`pco.registrations`, API version `2025-05-01`) |
| Resource type | `Attendee` |
| TypeScript | `Registrations.Attendee`, attributes `Registrations.AttendeeAttributes`, schema `Registrations.AttendeeSchema` |
| Planning Center path | `/registrations/v2/attendees` |
| Planning Center docs | [Attendee](https://api.planningcenteronline.com/docs/apps/registrations/versions/2025-05-01/vertices/attendee) |

## How to reach it

| Client path | Returns | Filters | Create |
| --- | --- | --- | --- |
| `pco.registrations.attendees` | Collection |  | No |
| `pco.registrations.signups.id(signupId).attendees` | Collection | `active`, `canceled`, `waitlist` | No |

From a collection, `.id(attendeeId)` addresses one Attendee: `pco.registrations.attendees.id(attendeeId)`. Collections support [`where`, `include`, `order`, and pagination](/guides/querying/); single resources have `get()`.

## Attributes

On `Registrations.AttendeeAttributes`. Every resource also has `id` and `type` (`'Attendee'`) next to its attributes.

| Name | Type | Description |
| --- | --- | --- |
| `active` | `boolean \| null` | Whether or not the attendee is active. |
| `canceled` | `boolean \| null` | Whether or not the attendee is canceled. |
| `complete` | `boolean \| null` | See [details](#complete). |
| `created_at` | `string \| null` |  |
| `name` | `string \| null` | See [details](#name). |
| `updated_at` | `string \| null` |  |
| `waitlisted` | `boolean \| null` | Whether or not the attendee is waitlisted. |
| `waitlisted_at` | `string \| null` | UTC time at which the attendee was waitlisted. |

### Attribute details

#### `complete` {#complete}

Whether or not attendee has completed all necessary items (personal information, questions, forms, add ons).

Only available when requested with the `?fields` param

#### `name` {#name}

The attendee's name. Derived from the associated person record.

Only available when requested with the `?fields` param

## Relationships and includes

Side-load with `include()` (or `get({ include })`) and read with `related(resource, name)`: `emergency_contact`, `person`, `registration`, `selection_type`.

## Querying

No documented `where` fields.

### Order

`order(...)` accepts these fields, ascending, or descending with a `-` prefix: `created_at`.

### Filters

`filter(...)` names depend on the edge you query through:

| Edge | Filters |
| --- | --- |
| `attendees` on [Signup](/reference/registrations/signup/) | `active`, `canceled`, `waitlist` |

## Edges

Follow these from one Attendee, `ref = pco.registrations.attendees.id(attendeeId)`:

| Edge | Leads to | Returns | Filters | Create |
| --- | --- | --- | --- | --- |
| `ref.emergency_contact` | [EmergencyContact](/reference/registrations/emergency-contact/) | Collection |  | No |
| `ref.person` | [Person](/reference/registrations/person/) | Collection |  | No |
| `ref.registration` | [Registration](/reference/registrations/registration/) | Collection |  | No |
| `ref.selection_type` | [SelectionType](/reference/registrations/selection-type/) | Collection |  | No |

## Writing

| Property | Value |
| --- | --- |
| Create | No |
| Update | No |
| Delete | No |

## Example

```ts
import type { Registrations } from '@mackenly/planningcenterkit';

const page = await pco.registrations.attendees.order('created_at').perPage(25).list();
const items: Registrations.Attendee[] = page.data;
```

Source: https://planningcenterkit.mackenly.com/reference/registrations/attendee/index.mdx
