A room or resource request for a specific event.
| Property | Value |
|---|---|
| Product | Calendar (pco.calendar, API version 2026-06-22) |
| Resource type | EventResourceRequest |
| TypeScript | Calendar.EventResourceRequest, attributes Calendar.EventResourceRequestAttributes, schema Calendar.EventResourceRequestSchema |
| Planning Center path | /calendar/v2/event_resource_requests |
| Planning Center docs | EventResourceRequest |
How to reach it
| Client path | Returns | Filters | Create |
|---|---|---|---|
pco.calendar.event_resource_requests |
Collection | No | |
pco.calendar.events.id(eventId).event_resource_requests |
Collection | No | |
pco.calendar.people.id(personId).event_resource_requests |
Collection | awaiting_response, future, not_in_conflict, not_overbooked, overbooked |
No |
pco.calendar.resources.id(resourceId).event_resource_requests |
Collection | No | |
pco.calendar.resource_approval_groups.id(resourceApprovalGroupId).event_resource_requests |
Collection | awaiting_response, future, not_in_conflict, not_overbooked, overbooked |
No |
pco.calendar.resource_bookings.id(resourceBookingId).event_resource_request |
Collection | No |
From a collection, .id(eventResourceRequestId) addresses one EventResourceRequest: pco.calendar.event_resource_requests.id(eventResourceRequestId). Collections support where, include, order, and pagination; single resources have get().
Attributes
On Calendar.EventResourceRequestAttributes. Every resource also has id and type ('EventResourceRequest') next to its attributes.
| Name | Type | Description |
|---|---|---|
approval_sent |
boolean | null |
Whether or not an email has been sent to request approval |
approval_status |
string | null |
See details. |
created_at |
string | null |
UTC time at which request was created |
notes |
string | null |
Additional information about the room or resource request |
quantity |
number | null |
How many of the rooms or resources are being requested |
updated_at |
string | null |
UTC time at which request was updated |
visible_on_kiosks |
boolean | null |
Whether this resource request is visible on kiosks |
Attribute details
approval_status
Possible values:
A: approvedP: pendingR: rejected
Relationships and includes
Side-load with include() (or get({ include })) and read with related(resource, name): created_by, event, resource, room_setup, updated_by.
| Relationship | Type | To | Includable |
|---|---|---|---|
created_by |
To one | Person | Yes |
event |
To one | Event | Yes |
event_resource_request |
To one | EventResourceRequest | No |
resource |
To one | Resource | Yes |
room_setup |
To one | RoomSetup | Yes |
updated_by |
To one | Person | Yes |
Querying
Where
where(field, value) for equality; where(field, op, value) with the operators listed.
| Field | Value type | Operators |
|---|---|---|
approval_sent |
boolean |
Equality only |
approval_status |
string |
Equality only |
created_at |
string | Date |
gt, gte, lt, lte |
updated_at |
string | Date |
gt, gte, lt, lte |
No documented order fields.
Filters
filter(...) names depend on the edge you query through:
| Edge | Filters |
|---|---|
event_resource_requests on Person |
awaiting_response, future, not_in_conflict, not_overbooked, overbooked |
event_resource_requests on ResourceApprovalGroup |
awaiting_response, future, not_in_conflict, not_overbooked, overbooked |
Edges
Follow these from one EventResourceRequest, ref = pco.calendar.event_resource_requests.id(eventResourceRequestId):
| Edge | Leads to | Returns | Filters | Create |
|---|---|---|---|---|
ref.answers |
EventResourceAnswer | Collection | No | |
ref.created_by |
Person | Collection | No | |
ref.event |
Event | Collection | No | |
ref.resource |
Resource | Collection | No | |
ref.resource_bookings |
ResourceBooking | Collection | approved, approved_conflict, approved_pending, approved_pending_conflict, approved_pending_rejected, approved_pending_rejected_conflict, approved_rejected, approved_rejected_conflict, conflict, future, pending, pending_conflict, pending_rejected, pending_rejected_conflict, rejected, rejected_conflict |
No |
ref.room_setup |
RoomSetup | Collection | No | |
ref.updated_by |
Person | Collection | No |
Writing
| Property | Value |
|---|---|
| Create | No |
| Update | No |
| Delete | No |
Example
import type { Calendar } from '@mackenly/planningcenterkit';
const page = await pco.calendar.event_resource_requests.perPage(25).list();
const items: Calendar.EventResourceRequest[] = page.data;