Skip to main content
GET
Search ResourceAccessRules
A ResourceAccessRule defines overriding booking policies and restrictions for one or more resources or for all resources in a location, scoped by date/time, customer, team, plan, or other criteria. Rules are evaluated in EvaluationOrder and can optionally stop further evaluation when matched (StopEvaluationIfRuleIsMet). When a rule matches, it overrides the resource-level booking policies and restrictions for that booking. The booking-policy fields (BookInAdvanceLimit, LateBookingLimit, LateCancellationLimit, IntervalLimit, MaxBookingLength, MinBookingLength, NoReturnPolicy fields, cancellation-fee fields, and repeat-booking limits) mirror those on Resource and carry the same semantics — they override the resource-level defaults when the rule matches. SCOPE: When the rule is connected to a Business and NO Resources are selected, it applies to ALL resources within that business AND all child businesses. When the rule is connected to one or more specific Resources, it applies ONLY to those resources. Use scope fields (OnlyForMembers, OnlyForContacts, Tariffs, Teams, Members, Courses, EventCategories) to control who the rule applies to, and allowed fields (AllowedTariffs, AllowedTeams) to control who can book when the rule fires.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the ResourceAccessRule-List role.

Enums

Query Parameters

Pagination & Sorting

integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g. Name, CreatedOn).
integer
Sort direction. 0 for ascending, 1 for descending.

Filters

integer
Filter by iD of the location linked to this rule.
string
Filter by rule name.
boolean
Filter by whether this rule is currently active and evaluated during booking.
boolean
Filter by when true, this rule applies only to contacts (non-member customers).
string
Filter by date from which this rule starts being evaluated. Null means no start-date restriction.
string
Filter by date after which this rule stops being evaluated. Null means no end-date restriction.
integer
Filter by apply this rule only if the booking is within this many minutes of its start time.
integer
Filter by apply this rule only if the booking is more than this many minutes away from its start time.
number
Filter by apply this rule only if the booking price is at least this amount.
number
Filter by apply this rule only if the booking price does not exceed this amount.
number
Filter by maximum number of hours in advance a booking can be made. Null means no limit.
number
Filter by minimum lead time (in hours) required before a booking can start. Prevents last-minute bookings.
integer
Filter by cut-off in minutes before the booking start time. Cancellations after this point are considered late and may incur a fee.
integer
Filter by minimum interval (in minutes) between consecutive bookings on this resource, used as a buffer for setup or cleaning.
integer
Filter by maximum allowed duration for a single booking, in minutes.
integer
Filter by minimum allowed duration for a single booking, in minutes.
integer
Filter by count of resources this rule is currently applied to (read-only).
integer
Filter by cooldown in minutes: prevents the same user from booking this specific resource again within this window after their last booking ends.
integer
Filter by cooldown in minutes: prevents the same user from booking any resource after booking this one, for the specified window.
integer
Filter by cooldown in minutes: prevents any user from booking this resource within the specified window after the previous booking ends.
string
Filter by message shown to the user when their booking is rejected by this rule.
boolean
Filter by when true, this rule applies only to active members (coworkers with a plan).
integer
Filter by order in which this rule is evaluated relative to other rules on the same resource. Lower values are evaluated first.
boolean
Filter by when true, no further rules are evaluated after this one matches.
integer
Filter by product to charge for late cancellations when ChargeCancellationFee is true.
string
Filter by display value for CancellationFeeProduct.Name..
boolean
Filter by when true, a fee is charged for late cancellations (past the LateCancellationLimit).
integer
Filter by how the cancellation fee is calculated: Absolute (fixed amount) or Percentage (of booking cost).
number
Filter by fixed cancellation fee amount. Used when CancellationFeeType is Absolute.
number
Filter by cancellation fee as a percentage of the booking cost. Used when CancellationFeeType is Percentage.
integer
Filter by maximum number of occurrences allowed when creating a recurring booking under this rule.
integer
Filter by maximum time span (in months) over which a recurring booking series can extend under this rule.
string
Filter by read-only, comma-separated names of the plans this rule applies to.
string
Filter by read-only, comma-separated names of the teams this rule applies to.
string
Filter by read-only, comma-separated full names of the customers this rule applies to.

Range Filters

