Event
A recurring event which people may attend.
Each recurrence is an event period (which often corresponds to a week).
Event periods have event times where people may actually check in.
Example Request
curl https://api.planningcenteronline.com/check-ins/v2/events
Example Object
{
"type": "Event",
"id": "1",
"attributes": {
"app_source": "string",
"archived_at": "2000-01-01T12:00:00Z",
"created_at": "2000-01-01T12:00:00Z",
"enable_services_integration": true,
"frequency": "string",
"integration_key": "string",
"location_times_enabled": true,
"name": "string",
"pre_select_enabled": true,
"updated_at": "2000-01-01T12:00:00Z"
},
"relationships": {
"campuses": {
"data": [
{
"type": "Campus",
"id": "1"
}
]
}
}
}
Attributes
| Name | Type | Description |
|---|---|---|
app_source |
string |
Only available when requested with the |
archived_at |
date_time |
|
created_at |
date_time |
|
enable_services_integration |
boolean |
|
frequency |
string |
|
id |
primary_key |
|
integration_key |
string |
|
location_times_enabled |
boolean |
|
name |
string |
|
pre_select_enabled |
boolean |
|
updated_at |
date_time |
Relationships
| Name | Type | Association Type | Note |
|---|---|---|---|
| campuses | Campus | to_many |
Can Include
| Parameter | Value | Description | Assignable |
|---|---|---|---|
| include | attendance_types | include associated attendance_types |
Order By
| Parameter | Value | Type | Description |
|---|---|---|---|
| order | created_at | string | prefix with a hyphen (-created_at) to reverse the order |
| order | name | string | prefix with a hyphen (-name) to reverse the order |
Query By
| Name | Parameter | Type | Description | Example |
|---|---|---|---|---|
| id | where[id] |
primary_key | Query on a specific id |
?where[id]=primary_key |
| name | where[name] |
string | Query on a specific name |
?where[name]=string |
Pagination
| Name | Parameter | Type | Description |
|---|---|---|---|
| per_page | per_page | integer | how many records to return per page (min=1, max=100, default=25) |
| offset | offset | integer | get results from given offset |
Endpoints
Listing
| HTTP Method | Endpoint |
|---|---|
| GET | /check-ins/v2/events |
Reading
| HTTP Method | Endpoint |
|---|---|
| GET | /check-ins/v2/events/{id} |
Associations
| HTTP Method | Endpoint | Returns | Details | Filter By |
|---|---|---|---|---|
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/attendance_types |
AttendanceType | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/check_ins |
CheckIn |
|
|
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/current_event_times |
EventTime | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/event_labels |
EventLabel | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/event_periods |
EventPeriod | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/integration_links |
IntegrationLink | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/locations |
Location |
|
|
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/person_events |
PersonEvent |
Belongs To
| HTTP Method | Endpoint | Association | Details | Filter By |
|---|---|---|---|---|
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/attendance_types/{attendance_type_id}/event |
AttendanceType | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/check_ins/{check_in_id}/event |
CheckIn | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/event_labels/{event_label_id}/event |
EventLabel | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/check_ins/{check_in_id}/event_period/{event_period_id}/event |
EventPeriod | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/event_times/{event_time_id}/event |
EventTime | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/check_ins/{check_in_id}/locations/{location_id}/event |
Location | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/events |
Organization |
|
|
| GET | https://api.planningcenteronline.com/check-ins/v2/events/{event_id}/person_events/{person_event_id}/event |
PersonEvent | ||
| GET | https://api.planningcenteronline.com/check-ins/v2/stations/{station_id}/event |
Station |