Search ExtraServices

GET

api

billing

extraservices

curl --request GET \
  --url https://spaces.nexudus.com/api/billing/extraservices \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/billing/extraservices"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/billing/extraservices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Records": [
    {}
  ],
  "CurrentPage": 123,
  "CurrentPageSize": 123,
  "CurrentOrderField": "<string>",
  "CurrentSortDirection": 123,
  "FirstItem": 123,
  "LastItem": 123,
  "TotalItems": 123,
  "TotalPages": 123,
  "HasNextPage": true,
  "HasPreviousPage": true
}

Resource Rates (internally Extra services) are pricing rules for resource types (like meeting rooms) that define how resources are billed, including charge periods, dynamic pricing, and customer restrictions

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 ExtraService-List role.

Enums

eChargePeriod — ChargePeriod values

Value	Name
1	Minutes
2	Days
3	Weeks
4	Months
5	Uses
6	FourWeekMonths

eLastMinuteDiscountType — LastMinuteAdjustmentType values

Value	Name
1	Disabled
2	Fixed
3	Gradual

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 this resource rate belongs to.

string

Filter by resource rate name.

string

Filter by optional description of this resource rate.

string

Filter by custom text shown on invoice lines instead of the resource rate name.

boolean

Filter by whether this resource rate is listed on the website. Not currently used..

integer

Filter by sort position of this resource rate; lower values appear first.

number

Filter by base price in the selected currency per charge period; minute-based rates are prorated as an hourly price.

number

Filter by optional alternative price used when the customer pays using time credit; null uses the base price.

integer

Filter by unit used to calculate the booking cost: Minutes, Days, Weeks, Months, Uses, or FourWeekMonths.

number

Filter by optional maximum amount this rate can charge for a booking after length-based calculation.

boolean

Filter by whether this rate is preferred when multiple valid rates match the same resource and charge period.

boolean

Filter by whether day-based booking length is calculated by nights rather than elapsed 24-hour periods.

integer

Filter by iD of the currency used for prices charged by this resource rate.

string

Filter by display value for Currency.Code..

integer

Filter by iD of the standard tax rate applied to charges; may be required by location settings for rates that are not booking credits.

string

Filter by display value for TaxRate.Name..

integer

Filter by iD of the reduced tax rate applied when the customer qualifies for reduced taxation.

integer

Filter by iD of the tax rate applied when the customer is tax exempt.

integer

Filter by iD of the financial account used to record revenue; may be required by location settings for rates that are not booking credits.

string

Filter by display value for FinancialAccount.Name..

integer

Filter by legacy start hour restriction; manage availability through time slots instead.

integer

Filter by legacy end hour restriction; manage availability through time slots instead.

integer

Filter by optional minimum booking length expressed in the selected charge period.

integer

Filter by optional maximum booking length expressed in the selected charge period.

boolean

Filter by legacy availability enforcement flag; availability is determined by the configured time slots.

integer

Filter by optional initial booking duration in minutes charged at FixedCostPrice; requires FixedCostPrice.

number

Filter by fixed amount charged for the initial FixedCostLength minutes; requires FixedCostLength.

boolean

Filter by whether this rate is restricted to contacts without an active contract; cannot be true together with OnlyForMembers.

boolean

Filter by whether this rate is restricted to customers with an active contract; cannot be true together with OnlyForContacts.

boolean

Filter by whether this record defines a time credit type rather than a chargeable resource rate.

boolean

Filter by whether this record defines a printing credit type used by printing integrations.

boolean

Filter by whether the booking charge is multiplied by the number of visitors linked to the booking.

number

Filter by optional signed percentage adjustment for low demand; for example 10 increases the price by 10% and -10 discounts it by 10%. Overrides the location-wide factor.

number

Filter by optional signed percentage adjustment for average demand; for example 10 increases the price by 10% and -10 discounts it by 10%. Overrides the location-wide factor.

number

Filter by optional signed percentage adjustment for high demand; for example 10 increases the price by 10% and -10 discounts it by 10%. Overrides the location-wide factor.

number

Filter by optional signed percentage adjustment for bookings made within LastMinutePeriodMinutes; negative values discount and positive values increase the price.

integer

Filter by number of minutes before a booking starts during which PriceFactorLastMinute applies.

integer