string
Filter by date from which this rule starts being evaluated. Null means no start-date restriction greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date from which this rule starts being evaluated. Null means no start-date restriction less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date after which this rule stops being evaluated. Null means no end-date restriction greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by date after which this rule stops being evaluated. Null means no end-date restriction less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
integer
Filter by apply this rule only if the booking is within this many minutes of its start time greater than or equal to this value.
integer
Filter by apply this rule only if the booking is within this many minutes of its start time less than or equal to this value.
integer
Filter by apply this rule only if the booking is more than this many minutes away from its start time greater than or equal to this value.
integer
Filter by apply this rule only if the booking is more than this many minutes away from its start time less than or equal to this value.
number
Filter by apply this rule only if the booking price is at least this amount greater than or equal to this value.
number
Filter by apply this rule only if the booking price is at least this amount less than or equal to this value.
number
Filter by apply this rule only if the booking price does not exceed this amount greater than or equal to this value.
number
Filter by apply this rule only if the booking price does not exceed this amount less than or equal to this value.
number
Filter by maximum number of hours in advance a booking can be made. Null means no limit greater than or equal to this value.
number
Filter by maximum number of hours in advance a booking can be made. Null means no limit less than or equal to this value.
number
Filter by minimum lead time (in hours) required before a booking can start. Prevents last-minute bookings greater than or equal to this value.
number
Filter by minimum lead time (in hours) required before a booking can start. Prevents last-minute bookings less than or equal to this value.
integer
Filter by cut-off in minutes before the booking start time. Cancellations after this point are considered late and may incur a fee greater than or equal to this value.
integer
Filter by cut-off in minutes before the booking start time. Cancellations after this point are considered late and may incur a fee less than or equal to this value.
integer
Filter by minimum interval (in minutes) between consecutive bookings on this resource, used as a buffer for setup or cleaning greater than or equal to this value.
integer
Filter by minimum interval (in minutes) between consecutive bookings on this resource, used as a buffer for setup or cleaning less than or equal to this value.
integer
Filter by maximum allowed duration for a single booking, in minutes greater than or equal to this value.
integer
Filter by maximum allowed duration for a single booking, in minutes less than or equal to this value.
integer
Filter by minimum allowed duration for a single booking, in minutes greater than or equal to this value.
integer
Filter by minimum allowed duration for a single booking, in minutes less than or equal to this value.
integer
Filter by count of resources this rule is currently applied to (read-only) greater than or equal to this value.
integer
Filter by count of resources this rule is currently applied to (read-only) less than or equal to this value.
integer
Filter by cooldown in minutes: prevents the same user from booking this specific resource again within this window after their last booking ends greater than or equal to this value.
integer
Filter by cooldown in minutes: prevents the same user from booking this specific resource again within this window after their last booking ends less than or equal to this value.
integer
Filter by cooldown in minutes: prevents the same user from booking any resource after booking this one, for the specified window greater than or equal to this value.
integer
Filter by cooldown in minutes: prevents the same user from booking any resource after booking this one, for the specified window less than or equal to this value.
integer
Filter by cooldown in minutes: prevents any user from booking this resource within the specified window after the previous booking ends greater than or equal to this value.
integer
Filter by cooldown in minutes: prevents any user from booking this resource within the specified window after the previous booking ends less than or equal to this value.
integer
Filter by order in which this rule is evaluated relative to other rules on the same resource. Lower values are evaluated first greater than or equal to this value.
integer
Filter by order in which this rule is evaluated relative to other rules on the same resource. Lower values are evaluated first less than or equal to this value.
number
Filter by fixed cancellation fee amount. Used when CancellationFeeType is Absolute greater than or equal to this value.
number
Filter by fixed cancellation fee amount. Used when CancellationFeeType is Absolute less than or equal to this value.
number
Filter by cancellation fee as a percentage of the booking cost. Used when CancellationFeeType is Percentage greater than or equal to this value.
number
Filter by cancellation fee as a percentage of the booking cost. Used when CancellationFeeType is Percentage less than or equal to this value.
integer
Filter by maximum number of occurrences allowed when creating a recurring booking under this rule greater than or equal to this value.
integer
Filter by maximum number of occurrences allowed when creating a recurring booking under this rule less than or equal to this value.
integer
Filter by maximum time span (in months) over which a recurring booking series can extend under this rule greater than or equal to this value.
integer
Filter by maximum time span (in months) over which a recurring booking series can extend under this rule less than or equal to this value.
string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200

ResourceAccessRule[]
The list of ResourceAccessRule records matching the query. See the Get one ResourceAccessRule endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each ResourceAccessRule. The following fields are not populated in the Records[] response: CancellationFeeType, CancellationFeeAmount, CancellationFeePercentage.To get all fields, fetch the full record using the Get one ResourceAccessRule endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (0 = ascending, 1 = descending).
integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response