A CoworkerContract is the foundation for automatic billing. It links a customer (Coworker) to a plan (Tariff) that drives the billing frequency, benefits and default settings for the contract. A customer can hold as many contracts as needed, each pointing to the same or different plans.A customer with at least one active contract is regarded as a Member; customers with no active contracts are Contacts. Nexudus uses this distinction to enforce policies on products, resources, events, pricing and many other entities that expose OnlyForMembers or OnlyForContacts properties.Pricing — The contract price can be fixed (Price is not null) or derived from the plan it is for. The Value field is used in reporting to compare with the actual price. Automatic price adjustments over time can be set up via ContractSchedule child entities.Billing cycle — RenewalDate is the date on which the contract will next be automatically invoiced; it advances automatically each time the contract is invoiced. InvoicedPeriod is the period the next invoice will cover. For a new contract these two dates are usually the same. If Tariff.AdvanceInvoiceCycles is greater than 1, Nexudus invoices several periods in one go the first time, pushing InvoicedPeriod ahead of RenewalDate from the first invoice onwards. When the contract is cancelled, Nexudus stops invoicing once InvoicedPeriod reaches the cancellation date.Benefits — The plan may include benefits (booking credits, time passes, etc.) which are released and assigned to the contract-holder customer based on the contract cycle or other expiration criteria (month, week, day, etc.).Cancellation — Contracts support minimum contract length (ContractTerm), cancellation policies (CancellationLimitDays, ProRateCancellation) and cancellation reasons. CancelTeamContracts can cascade cancellation to team members.Additional charges — Contracts can optionally include products (ContractProduct entities) to be billed alongside the plan, as well as security deposits/retainers (ContractDeposit entities).
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 CoworkerContract-List role.
Filter by date on which the contract will next be automatically invoiced. Updated automatically every time the contract is invoiced, advancing by the plan’s renewal period.
Filter by period the next invoice will cover. For new contracts this equals RenewalDate. If Tariff.AdvanceInvoiceCycles > 1, Nexudus invoices several periods at once on the first invoice, pushing InvoicedPeriod ahead of RenewalDate. Nexudus stops invoicing when InvoicedPeriod reaches the cancellation date.
Filter by date on which the contract will next be automatically invoiced. Updated automatically every time the contract is invoiced, advancing by the plan’s renewal period greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by date on which the contract will next be automatically invoiced. Updated automatically every time the contract is invoiced, advancing by the plan’s renewal period less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by period the next invoice will cover. For new contracts this equals RenewalDate. If Tariff.AdvanceInvoiceCycles > 1, Nexudus invoices several periods at once on the first invoice, pushing InvoicedPeriod ahead of RenewalDate. Nexudus stops invoicing when InvoicedPeriod reaches the cancellation date greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by period the next invoice will cover. For new contracts this equals RenewalDate. If Tariff.AdvanceInvoiceCycles > 1, Nexudus invoices several periods at once on the first invoice, pushing InvoicedPeriod ahead of RenewalDate. Nexudus stops invoicing when InvoicedPeriod reaches the cancellation date less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by minimum contract length end date. Defines the earliest date at which the contract can be cancelled without penalty greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by minimum contract length end date. Defines the earliest date at which the contract can be cancelled without penalty less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by fixed price override for this contract. If null, the contract uses the plan’s default price (TariffPrice) greater than or equal to this value.
Filter by date on which the contract will be cancelled. Nexudus stops invoicing when InvoicedPeriod reaches this date greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by date on which the contract will be cancelled. Nexudus stops invoicing when InvoicedPeriod reaches this date less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by date by which identity verification checks must be completed for this contract greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by end date of the current pause period. The contract resumes billing after this date greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
Filter by end date of the current pause period. The contract resumes billing after this date less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
The list of CoworkerContract records matching the query. See the Get one CoworkerContract endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each CoworkerContract. The following fields are not included in the Records[] response: Notes, PurchaseOrder, CancellationNotes, DeliveryInstructions, PoBoxNumber.To get all fields, fetch the full record using the Get one CoworkerContract 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.