Filter by how the last-minute adjustment is applied: Fixed applies the full factor throughout the period; Gradual increases it from zero at the period boundary to the full factor near the start time; Disabled turns it off.

string

Filter by optional date and time from which this rate is valid, inclusive.

string

Filter by optional date and time until which this rate is valid, exclusive.

string

Filter by read-only resource type names generated from ResourceTypes.

Range Filters

integer

Filter by sort position of this resource rate; lower values appear first greater than or equal to this value.

integer

Filter by sort position of this resource rate; lower values appear first less than or equal to this value.

number

Filter by base price in the selected currency per charge period; minute-based rates are prorated as an hourly price greater than or equal to this value.

number

Filter by base price in the selected currency per charge period; minute-based rates are prorated as an hourly price less than or equal to this value.

number

Filter by optional alternative price used when the customer pays using time credit; null uses the base price greater than or equal to this value.

number

Filter by optional alternative price used when the customer pays using time credit; null uses the base price less than or equal to this value.

number

Filter by optional maximum amount this rate can charge for a booking after length-based calculation greater than or equal to this value.

number

Filter by optional maximum amount this rate can charge for a booking after length-based calculation less than or equal to this value.

integer

Filter by legacy start hour restriction; manage availability through time slots instead greater than or equal to this value.

integer

Filter by legacy start hour restriction; manage availability through time slots instead less than or equal to this value.

integer

Filter by legacy end hour restriction; manage availability through time slots instead greater than or equal to this value.

integer

Filter by legacy end hour restriction; manage availability through time slots instead less than or equal to this value.

integer

Filter by optional minimum booking length expressed in the selected charge period greater than or equal to this value.

integer

Filter by optional minimum booking length expressed in the selected charge period less than or equal to this value.

integer

Filter by optional maximum booking length expressed in the selected charge period greater than or equal to this value.

integer

Filter by optional maximum booking length expressed in the selected charge period less than or equal to this value.

integer

Filter by optional initial booking duration in minutes charged at FixedCostPrice; requires FixedCostPrice greater than or equal to this value.

integer

Filter by optional initial booking duration in minutes charged at FixedCostPrice; requires FixedCostPrice less than or equal to this value.

number

Filter by fixed amount charged for the initial FixedCostLength minutes; requires FixedCostLength greater than or equal to this value.

number

Filter by fixed amount charged for the initial FixedCostLength minutes; requires FixedCostLength less than or equal to this value.

number

Filter by optional signed percentage adjustment for low demand; for example 10 increases the price by 10% and -10 discounts it by 10%. Overrides the location-wide factor greater than or equal to this value.

number

Filter by optional signed percentage adjustment for low demand; for example 10 increases the price by 10% and -10 discounts it by 10%. Overrides the location-wide factor less than or equal to this value.

number

Filter by optional signed percentage adjustment for average demand; for example 10 increases the price by 10% and -10 discounts it by 10%. Overrides the location-wide factor greater than or equal to this value.

number

Filter by optional signed percentage adjustment for average demand; for example 10 increases the price by 10% and -10 discounts it by 10%. Overrides the location-wide factor less than or equal to this value.

number

Filter by optional signed percentage adjustment for high demand; for example 10 increases the price by 10% and -10 discounts it by 10%. Overrides the location-wide factor greater than or equal to this value.

number

Filter by optional signed percentage adjustment for high demand; for example 10 increases the price by 10% and -10 discounts it by 10%. Overrides the location-wide factor less than or equal to this value.

number

Filter by optional signed percentage adjustment for bookings made within LastMinutePeriodMinutes; negative values discount and positive values increase the price greater than or equal to this value.

number

Filter by optional signed percentage adjustment for bookings made within LastMinutePeriodMinutes; negative values discount and positive values increase the price less than or equal to this value.

integer

Filter by number of minutes before a booking starts during which PriceFactorLastMinute applies greater than or equal to this value.

integer

Filter by number of minutes before a booking starts during which PriceFactorLastMinute applies less than or equal to this value.

string

Filter by optional date and time from which this rate is valid, inclusive greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by optional date and time from which this rate is valid, inclusive less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by optional date and time until which this rate is valid, exclusive greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by optional date and time until which this rate is valid, exclusive less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

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

