---
title: "Attendance (Groups)"
description: "Individual event attendance for a person."
---

> 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.

# Attendance (Groups)

Individual event attendance for a person.

| Property | Value |
| --- | --- |
| Product | [Groups](/reference/groups/) (`pco.groups`, API version `2026-11-10`) |
| Resource type | `Attendance` |
| TypeScript | `Groups.Attendance`, attributes `Groups.AttendanceAttributes`, schema `Groups.AttendanceSchema` |
| Planning Center path | `/groups/v2/events/{event_id}/attendances` |
| Planning Center docs | [Attendance](https://api.planningcenteronline.com/docs/apps/groups/versions/2026-11-10/vertices/attendance) |

## How to reach it

| Client path | Returns | Filters | Create |
| --- | --- | --- | --- |
| `pco.groups.events.id(eventId).attendances` | Collection | `attended` | No |

From a collection, `.id(attendanceId)` addresses one Attendance: `pco.groups.events.id(eventId).attendances.id(attendanceId)`. Collections support [`where`, `include`, `order`, and pagination](/guides/querying/); single resources have `get()`.

## Attributes

On `Groups.AttendanceAttributes`. Every resource also has `id` and `type` (`'Attendance'`) next to its attributes.

| Name | Type | Description |
| --- | --- | --- |
| `attended` | `boolean \| null` | Whether or not the person attended the event. |
| `role` | `string \| null` | See [details](#role). |

### Attribute details

#### `role` {#role}

The role of the person at the time of event.

Possible values: `member`, `leader`, `visitor`, or `applicant`

## Relationships and includes

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

| Relationship | Type | To | Includable |
| --- | --- | --- | --- |
| `event` | To one | [Event](/reference/groups/event/) | No |
| `person` | To one | [Person](/reference/groups/person/) | Yes |

## Querying

### Where

`where(field, value)` for equality; `where(field, op, value)` with the operators listed.

| Field | Value type | Operators |
| --- | --- | --- |
| `role` | `string` | Equality only |

### Order

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

### Filters

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

| Edge | Filters |
| --- | --- |
| `attendances` on [Event](/reference/groups/event/) | `attended` |

## Edges

Follow these from one Attendance, `ref = pco.groups.events.id(eventId).attendances.id(attendanceId)`:

| Edge | Leads to | Returns | Filters | Create |
| --- | --- | --- | --- | --- |
| `ref.person` | [Person](/reference/groups/person/) | Collection |  | No |

## Writing

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

## Example

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

const eventId = '1'; // Event id

const page = await pco.groups.events.id(eventId).attendances.order('first_name').perPage(25).list();
const items: Groups.Attendance[] = page.data;
```

Source: https://planningcenterkit.mackenly.com/reference/groups/attendance/index.mdx
