Tariffs
Get one Tariff
Retrieve a single Tariff record by its Id.
GET
Get one Tariff
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-Read role.Path Parameters
The Id of the Tariff record to retrieve.
Code Examples
Response
200
ID of the business linked to this record.
Business name.
Plan name.
Category of the plan: FullTimePrivateOffice, PartTimePrivateOffice, FullTimeDedicatedDesk, PartTimeDedicatedDesk, FullTimeHotDesk, PartTimeHotDesk, FullTimeOther, PartTimeOther, Storage, VirtualOffice, Virtual, or Other. See
eTariffType enum values: 1 = FullTimePrivateOffice, 2 = PartTimePrivateOffice, 3 = FullTimeDedicatedDesk, 4 = PartTimeDedicatedDesk, 5 = FullTimeHotDesk, 6 = PartTimeHotDesk, 7 = FullTimeOther, 8 = PartTimeOther, 9 = Storage, 10 = VirtualOffice, 11 = Virtual, 99 = Other.Recurring price charged per billing cycle.
Day of the month on which invoices are generated for members on this plan.
Whether the plan is visible to customers on the members portal and mobile app.
Whether this plan is available to any AI channels (Email, Chat or WhatsApp) for recommendations for private offices;.
Custom notes provided to the AI assistant when describing this plan.
Whether to show the plan price to the AI assistant.
Custom price shown to the AI assistant instead of the actual price.
Whether this plan uses time passes for check-in access.
Plan description shown to customers.
Custom text shown on the invoice line instead of the plan name.
One-off fee charged when a customer first signs up to this plan.
ID of the currency linked to this record.
Currency code.
Standard tax rate applied to charges on this plan.
Reduced tax rate applied when applicable.
Tax-exempt rate applied when applicable.
Financial account used for revenue tracking.
Terms and conditions text that members must accept when signing up.
File name of the contract document template.
URL to upload a new contract document template.
Set to true to remove the uploaded contract document file.
Number of days’ notice required before a contract can be cancelled.
Display order on the members portal (lower numbers appear first).
Group name used to visually group plans together on the members portal.
Prevents members from cancelling this plan through the members portal.
Maximum number of members that can be signed up to this plan at any time.
Minimum number of days a contract must be active before it can be cancelled.
Default minimum contract term in months for new sign-ups.
Number of days after contract cancellation before the member account is deactivated.
Maximum number of check-ins included per billing cycle.
Maximum number of check-ins allowed per month.
Maximum number of check-ins allowed per week.
Maximum number of visitor passes allowed per month.
Maximum number of visitor passes allowed per week.
Maximum number of visitor passes allowed per day.
Maximum number of hours included per billing cycle.
Maximum number of hours allowed per month.
Maximum number of hours allowed per week.
Maximum booking minutes allowed per week.
Maximum booking minutes allowed per month.
Discount percentage for extra services.
Discount percentage for time passes.
Discount percentage for charges.
Billing cycle length in months. Set to 0 if billing by weeks instead.
Billing cycle length in weeks. Set to 0 if billing by months instead.
Number of days after which the contract is automatically cancelled if not paid.
Number of billing cycles to invoice in advance.
Day of the month used to align billing cycles when prorating.
Number of days before the prorate day to start prorating.
Whether to prorate the final invoice when a contract is cancelled mid-cycle.
Number of days to extend a contract after payment is received.
Whether to exclude this plan’s charges from member invoices.
Whether to automatically generate invoices at the end of each billing cycle.
Raise invoice every N months.
Raise invoice every N weeks.
Minimum total amount charged per billing cycle regardless of usage.
Whether time pass charges count towards the minimum price.
Whether extra service charges count towards the minimum price.
Whether event charges count towards the minimum price.
Whether the plan is archived and no longer available for new sign-ups.
Whether the plan is starred (highlighted) on the members portal.
Whether new sign-ups are kept on hold until manually approved.
Whether members can pause their contract on this plan.
Maximum number of times a contract can be paused per year.
Maximum number of billing cycles a contract can be paused for.
Strategy for determining when booking charges are due: RenewalDate, BookingEndDate, BookingCreationDate, or NextNthOfMonth. See
eTariffBookingDueDateStrategy enum values: 1 = RenewalDate, 2 = BookingEndDate, 3 = BookingCreationDate, 4 = NextNthOfMonth.Day of the month used when BookingDueDateStrategy is NextNthOfMonth.
Calculated total price at sign-up including the plan price and sign-up fee.
Calculated total recurring price per billing cycle.
Whether this is a virtual office plan with mail handling features.
Whether to keep the contract on hold until all required identity checks are completed.
Whether to request an address identity check from members signing up to this plan.
Instructions shown to members when completing the address identity check.
Provider used for address identity checks: Manual or StripeIdentity. See
eIdentityCheckProvider enum values: 1 = Manual, 2 = StripeIdentity.Whether to keep the contract paused if the address identity check reveals a mismatch.
How often to repeat the address identity check: Never, Every3Months, Every6Months, Every12Months, or Every24Months. See
eIdentityCheckRepeatPattern enum values: 1 = Never, 2 = Every3Months, 3 = Every6Months, 4 = Every12Months, 5 = Every24Months.Whether to request an identity (ID document) check from members signing up to this plan.
Provider used for identity checks: Manual or StripeIdentity. See
eIdentityCheckProvider enum values: 1 = Manual, 2 = StripeIdentity.How often to repeat the identity check: Never, Every3Months, Every6Months, Every12Months, or Every24Months. See
eIdentityCheckRepeatPattern enum values: 1 = Never, 2 = Every3Months, 3 = Every6Months, 4 = Every12Months, 5 = Every24Months.Instructions shown to members when completing the identity check.
Whether to request an AML check from members signing up to this plan.
Whether to enable AML checks against the OpenSanctions dataset.
Whether to enable AML checks against the Pappers dataset.
Which OpenSanctions dataset to check against for AML screening (e.g. ‘default’).
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.
Whether to email the onboarding form to new members signing up to this plan.
ID of the onboarding form page sent to new members.
Form page name.
Product IDs for mail stored for collection (virtual office).
Product IDs for mail forwarding (virtual office).
Product IDs for mail recycling (virtual office).
Product IDs for mail shredding (virtual office).
Product IDs for mail scanning (virtual office).
Product IDs for returning mail to sender (virtual office).
Product IDs for check deposits (virtual office).
Product IDs for mail collection (virtual office).
Allowed handling preferences for mail deliveries (virtual office).
Allowed handling preferences for parcel deliveries (virtual office).
Allowed handling preferences for check deliveries (virtual office).
Allowed handling preferences for publicity deliveries (virtual office).
Allowed handling preferences for other deliveries (virtual office).
Maximum number of days deliveries are stored before being returned (virtual office).
Maximum number of company name aliases allowed for mail handling (virtual office).
Maximum number of mail recipients allowed (virtual office).
Maximum number of forwarding addresses allowed (virtual office).
Whether to automatically transfer mail handling products to the member’s contract.
Unique record identifier.
UUID of the record.
Date and time the record was created (ISO 8601).
Date and time the record was last updated (ISO 8601).
Email of the user who last updated this record.
Whether the record was recently created.
External system identifier.
Example Response
Get one Tariff