Tariffs
Search Tariffs
Search and list Tariff records with filtering, sorting, and pagination.
GET
Search Tariffs
A Tariff (also called a Plan) is a membership plan that customers can sign up to in exchange for access to a coworking space and other benefits. Tariffs are the foundation for contracts — every time a customer signs up to a plan, Nexudus generates a CoworkerContract for that member based on the plan’s settings. Plans define billing frequency (in months or weeks via InvoiceEvery / InvoiceEveryWeeks), pricing, cancellation rules, and limits on check-ins, booking minutes, visitor passes, and hours. Members are invoiced at the end of each billing cycle. Plans can include benefits such as day passes, booking credits, and money credits — these are configured through CoworkerExtraService and Product entities linked to the contract. Use SystemTariffType to categorise the plan (e.g. FullTimeHotDesk, VirtualOffice, Storage). Use Visible to control whether the plan appears on the members portal. Plans can optionally require identity checks before activation, enforce contract terms, support pausing, and define delivery handling preferences for virtual office mail. When you edit a plan, changes impact all members signed up to that plan. To customise settings for an individual member, edit their CoworkerContract instead.
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 Tariff-List role.Enums
eTariffType — SystemTariffType values
eTariffType — SystemTariffType values
eTariffBookingDueDateStrategy — BookingDueDateStrategy values
eTariffBookingDueDateStrategy — BookingDueDateStrategy values
eIdentityCheckProvider — AddressIdentityCheckProvider values
eIdentityCheckProvider — AddressIdentityCheckProvider values
eIdentityCheckRepeatPattern — AddressIdentityCheckRepeatPattern values
eIdentityCheckRepeatPattern — AddressIdentityCheckRepeatPattern values
eDeliveryHandlingPreference
eDeliveryHandlingPreference
Query Parameters
Pagination & Sorting
Filters
Filter by category of the plan: FullTimePrivateOffice, PartTimePrivateOffice, FullTimeDedicatedDesk, PartTimeDedicatedDesk, FullTimeHotDesk, PartTimeHotDesk, FullTimeOther, PartTimeOther, Storage, VirtualOffice, Virtual, or Other.
Filter by day of the month on which invoices are generated for members on this plan. Can be overriden per contract..
Filter by whether this plan is available to any AI channels (Email, Chat or WhatsApp) for recommendations for private offices;.
Filter by number of days an invoice can be due before the customer’s account is automatically suspended (contracts are not cancelled).
Filter by whether members can pause their contract on this plan. A paused member loses member status (no member-only access, policies, or pricing) but other charges besides the plan fee continue billing..
Filter by strategy for determining when booking charges are due: RenewalDate, BookingEndDate, BookingCreationDate, or NextNthOfMonth.
Filter by whether to keep the contract on hold until all required identity checks are completed.
Filter by whether to keep the contract paused if the address identity check reveals a mismatch.
Filter by how often to repeat the address identity check: Never, Every3Months, Every6Months, Every12Months, or Every24Months.
Filter by whether to request an identity (ID document) check from members signing up to this plan.
Filter by how often to repeat the identity check: Never, Every3Months, Every6Months, Every12Months, or Every24Months.
Filter by score threshold for AML checks, between 0 and 1. Matches with a score above this threshold will be considered a positive match. Default is 0.7.
Filter by handling preferences customers on this plan can select for mail deliveries (virtual office). Only included values are visible to the customer..
Filter by handling preferences customers on this plan can select for parcel deliveries (virtual office). Only included values are visible to the customer..
Filter by handling preferences customers on this plan can select for check deliveries (virtual office). Only included values are visible to the customer..
Filter by handling preferences customers on this plan can select for publicity deliveries (virtual office). Only included values are visible to the customer..
Filter by handling preferences customers on this plan can select for other deliveries (virtual office). Only included values are visible to the customer..
Filter by maximum number of days deliveries are stored before being returned (virtual office).
Range Filters
Filter by recurring price charged per billing cycle. Can be overriden per contract. greater than or equal to this value.
Filter by recurring price charged per billing cycle. Can be overriden per contract. less than or equal to this value.
Filter by day of the month on which invoices are generated for members on this plan. Can be overriden per contract. greater than or equal to this value.
Filter by day of the month on which invoices are generated for members on this plan. Can be overriden per contract. less than or equal to this value.
Filter by custom price shown to the AI assistant instead of the actual price greater than or equal to this value.
Filter by custom price shown to the AI assistant instead of the actual price less than or equal to this value.
Filter by legacy field. Do not use. Use TariffSignupProducts instead. greater than or equal to this value.
Filter by legacy field. Do not use. Use TariffSignupProducts instead. less than or equal to this value.
Filter by number of days’ notice required before a contract can be cancelled greater than or equal to this value.
Filter by number of days’ notice required before a contract can be cancelled less than or equal to this value.
Filter by display order on the members portal (lower numbers appear first) greater than or equal to this value.
Filter by display order on the members portal (lower numbers appear first) less than or equal to this value.
Filter by maximum number of members that can be signed up to this plan at any time greater than or equal to this value.
Filter by maximum number of members that can be signed up to this plan at any time less than or equal to this value.
Filter by number of days’ notice customers must give before they can cancel the contract greater than or equal to this value.
Filter by number of days’ notice customers must give before they can cancel the contract less than or equal to this value.
Filter by default minimum contract term in months for new sign-ups greater than or equal to this value.
Filter by default minimum contract term in months for new sign-ups less than or equal to this value.
Filter by number of days an invoice can be due before the customer’s account is automatically suspended (contracts are not cancelled) greater than or equal to this value.
Filter by number of days an invoice can be due before the customer’s account is automatically suspended (contracts are not cancelled) less than or equal to this value.
Filter by maximum number of check-ins included per billing cycle greater than or equal to this value.
Filter by maximum number of check-ins included per billing cycle less than or equal to this value.
Filter by maximum number of visitor passes allowed per month greater than or equal to this value.
Filter by maximum number of visitor passes allowed per month less than or equal to this value.
Filter by maximum number of visitor passes allowed per week greater than or equal to this value.
Filter by maximum number of visitor passes allowed per week less than or equal to this value.
Filter by maximum number of visitor passes allowed per day greater than or equal to this value.
Filter by maximum number of hours included per billing cycle greater than or equal to this value.
Filter by maximum number of hours included per billing cycle less than or equal to this value.
Filter by billing cycle length in months. Set to 0 if billing by weeks instead greater than or equal to this value.
Filter by billing cycle length in months. Set to 0 if billing by weeks instead less than or equal to this value.
Filter by billing cycle length in weeks. Set to 0 if billing by months instead greater than or equal to this value.
Filter by billing cycle length in weeks. Set to 0 if billing by months instead less than or equal to this value.
Filter by number of billing cycles after which the contract is automatically cancelled greater than or equal to this value.
Filter by number of billing cycles after which the contract is automatically cancelled less than or equal to this value.
Filter by number of billing cycles to invoice in advance greater than or equal to this value.
Filter by day of the month used to align billing cycles when prorating greater than or equal to this value.
Filter by day of the month used to align billing cycles when prorating less than or equal to this value.
Filter by number of days before the prorate day to start prorating greater than or equal to this value.
Filter by number of days before the prorate day to start prorating less than or equal to this value.
Filter by number of days to extend a contract after payment is received greater than or equal to this value.
Filter by number of days to extend a contract after payment is received less than or equal to this value.
Filter by minimum total amount charged per billing cycle regardless of usage greater than or equal to this value.
Filter by minimum total amount charged per billing cycle regardless of usage less than or equal to this value.
Filter by maximum number of times a contract can be paused per year greater than or equal to this value.
Filter by maximum number of times a contract can be paused per year less than or equal to this value.
Filter by maximum number of billing cycles a contract can be paused for greater than or equal to this value.
Filter by maximum number of billing cycles a contract can be paused for less than or equal to this value.
Filter by day of the month used when BookingDueDateStrategy is NextNthOfMonth greater than or equal to this value.
Filter by day of the month used when BookingDueDateStrategy is NextNthOfMonth less than or equal to this value.
Filter by calculated total price at sign-up including the plan price and sign-up fee greater than or equal to this value.
Filter by calculated total price at sign-up including the plan price and sign-up fee less than or equal to this value.
Filter by calculated total recurring price per billing cycle greater than or equal to this value.
Filter by calculated total recurring price per billing cycle less than or equal to this value.
Filter by score threshold for AML checks, between 0 and 1. Matches with a score above this threshold will be considered a positive match. Default is 0.7 greater than or equal to this value.
Filter by score threshold for AML checks, between 0 and 1. Matches with a score above this threshold will be considered a positive match. Default is 0.7 less than or equal to this value.
Filter by maximum number of days deliveries are stored before being returned (virtual office) greater than or equal to this value.
Filter by maximum number of days deliveries are stored before being returned (virtual office) less than or equal to this value.
Filter by maximum number of company name aliases allowed for mail handling (virtual office) greater than or equal to this value.
Filter by maximum number of company name aliases allowed for mail handling (virtual office) less than or equal to this value.
Filter by maximum number of mail recipients allowed (virtual office) greater than or equal to this value.
Filter by maximum number of mail recipients allowed (virtual office) less than or equal to this value.
Filter by maximum number of forwarding addresses allowed (virtual office) greater than or equal to this value.
Filter by maximum number of forwarding addresses allowed (virtual office) less than or equal to this value.
Code Examples
Simple listing
Filtering by Name
Range filters
Response
200
The list of Tariff records matching the query. See the Get one Tariff endpoint for the full list of properties returned for each record.
Example Response