curl -X GET \
  "https://spaces.nexudus.com/api/billing/extraservices?page=1&size=15&orderBy=Name&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://spaces.nexudus.com/api/billing/extraservices?' + new URLSearchParams({
    page: 1,
    size: 15,
    orderBy: 'Name',
    dir: 1 // Ascending
  }),
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/billing/extraservices',
    params={
        'page': 1,
        'size': 15,
        'orderBy': 'Name',
        'dir': 0 // Ascending
    },
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

data = response.json()

Filtering by Name

curl -X GET \
  "https://spaces.nexudus.com/api/billing/extraservices?ExtraService_Name=example-value&orderBy=Name&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://spaces.nexudus.com/api/billing/extraservices?' + new URLSearchParams({
    ExtraService_Name: 'example-value',
    orderBy: 'Name',
    dir: 1
  }),
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/billing/extraservices',
    params={
        'ExtraService_Name': 'example-value',
        'orderBy': 'Name',
        'dir': 0 // Ascending
    },
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

data = response.json()

Range filters

curl -X GET \
  "https://spaces.nexudus.com/api/billing/extraservices?from_ExtraService_UpdatedOn=2025-01-01T00:00&to_ExtraService_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://spaces.nexudus.com/api/billing/extraservices?' + new URLSearchParams({
    from_ExtraService_UpdatedOn: '2025-01-01T00:00',
    to_ExtraService_UpdatedOn: '2025-12-31T23:59',
    orderBy: 'UpdatedOn',
    dir: 1 // Descending
   }),
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const data = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/billing/extraservices',
    params={
        'from_ExtraService_UpdatedOn': '2025-01-01T00:00',
        'to_ExtraService_UpdatedOn': '2025-12-31T23:59',
        'orderBy': 'UpdatedOn',
        'dir': 1 // Descending
    },
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

data = response.json()

Response

200

ExtraService[]

The list of ExtraService records matching the query. See the Get one ExtraService endpoint for the full list of properties returned for each record.

Partial records — The listing endpoint returns a summary representation of each ExtraService. The following fields are not populated in the Records[] response: Description, Visible, DisplayOrder, FromTime, ToTime, OnlyWithinAvailableTimes, IsPrintingCredit.To get all fields, fetch the full record using the Get one ExtraService 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

{
  "Records": [
    {
      "BusinessId": 0,
      "Name": "",
      "InvoiceLineDisplayAs": null,
      "ResourceTypes": [],
      "Price": 0,
      "CreditPrice": null,
      "ChargePeriod": 0,
      "MaximumPrice": null,
      "IsDefaultPrice": false,
      "UsePerNightPricing": false,
      "CurrencyId": 0,
      "CurrencyCode": null,
      "TaxRateId": null,
      "TaxRateName": null,
      "ReducedTaxRateId": null,
      "ExemptTaxRateId": null,
      "FinancialAccountId": null,
      "FinancialAccountName": null,
      "MinLength": null,
      "MaxLength": null,
      "FixedCostLength": null,
      "FixedCostPrice": null,
      "Tariffs": [],
      "OnlyForContacts": false,
      "OnlyForMembers": false,
      "IsBookingCredit": false,
      "ApplyChargeToVisitors": false,
      "PriceFactorLowDemand": null,
      "PriceFactorAverageDemand": null,
      "PriceFactorHighDemand": null,
      "PriceFactorLastMinute": null,
      "LastMinutePeriodMinutes": null,
      "LastMinuteAdjustmentType": 0,
      "ApplyFrom": null,
      "ApplyTo": null,
      "ResourceTypeNames": null,
      "Teams": [],
      "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": "ExtraService 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
}

Search ExtraServices

curl --request GET \
  --url https://spaces.nexudus.com/api/billing/extraservices \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/billing/extraservices"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/billing/extraservices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Records": [
    {}
  ],
  "CurrentPage": 123,
  "CurrentPageSize": 123,
  "CurrentOrderField": "<string>",
  "CurrentSortDirection": 123,
  "FirstItem": 123,
  "LastItem": 123,
  "TotalItems": 123,
  "TotalPages": 123,
  "HasNextPage": true,
  "HasPreviousPage": true
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Enums

Query Parameters

Filters

Range Filters

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200

​Authentication

​Enums

​Query Parameters

​Pagination & Sorting

​Filters

​Range Filters

​Code Examples

​Simple listing

​Filtering by Name

​Range filters

​Response

​200

Authentication

Enums

Query Parameters

Pagination & Sorting

Filters

Range Filters

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200