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