> ## Documentation Index > Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt > Use this file to discover all available pages before exploring further. # Search ResourceAccessRules > Search and list ResourceAccessRule records with filtering, sorting, and pagination. 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 | Value | Name | | - | - | | 1 | Absolute | | 2 | Percentage | ## Query Parameters ### Pagination & Sorting The page number to retrieve. The number of records per page. The property name to sort results by (e.g. `Name`, `CreatedOn`). Sort direction. `0` for ascending, `1` for descending. ### Filters Filter by iD of the location linked to this rule. Filter by rule name. Filter by whether this rule is currently active and evaluated during booking. Filter by when true, this rule applies only to contacts (non-member customers). Filter by date from which this rule starts being evaluated. Null means no start-date restriction. Filter by date after which this rule stops being evaluated. Null means no end-date restriction. Filter by apply this rule only if the booking is within this many minutes of its start time. Filter by apply this rule only if the booking is more than this many minutes away from its start time. Filter by apply this rule only if the booking price is at least this amount. Filter by apply this rule only if the booking price does not exceed this amount. Filter by maximum number of hours in advance a booking can be made. Null means no limit. Filter by minimum lead time (in hours) required before a booking can start. Prevents last-minute bookings. Filter by cut-off in minutes before the booking start time. Cancellations after this point are considered late and may incur a fee. Filter by minimum interval (in minutes) between consecutive bookings on this resource, used as a buffer for setup or cleaning. Filter by maximum allowed duration for a single booking, in minutes. Filter by minimum allowed duration for a single booking, in minutes. Filter by count of resources this rule is currently applied to (read-only). Filter by cooldown in minutes: prevents the same user from booking this specific resource again within this window after their last booking ends. Filter by cooldown in minutes: prevents the same user from booking any resource after booking this one, for the specified window. Filter by cooldown in minutes: prevents any user from booking this resource within the specified window after the previous booking ends. Filter by message shown to the user when their booking is rejected by this rule. Filter by when true, this rule applies only to active members (coworkers with a plan). Filter by order in which this rule is evaluated relative to other rules on the same resource. Lower values are evaluated first. Filter by when true, no further rules are evaluated after this one matches. Filter by product to charge for late cancellations when ChargeCancellationFee is true. Filter by display value for CancellationFeeProduct.Name.. Filter by when true, a fee is charged for late cancellations (past the LateCancellationLimit). Filter by how the cancellation fee is calculated: Absolute (fixed amount) or Percentage (of booking cost). Filter by fixed cancellation fee amount. Used when CancellationFeeType is Absolute. Filter by cancellation fee as a percentage of the booking cost. Used when CancellationFeeType is Percentage. Filter by maximum number of occurrences allowed when creating a recurring booking under this rule. Filter by maximum time span (in months) over which a recurring booking series can extend under this rule. Filter by read-only, comma-separated names of the plans this rule applies to. Filter by read-only, comma-separated names of the teams this rule applies to. Filter by read-only, comma-separated full names of the customers this rule applies to. ### Range Filters 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`. 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`. 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`. 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`. 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. 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. 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. 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. Filter by apply this rule only if the booking price is at least this amount greater than or equal to this value. Filter by apply this rule only if the booking price is at least this amount less than or equal to this value. Filter by apply this rule only if the booking price does not exceed this amount greater than or equal to this value. Filter by apply this rule only if the booking price does not exceed this amount less than or equal to this value. Filter by maximum number of hours in advance a booking can be made. Null means no limit greater than or equal to this value. Filter by maximum number of hours in advance a booking can be made. Null means no limit less than or equal to this value. Filter by minimum lead time (in hours) required before a booking can start. Prevents last-minute bookings greater than or equal to this value. Filter by minimum lead time (in hours) required before a booking can start. Prevents last-minute bookings less than or equal to this value. 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. 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. 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. 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. Filter by maximum allowed duration for a single booking, in minutes greater than or equal to this value. Filter by maximum allowed duration for a single booking, in minutes less than or equal to this value. Filter by minimum allowed duration for a single booking, in minutes greater than or equal to this value. Filter by minimum allowed duration for a single booking, in minutes less than or equal to this value. Filter by count of resources this rule is currently applied to (read-only) greater than or equal to this value. Filter by count of resources this rule is currently applied to (read-only) less than or equal to this value. 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. 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. 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. 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. 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. 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. 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. 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. Filter by fixed cancellation fee amount. Used when CancellationFeeType is Absolute greater than or equal to this value. Filter by fixed cancellation fee amount. Used when CancellationFeeType is Absolute less than or equal to this value. Filter by cancellation fee as a percentage of the booking cost. Used when CancellationFeeType is Percentage greater than or equal to this value. Filter by cancellation fee as a percentage of the booking cost. Used when CancellationFeeType is Percentage less than or equal to this value. Filter by maximum number of occurrences allowed when creating a recurring booking under this rule greater than or equal to this value. Filter by maximum number of occurrences allowed when creating a recurring booking under this rule less than or equal to this value. 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. 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. Filter records created on or after this date. Format: `YYYY-MM-DDTHH:mm`. Filter records created on or before this date. Format: `YYYY-MM-DDTHH:mm`. Filter records updated on or after this date. Format: `YYYY-MM-DDTHH:mm`. Filter records updated on or before this date. Format: `YYYY-MM-DDTHH:mm`. ## Code Examples ### Simple listing ```bash cURL theme={null} curl -X GET \ "https://spaces.nexudus.com/api/spaces/resourceaccessrules?page=1&size=15&orderBy=Name&dir=0" \ -H "Authorization: Bearer YOUR_TOKEN" ``` ```javascript JavaScript theme={null} const response = await fetch( 'https://spaces.nexudus.com/api/spaces/resourceaccessrules?' + new URLSearchParams({ page: 1, size: 15, orderBy: 'Name', dir: 1 // Ascending }), { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } } ); const data = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://spaces.nexudus.com/api/spaces/resourceaccessrules', params={ 'page': 1, 'size': 15, 'orderBy': 'Name', 'dir': 0 // Ascending }, headers={ 'Authorization': 'Bearer YOUR_TOKEN' } ) data = response.json() ``` ### Filtering by Name ```bash cURL theme={null} curl -X GET \ "https://spaces.nexudus.com/api/spaces/resourceaccessrules?ResourceAccessRule_Name=example-value&orderBy=Name&dir=0" \ -H "Authorization: Bearer YOUR_TOKEN" ``` ```javascript JavaScript theme={null} const response = await fetch( 'https://spaces.nexudus.com/api/spaces/resourceaccessrules?' + new URLSearchParams({ ResourceAccessRule_Name: 'example-value', orderBy: 'Name', dir: 1 }), { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } } ); const data = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://spaces.nexudus.com/api/spaces/resourceaccessrules', params={ 'ResourceAccessRule_Name': 'example-value', 'orderBy': 'Name', 'dir': 0 // Ascending }, headers={ 'Authorization': 'Bearer YOUR_TOKEN' } ) data = response.json() ``` ### Range filters ```bash cURL theme={null} curl -X GET \ "https://spaces.nexudus.com/api/spaces/resourceaccessrules?from_ResourceAccessRule_UpdatedOn=2025-01-01T00:00&to_ResourceAccessRule_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=0" \ -H "Authorization: Bearer YOUR_TOKEN" ``` ```javascript JavaScript theme={null} const response = await fetch( 'https://spaces.nexudus.com/api/spaces/resourceaccessrules?' + new URLSearchParams({ from_ResourceAccessRule_UpdatedOn: '2025-01-01T00:00', to_ResourceAccessRule_UpdatedOn: '2025-12-31T23:59', orderBy: 'UpdatedOn', dir: 1 // Descending }), { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } } ); const data = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://spaces.nexudus.com/api/spaces/resourceaccessrules', params={ 'from_ResourceAccessRule_UpdatedOn': '2025-01-01T00:00', 'to_ResourceAccessRule_UpdatedOn': '2025-12-31T23:59', 'orderBy': 'UpdatedOn', 'dir': 1 // Descending }, headers={ 'Authorization': 'Bearer YOUR_TOKEN' } ) data = response.json() ``` ## Response ### 200 The list of ResourceAccessRule records matching the query. See the [Get one ResourceAccessRule](/rest-api/spaces/get-resourceaccessrules-by-id) 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](/rest-api/spaces/get-resourceaccessrules-by-id) 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. Current page number. Number of records per page. The field used for sorting. The sort direction (`0` = ascending, `1` = descending). Index of the first item on the current page. Index of the last item on the current page. Total number of matching records across all pages. Total number of pages. Whether there is a next page of results. Whether there is a previous page of results. ```json Example Response theme={null} { "Records": [ { "BusinessId": 0, "Resources": [], "Name": "", "Active": false, "OnlyForContacts": false, "ApplyRuleFrom": null, "ApplyRuleTo": null, "ApplyIfWithinMinutesOfStart": null, "ApplyIfMoreThanMinutesFromStart": null, "ApplyIfPriceMin": null, "ApplyIfPriceMax": null, "BookInAdvanceLimit": null, "LateBookingLimit": null, "LateCancellationLimit": null, "IntervalLimit": null, "MaxBookingLength": null, "MinBookingLength": null, "AppliedResourcesCount": 0, "NoReturnPolicy": null, "NoReturnPolicyAllResources": null, "NoReturnPolicyAllUsers": null, "RejectWithMessage": null, "OnlyForMembers": false, "Tariffs": [], "AllowedTariffs": [], "Members": [], "Teams": [], "AllowedTeams": [], "EventCategories": [], "Courses": [], "EvaluationOrder": 0, "StopEvaluationIfRuleIsMet": false, "CancellationFeeProductId": null, "CancellationFeeProductName": null, "ChargeCancellationFee": false, "RepeatBookingQuantityLimit": null, "RepeatBookingPeriodLimitInMonths": null, "TariffNames": null, "TeamNames": null, "CoworkerFullNames": null, "Id": 87654321, "UpdatedOn": "2025-01-15T10:30:00Z", "CreatedOn": "2025-01-10T08:00:00Z", "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "UpdatedBy": "admin@example.com", "IsNew": false, "SystemId": null, "ToStringText": "ResourceAccessRule Example", "LocalizationDetails": null, "CustomFields": null } ], "CurrentPageSize": 15, "CurrentPage": 1, "CurrentOrderField": "Name", "CurrentSortDirection": 1, "FirstItem": 1, "HasNextPage": false, "HasPreviousPage": false, "LastItem": 1, "PageNumber": 1, "PageSize": 15, "TotalItems": 1, "TotalPages": 1 } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.