Coworkers
Search Coworkers
Search and list Coworker records with filtering, sorting, and pagination.
GET
Search Coworkers
A Coworker represents a customer in Nexudus. Coworkers can be individuals or companies and hold all personal, billing, access-control, and plan information for a customer. When creating a coworker, setDocumentation Index
Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
Use this file to discover all available pages before exploring further.
CreateUser to grant portal and app access — this also sends a welcome email with access details.
To assign a plan at creation time, pass TariffId with the plan ID. Combine with BillingDay to fix the billing day (defaults to the current day or the plan’s default billing day) and RenewalDate to set the date when the plan starts and will first be invoiced.
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 Coworker-List role.Enums
eCoworkerRecordType — CoworkerType values
eCoworkerRecordType — CoworkerType values
| Value | Name |
|---|---|
| 1 | Individual |
| 2 | Company |
eGender — Gender values
eGender — Gender values
| Value | Name |
|---|---|
| 0 | None |
| 1 | NotSet |
| 2 | Male |
| 3 | Female |
| 4 | Other |
| 5 | RatherNotSay |
eCoworkerTaxRateType — TaxRateType values
eCoworkerTaxRateType — TaxRateType values
| Value | Name |
|---|---|
| 1 | Default |
| 2 | Reduced |
| 3 | Exempt |
eCoworkerAttendance — MondayAttendance values
eCoworkerAttendance — MondayAttendance values
| Value | Name |
|---|---|
| 1 | WorkingFromOffice |
| 2 | WorkingFromHome |
| 3 | WorkingFromAbroad |
| 4 | NotWorking |
| 5 | Undefined |
eRegularPaymentProvider
eRegularPaymentProvider
| Value | Name |
|---|---|
| 0 | None |
| 1 | MultiGateway |
| 2 | Stripe |
| 3 | Forte |
| 4 | AuthorizeNetSubscription |
| 5 | PaypalStandardSubscription |
| 6 | PayPalAdaptive |
| 7 | EPay |
| 8 | Braintree |
| 9 | EziDebit |
| 10 | LiqPay |
| 11 | StripeACH |
| 12 | GoCardless |
| 13 | StripeBACS |
| 94 | CreditNote |
| 95 | GiftCard |
| 96 | BankTransfer |
| 97 | Cash |
| 98 | Check |
| 99 | Other |
Query Parameters
Pagination & Sorting
The page number to retrieve.
The number of records per page.
The property name to sort results by (e.g.
Name, CreatedOn).Sort direction.
0 for ascending, 1 for descending.Filters
Filter by coworker type.
Filter by full name.
Filter by title or salutation prefix (e.g. Mr, Mrs, Dr).
Filter by gender of the person.
Filter by email address.
Filter by create user account. Grants portal and app access and sends a welcome email with the access details.
Filter by current file name of the avatar (read-only; upload via the corresponding URL field).
Filter by uRL of a new file to upload as the avatar.
Filter by set to true to remove the current avatar file.
Filter by current file name of the banner image (read-only; upload via the corresponding URL field).
Filter by uRL of a new file to upload as the banner image.
Filter by set to true to remove the current banner image file.
Filter by street address.
Filter by post code.
Filter by city name.
Filter by state or province.
Filter by iD of the country linked to this record.
Filter by iD of the simple time zone linked to this record.
Filter by mobile phone.
Filter by land line.
Filter by date of birth.
Filter by nickname.
Filter by business area.
Filter by display order position or job title.
Filter by company name.
Filter by profile website.
Filter by profile tags.
Filter by profile summary.
Filter by twitter handle.
Filter by facebook profile.
Filter by the google value for this coworker.
Filter by telegram handle.
Filter by linkedIn profile.
Filter by skype handle.
Filter by gitHub profile.
Filter by the pinterest value for this coworker.
Filter by the flickr value for this coworker.
Filter by instagram profile.
Filter by the vimeo value for this coworker.
Filter by the tumblr value for this coworker.
Filter by the blogger value for this coworker.
Filter by profile is public.
Filter by iD of the invoicing business linked to this record.
Filter by the name of the customer home location.
Filter by billing email.
Filter by billing name.
Filter by billing address.
Filter by billing post code.
Filter by billing city.
Filter by billing state.
Filter by iD of the billing country linked to this record.
Filter by iD of the billing simple time zone linked to this record.
Filter by tax rate type.
Filter by tax rate.
Filter by tax ID number.
Filter by bank name.
Filter by bank account.
Filter by bank branch.
Filter by notify on new invoice.
Filter by notify on new payment.
Filter by notify on failed payment.
Filter by show paying member invoices.
Filter by enable GoCardless payments.
Filter by whether use go cardless pro payments is enabled.
Filter by goCardless contract number.
Filter by iD of the stripe bacs dd payment method associated with this record.
Filter by iD of the stripe bacs dd mandate associated with this record.
Filter by the stripe bacs dd customer token value for this coworker.
Filter by whether stripe bacs dd enabled is enabled.
Filter by date/time value for last over due invoice reminder.
Filter by date/time value for last low credit reminder.
Filter by unique identifier (GUID) for the referer.
Filter by regular payment provider.
Filter by regular payment contract number.
Filter by card number.
Filter by do not process invoices automatically.
Filter by allow network check-in.
Filter by check-ins since last renewal.
Filter by minutes since last renewal.
Filter by access card ID.
Filter by access PIN code.
Filter by key fob number.
Filter by notify on delivery.
Filter by iD of the ezeep user associated with this record.
Filter by whether ezeep free printing is enabled.
Filter by iD of the ezeep blue user associated with this record.
Filter by whether ezeep blue free printing is enabled.
Filter by whether ezeep blue printing enabled is enabled.
Filter by whether paper cut pay as you print is enabled.
Filter by whether paper cut free printing is enabled.
Filter by iD of the paper cut user associated with this record.
Filter by can make bookings.
Filter by can book for team.
Filter by can purchase products.
Filter by can purchase events.
Filter by can access community.
Filter by reference number.
Filter by free-form tag for categorising or filtering.
Filter by optional notes or comments about this coworker.
Filter by show alert.
Filter by alert note.
Filter by iD of the user linked to this record.
Filter by display name of the linked user full (read-only).
Filter by whether user is admin is enabled.
Filter by date/time value for user last access.
Filter by whether user active is enabled.
Filter by whether user receive community digest is enabled.
Filter by whether user receive every message is enabled.
Filter by whether this coworker is currently active.
Filter by next auto invoice date.
Filter by invoice due date period.
Filter by registration date.
Filter by general terms accepted.
Filter by date/time value for last renewal.
Filter by date/time value for last invoice attempt.
Filter by custom field 1.
Filter by custom field 2.
Filter by custom field 3.
Filter by custom field 4.
Filter by custom field 5.
Filter by custom field 6.
Filter by custom field 7.
Filter by custom field 8.
Filter by custom field 9.
Filter by custom field 10.
Filter by custom field 11.
Filter by custom field 12.
Filter by custom field 13.
Filter by custom field 14.
Filter by custom field 15.
Filter by custom field 16.
Filter by custom field 17.
Filter by custom field 18.
Filter by custom field 19.
Filter by custom field 20.
Filter by custom field 21.
Filter by custom field 22.
Filter by custom field 23.
Filter by custom field 24.
Filter by custom field 25.
Filter by custom field 26.
Filter by custom field 27.
Filter by custom field 28.
Filter by custom field 29.
Filter by custom field 30.
Filter by date/time value for next invoice local.
Filter by date/time value for next auto invoice local.
Filter by date/time value for registration date local.
Filter by date/time value for access control debounce time.
Filter by the office365 access token value for this coworker.
Filter by the office365 refresh token value for this coworker.
Filter by the zoom access token value for this coworker.
Filter by the zoom refresh token value for this coworker.
Filter by iD of the zoom user associated with this record.
Filter by the doordeck private key value for this coworker.
Filter by the doordeck public key value for this coworker.
Filter by unique identifier (GUID) for the doordeck user.
Filter by iD of the office365 subscription associated with this record.
Filter by the salto v2 access token value for this coworker.
Filter by the stripe ach bank token value for this coworker.
Filter by the stripe ach customer token value for this coworker.
Filter by whether has accepted stripe ach agreement is enabled.
Filter by whether has verified stripe ach deposits is enabled.
Filter by purchase order.
Filter by whether sync to square is enabled.
Filter by notify on deliveries email.
Filter by whether access control error notification sent is enabled.
Filter by whether sync to paper cut due is enabled.
Filter by the google api token value for this coworker.
Filter by iD of the google subscription associated with this record.
Filter by the coworker contract ids value for this coworker.
Filter by the coworker contract tariff names value for this coworker.
Filter by billing day. Used with
TariffId to fix the billing day (defaults to current day or the plan’s default billing day).Filter by plan ID. Creates a new contract for this plan at the same time as the customer. Combine with
BillingDay and RenewalDate.Filter by tariff invoice every N months.
Filter by tariff invoice every N weeks.
Filter by renewal date. Used with
TariffId as the date when the plan starts and will be invoiced first.Filter by display name of the linked team (read-only).
Filter by iD of the team associated with this record.
Filter by team names.
Filter by the team ids value for this coworker.
Filter by the current access signature value for this coworker.
Filter by the current access signatures value for this coworker.
Filter by whether invoice segregation override is enabled.
Filter by whether invoice segregate contracts is enabled.
Filter by whether invoice segregate bookings is enabled.
Filter by whether invoice segregate products is enabled.
Filter by whether invoice segregate time passes is enabled.
Filter by whether invoice segregate tickets is enabled.
Filter by whether is default profile is enabled.
Filter by whether invoice segregate charges is enabled.
Filter by iD of the brivo user associated with this record.
Filter by whether ezeep printing enabled is enabled.
Filter by the churn probability value for this coworker.
Filter by the engagement level value for this coworker.
Filter by the invoice due date day value for this coworker.
Filter by monday attendance.
Filter by tuesday attendance.
Filter by wednesday attendance.
Filter by thursday attendance.
Filter by friday attendance.
Filter by saturday attendance.
Filter by sunday attendance.
Filter by gPS longitude coordinate.
Filter by gPS latitude coordinate.
Filter by billing longitude.
Filter by billing latitude.
Filter by whether this coworker is archived and hidden from active lists.
Range Filters
Filter by date of birth greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date of birth less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by tax rate greater than or equal to this value.
Filter by tax rate less than or equal to this value.
Filter by date/time value for last over due invoice reminder greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for last over due invoice reminder less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for last low credit reminder greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for last low credit reminder less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by check-ins since last renewal greater than or equal to this value.
Filter by check-ins since last renewal less than or equal to this value.
Filter by minutes since last renewal greater than or equal to this value.
Filter by minutes since last renewal less than or equal to this value.
Filter by date/time value for user last access greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for user last access less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by next auto invoice date greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by next auto invoice date less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by invoice due date period greater than or equal to this value.
Filter by invoice due date period less than or equal to this value.
Filter by registration date greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by registration date less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for last renewal greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for last renewal less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for last invoice attempt greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for last invoice attempt less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for next invoice local greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for next invoice local less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for next auto invoice local greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for next auto invoice local less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for registration date local greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for registration date local less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for access control debounce time greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by date/time value for access control debounce time less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by billing day. Used with
TariffId to fix the billing day (defaults to current day or the plan’s default billing day) greater than or equal to this value.Filter by billing day. Used with
TariffId to fix the billing day (defaults to current day or the plan’s default billing day) less than or equal to this value.Filter by plan ID. Creates a new contract for this plan at the same time as the customer. Combine with
BillingDay and RenewalDate greater than or equal to this value.Filter by plan ID. Creates a new contract for this plan at the same time as the customer. Combine with
BillingDay and RenewalDate less than or equal to this value.Filter by tariff invoice every N months greater than or equal to this value.
Filter by tariff invoice every N months less than or equal to this value.
Filter by tariff invoice every N weeks greater than or equal to this value.
Filter by tariff invoice every N weeks less than or equal to this value.
Filter by renewal date. Used with
TariffId as the date when the plan starts and will be invoiced first greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.Filter by renewal date. Used with
TariffId as the date when the plan starts and will be invoiced first less than or equal to this value. Format: YYYY-MM-DDTHH:mm.Filter by iD of the team associated with this record greater than or equal to this value.
Filter by iD of the team associated with this record less than or equal to this value.
Filter by iD of the brivo user associated with this record greater than or equal to this value.
Filter by iD of the brivo user associated with this record less than or equal to this value.
Filter by the churn probability value for this coworker greater than or equal to this value.
Filter by the churn probability value for this coworker less than or equal to this value.
Filter by the invoice due date day value for this coworker greater than or equal to this value.
Filter by the invoice due date day value for this coworker less than or equal to this value.
Filter by gPS longitude coordinate greater than or equal to this value.
Filter by gPS longitude coordinate less than or equal to this value.
Filter by gPS latitude coordinate greater than or equal to this value.
Filter by gPS latitude coordinate less than or equal to this value.
Filter by billing longitude greater than or equal to this value.
Filter by billing longitude less than or equal to this value.
Filter by billing latitude greater than or equal to this value.
Filter by billing latitude less than or equal to this value.
Filter records created on or after this date. Format:
YYYY-MM-DDTHH:mm.Filter records created on or before this date. Format:
YYYY-MM-DDTHH:mm.Filter records updated on or after this date. Format:
YYYY-MM-DDTHH:mm.Filter records updated on or before this date. Format:
YYYY-MM-DDTHH:mm.Code Examples
Simple listing
Filtering by FullName
Range filters
Response
200
The list of Coworker records matching the query. See the Get one Coworker endpoint for the full list of properties returned for each record.
Current page number.
Number of records per page.
The field used for sorting.
The sort direction (
0 = ascending, 1 = descending).Index of the first item on the current page.
Index of the last item on the current page.
Total number of matching records across all pages.
Total number of pages.
Whether there is a next page of results.
Whether there is a previous page of results.
Example Response
Search Coworkers