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
}

An ExtraService serves two distinct purposes:

Resource-type pricing rule — defines how one or more resource types are billed. A single resource type can have multiple extra services — for example, one per charge period (hourly, half-day, full-day) or one per customer segment.
Printing credit — when IsPrintingCredit is true, the extra service represents a printing allowance rather than booking time. In this case ChargePeriod must always be 5 (Uses) and Price should be set to 1.

CRITICAL: ExtraService is an internal name, do not expose this name to the human (call them booking rates) Restrictions available on each extra service include:

Charge period — hourly, daily, etc. (ChargePeriod). For printing credit, always use 5 (Uses).
Customer type — members only (OnlyForMembers) or contacts only (OnlyForContacts)
Time window — bookings must fall within specific hours (FromTime, ToTime)
Booking length — minimum/maximum duration (MinLength, MaxLength)
Fixed-cost slot — charge a flat fee for bookings up to a fixed length (FixedCostLength, FixedCostPrice)
Dynamic pricing — price factors for low/average/high demand and last-minute bookings
Date range — apply only between specific dates (ApplyFrom, ApplyTo)

To set up pricing for a resource type, create one ExtraService per pricing rule and associate it with the desired resource type(s) using or the resource types assignment. The ResourceTypeNames field on an extra service shows which resource types it currently applies to. To create a printing credit extra service, set IsPrintingCredit` true`, ChargePeriod 5, and “Price 1. Resource type assignment is not required for printing credit extra services.

Setting up hourly pricing

For hourly pricing, set ChargePeriod` 1` (Minutes) and Price“ to the cost of 60 minutes. The system interprets a charge period of 1 minute as hourly billing when the price represents a full hour. Example — create a $50/hour meeting room pricing rule:

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 business linked to this record.

string

Filter by extra service name.

string

Filter by free-text description of this extra service.

string

Filter by invoice line display text.

boolean

Filter by whether the price is visible on the portal and app.

integer

Filter by display order.

number

Filter by unit price amount.

number

Filter by credit price.

integer

Filter by charge period.

number

Filter by maximum price cap.

boolean

Filter by use as the default price for matched resource types if more than one price applies.

boolean

Filter by use per-night pricing.

integer

Filter by iD of the currency linked to this record.

string

Filter by currency code.

integer

Filter by iD of the tax rate linked to this record.

integer

Filter by iD of the reduced tax rate linked to this record.

integer

Filter by iD of the exempt tax rate linked to this record.

integer

Filter by iD of the financial account linked to this record.

integer

Filter by start time restriction (minutes from midnight).

integer

Filter by end time restriction (minutes from midnight).

integer

Filter by minimum booking length (minutes).

integer

Filter by maximum booking length (minutes).

boolean

Filter by only apply within the resource’s available times.

integer

Filter by fixed cost booking length threshold (minutes).

number

Filter by fixed cost price applied once the threshold is reached.

boolean

Filter by only available for contacts.

boolean

Filter by only available for members.

boolean

Filter by price uses booking credits.

boolean

Filter by price uses printing credits.

boolean

Filter by apply charge to visitors.

number

Filter by price factor for low demand periods.

number

Filter by price factor for average demand periods.

number

Filter by price factor for high demand periods.

number

Filter by price factor for last-minute bookings.

integer

Filter by last-minute period threshold (minutes before booking).

integer

Filter by last-minute discount type.

string

Filter by date from which this price applies.

string

Filter by date until which this price applies.

string

Filter by comma-separated names of associated resource types.

Range Filters

integer

Filter by display order greater than or equal to this value.

integer

Filter by display order less than or equal to this value.

number

Filter by unit price amount greater than or equal to this value.

number

Filter by unit price amount less than or equal to this value.

number

Filter by credit price greater than or equal to this value.

number

Filter by credit price less than or equal to this value.

number

Filter by maximum price cap greater than or equal to this value.

number

Filter by maximum price cap less than or equal to this value.

integer

Filter by start time restriction (minutes from midnight) greater than or equal to this value.

integer

Filter by start time restriction (minutes from midnight) less than or equal to this value.

integer

Filter by end time restriction (minutes from midnight) greater than or equal to this value.

integer

Filter by end time restriction (minutes from midnight) less than or equal to this value.

integer

Filter by minimum booking length (minutes) greater than or equal to this value.

integer

Filter by minimum booking length (minutes) less than or equal to this value.

integer

Filter by maximum booking length (minutes) greater than or equal to this value.

integer

Filter by maximum booking length (minutes) less than or equal to this value.

integer

Filter by fixed cost booking length threshold (minutes) greater than or equal to this value.

integer

Filter by fixed cost booking length threshold (minutes) less than or equal to this value.

number

Filter by fixed cost price applied once the threshold is reached greater than or equal to this value.

number

Filter by fixed cost price applied once the threshold is reached less than or equal to this value.

number

Filter by price factor for low demand periods greater than or equal to this value.

number

Filter by price factor for low demand periods less than or equal to this value.

number

Filter by price factor for average demand periods greater than or equal to this value.

number

Filter by price factor for average demand periods less than or equal to this value.

number

Filter by price factor for high demand periods greater than or equal to this value.

number

Filter by price factor for high demand periods less than or equal to this value.

number

Filter by price factor for last-minute bookings greater than or equal to this value.

number

Filter by price factor for last-minute bookings less than or equal to this value.

integer

Filter by last-minute period threshold (minutes before booking) greater than or equal to this value.

integer

Filter by last-minute period threshold (minutes before booking) less than or equal to this value.

string

Filter by date from which this price applies greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date from which this price applies less than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date until which this price applies greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.

string

Filter by date until which this price applies 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, CreditPrice, FromTime, ToTime, MinLength, MaxLength, OnlyWithinAvailableTimes, FixedCostLength, FixedCostPrice, IsBookingCredit, IsPrintingCredit, ApplyChargeToVisitors.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,
      "ChargePeriod": 0,
      "MaximumPrice": null,
      "IsDefaultPrice": false,
      "UsePerNightPricing": false,
      "CurrencyId": 0,
      "CurrencyCode": null,
      "TaxRateId": null,
      "ReducedTaxRateId": null,
      "ExemptTaxRateId": null,
      "FinancialAccountId": null,
      "Tariffs": [],
      "OnlyForContacts": false,
      "OnlyForMembers": 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
}

Get one ExtraServiceRetrieve a single ExtraService record by its Id.

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

Setting up hourly pricing

Authentication

Enums

Query Parameters

Filters

Range Filters

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200

​Setting up hourly pricing

​Authentication

​Enums

​Query Parameters

​Pagination & Sorting

​Filters

​Range Filters

​Code Examples

​Simple listing

​Filtering by Name

​Range filters

​Response

​200

Setting up hourly pricing

Authentication

Enums

Query Parameters

Pagination & Sorting

Filters

Range Filters

Code Examples

Simple listing

Filtering by Name

Range filters

Response

200