API
⌘K
My Developer Account

ResourceApprovalGroup

A group of people that can be attached to a room or resource in order to require their approval for booking.

Example Request

curl https://api.planningcenteronline.com/calendar/v2/resource_approval_groups

View in API Explorer →

Example Object

{
  "type": "ResourceApprovalGroup",
  "id": "1",
  "attributes": {
    "created_at": "2000-01-01T12:00:00Z",
    "form_count": 1,
    "name": "string",
    "resource_count": 1,
    "room_count": 1,
    "updated_at": "2000-01-01T12:00:00Z"
  },
  "relationships": {}
}

Attributes

Name Type Description
created_at date_time UTC time at which the approval group was created
form_count integer Only available when requested with the `?fields` param
id primary_key Unique identifier for the approval group
name string Name of the approval group
resource_count integer The number of resources in the approval group Only available when requested with the `?fields` param
room_count integer The number of rooms in the approval group Only available when requested with the `?fields` param
updated_at date_time UTC time at which the approval group was updated

Can Include

Parameter Value Description Assignable
include people include associated people
include resources include associated resources

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
order updated_at string prefix with a hyphen (-updated_at) to reverse the order

Query By

Name Parameter Type Description Example
created_at where[created_at] date_time Query on a specific created_at ?where[created_at]=2000-01-01T12:00:00Z
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
updated_at where[updated_at] date_time Query on a specific updated_at ?where[updated_at]=2000-01-01T12:00:00Z

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 /calendar/v2/resource_approval_groups

Reading

HTTP Method Endpoint
GET /calendar/v2/resource_approval_groups/{id}

Associations

HTTP Method Endpoint Returns Details Filter By
GET https://api.planningcenteronline.com/calendar/v2/resource_approval_groups/{resource_approval_group_id}/event_resource_requests EventResourceRequest
  • awaiting_response
  • future
  • not_in_conflict
  • not_overbooked
  • overbooked
GET https://api.planningcenteronline.com/calendar/v2/resource_approval_groups/{resource_approval_group_id}/people Person
GET https://api.planningcenteronline.com/calendar/v2/resource_approval_groups/{resource_approval_group_id}/required_approvals RequiredApproval
  • resources
  • rooms
GET https://api.planningcenteronline.com/calendar/v2/resource_approval_groups/{resource_approval_group_id}/resources Resource
  • resources
  • rooms

Belongs To

HTTP Method Endpoint Association Details Filter By
GET https://api.planningcenteronline.com/calendar/v2/resource_approval_groups Organization
GET https://api.planningcenteronline.com/calendar/v2/resources/{resource_id}/resource_approval_groups Resource