Coworkers
Get one Coworker
Retrieve a single Coworker record by its Id.
GET
Get one Coworker
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, set
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-Read role.Path Parameters
integer
required
The Id of the Coworker record to retrieve.
Code Examples
Response
200
integer
Coworker type. See
eCoworkerRecordType enum values: 1 = Individual, 2 = Company.integer[]
List of businesses linked to this record.
integer[]
List of teams linked to this record.
string
Full name.
string
Title or salutation prefix (e.g. Mr, Mrs, Dr).
integer
Gender of the person. See
eGender enum values: 0 = None, 1 = NotSet, 2 = Male, 3 = Female, 4 = Other, 5 = RatherNotSay.string
Email address.
boolean
Create user account. Grants portal and app access and sends a welcome email with the access details.
string
Current file name of the avatar (read-only; upload via the corresponding URL field).
string
URL of a new file to upload as the avatar.
boolean
Set to true to remove the current avatar file.
string
Current file name of the banner image (read-only; upload via the corresponding URL field).
string
URL of a new file to upload as the banner image.
boolean
Set to true to remove the current banner image file.
string
Street address.
string
Post code.
string
City name.
string
State or province.
integer
ID of the country linked to this record.
integer
ID of the simple time zone linked to this record.
string
Mobile phone.
string
Land line.
string
Date of birth.
string
Nickname.
string
Business area.
string
Display order position or job title.
string
Company name.
string
Profile website.
string
Profile tags.
string
Profile summary.
string
Twitter handle.
string
Facebook profile.
string
The google value for this coworker.
string
Telegram handle.
string
LinkedIn profile.
string
Skype handle.
string
GitHub profile.
string
The pinterest value for this coworker.
string
The flickr value for this coworker.
string
Instagram profile.
string
The vimeo value for this coworker.
string
The tumblr value for this coworker.
string
The blogger value for this coworker.
boolean
Profile is public.
integer
ID of the invoicing business linked to this record.
string
The name of the customer home location.
string
Billing email.
string
Billing name.
string
Billing address.
string
Billing post code.
string
Billing city.
string
Billing state.
integer
ID of the billing country linked to this record.
integer
ID of the billing simple time zone linked to this record.
integer
Tax rate type. See
eCoworkerTaxRateType enum values: 1 = Default, 2 = Reduced, 3 = Exempt.number
Tax rate.
string
Tax ID number.
string
Bank name.
string
Bank account.
string
Bank branch.
boolean
Notify on new invoice.
boolean
Notify on new payment.
boolean
Notify on failed payment.
boolean
Show paying member invoices.
boolean
Enable GoCardless payments.
boolean
Whether use go cardless pro payments is enabled.
string
GoCardless contract number.
string
ID of the stripe bacs dd payment method associated with this record.
string
ID of the stripe bacs dd mandate associated with this record.
string
The stripe bacs dd customer token value for this coworker.
boolean
Whether stripe bacs dd enabled is enabled.
string
Date/time value for last over due invoice reminder.
string
Date/time value for last low credit reminder.
string
Unique identifier (GUID) for the referer.
integer
Regular payment provider.
string
Regular payment contract number.
string
Card number.
boolean
Do not process invoices automatically.
boolean
Allow network check-in.
integer
Check-ins since last renewal.
integer
Minutes since last renewal.
string
Access card ID.
string
Access PIN code.
string
Key fob number.
boolean
Notify on delivery.
string
ID of the ezeep user associated with this record.
boolean
Whether ezeep free printing is enabled.
string
ID of the ezeep blue user associated with this record.
boolean
Whether ezeep blue free printing is enabled.
boolean
Whether ezeep blue printing enabled is enabled.
boolean
Whether paper cut pay as you print is enabled.
boolean
Whether paper cut free printing is enabled.
string
ID of the paper cut user associated with this record.
boolean
Can make bookings.
boolean
Can book for team.
boolean
Can purchase products.
boolean
Can purchase events.
boolean
Can access community.
string
Reference number.
string
Free-form tag for categorising or filtering.
string
Optional notes or comments about this coworker.
boolean
Show alert.
string
Alert note.
integer
ID of the user linked to this record.
string
Display name of the linked user full (read-only).
boolean
Whether user is admin is enabled.
string
Date/time value for user last access.
boolean
Whether user active is enabled.
boolean
Whether user receive community digest is enabled.
boolean
Whether user receive every message is enabled.
boolean
Whether this coworker is currently active.
string
Next auto invoice date.
integer
Invoice due date period.
string
Registration date.
boolean
General terms accepted.
string
Date/time value for last renewal.
string
Date/time value for last invoice attempt.
string
Custom field 1.
string
Custom field 2.
string
Custom field 3.
string
Custom field 4.
string
Custom field 5.
string
Custom field 6.
string
Custom field 7.
string
Custom field 8.
string
Custom field 9.
string
Custom field 10.
string
Custom field 11.
string
Custom field 12.
string
Custom field 13.
string
Custom field 14.
string
Custom field 15.
string
Custom field 16.
string
Custom field 17.
string
Custom field 18.
string
Custom field 19.
string
Custom field 20.
string
Custom field 21.
string
Custom field 22.
string
Custom field 23.
string
Custom field 24.
string
Custom field 25.
string
Custom field 26.
string
Custom field 27.
string
Custom field 28.
string
Custom field 29.
string
Custom field 30.
string
Date/time value for next invoice local.
string
Date/time value for next auto invoice local.
string
Date/time value for registration date local.
string
Date/time value for access control debounce time.
string
The office365 access token value for this coworker.
string
The office365 refresh token value for this coworker.
string
The zoom access token value for this coworker.
string
The zoom refresh token value for this coworker.
string
ID of the zoom user associated with this record.
string
The doordeck private key value for this coworker.
string
The doordeck public key value for this coworker.
string
Unique identifier (GUID) for the doordeck user.
string
ID of the office365 subscription associated with this record.
string
The salto v2 access token value for this coworker.
string
The stripe ach bank token value for this coworker.
string
The stripe ach customer token value for this coworker.
boolean
Whether has accepted stripe ach agreement is enabled.
boolean
Whether has verified stripe ach deposits is enabled.
string
Purchase order.
boolean
Whether sync to square is enabled.
string
Notify on deliveries email.
boolean
Whether access control error notification sent is enabled.
boolean
Whether sync to paper cut due is enabled.
string
The google api token value for this coworker.
string
ID of the google subscription associated with this record.
string
The coworker contract ids value for this coworker.
string
The coworker contract tariff names value for this coworker.
integer
Billing day. Used with
TariffId to fix the billing day (defaults to current day or the plan’s default billing day).integer
Plan ID. Creates a new contract for this plan at the same time as the customer. Combine with
BillingDay and RenewalDate.integer
Tariff invoice every N months.
integer
Tariff invoice every N weeks.
string
Renewal date. Used with
TariffId as the date when the plan starts and will be invoiced first.string
Display name of the linked team (read-only).
integer
ID of the team associated with this record.
string
Team names.
string
The team ids value for this coworker.
string
The current access signature value for this coworker.
string
The current access signatures value for this coworker.
boolean
Whether invoice segregation override is enabled.
boolean
Whether invoice segregate contracts is enabled.
boolean
Whether invoice segregate bookings is enabled.
boolean
Whether invoice segregate products is enabled.
boolean
Whether invoice segregate time passes is enabled.
boolean
Whether invoice segregate tickets is enabled.
boolean
Whether is default profile is enabled.
boolean
Whether invoice segregate charges is enabled.
integer
ID of the brivo user associated with this record.
boolean
Whether ezeep printing enabled is enabled.
number
The churn probability value for this coworker.
string
The engagement level value for this coworker.
integer
The invoice due date day value for this coworker.
integer
Monday attendance. See
eCoworkerAttendance enum values: 1 = WorkingFromOffice, 2 = WorkingFromHome, 3 = WorkingFromAbroad, 4 = NotWorking, 5 = Undefined.integer
Tuesday attendance. See
eCoworkerAttendance enum values: 1 = WorkingFromOffice, 2 = WorkingFromHome, 3 = WorkingFromAbroad, 4 = NotWorking, 5 = Undefined.integer
Wednesday attendance. See
eCoworkerAttendance enum values: 1 = WorkingFromOffice, 2 = WorkingFromHome, 3 = WorkingFromAbroad, 4 = NotWorking, 5 = Undefined.integer
Thursday attendance. See
eCoworkerAttendance enum values: 1 = WorkingFromOffice, 2 = WorkingFromHome, 3 = WorkingFromAbroad, 4 = NotWorking, 5 = Undefined.integer
Friday attendance. See
eCoworkerAttendance enum values: 1 = WorkingFromOffice, 2 = WorkingFromHome, 3 = WorkingFromAbroad, 4 = NotWorking, 5 = Undefined.integer
Saturday attendance. See
eCoworkerAttendance enum values: 1 = WorkingFromOffice, 2 = WorkingFromHome, 3 = WorkingFromAbroad, 4 = NotWorking, 5 = Undefined.integer
Sunday attendance. See
eCoworkerAttendance enum values: 1 = WorkingFromOffice, 2 = WorkingFromHome, 3 = WorkingFromAbroad, 4 = NotWorking, 5 = Undefined.number
GPS longitude coordinate.
number
GPS latitude coordinate.
number
Billing longitude.
number
Billing latitude.
boolean
Whether this coworker is archived and hidden from active lists.
integer
Unique record identifier.
string
UUID of the record.
string
Date and time the record was created (ISO 8601).
string
Date and time the record was last updated (ISO 8601).
string
Email of the user who last updated this record.
boolean
Whether the record was recently created.
string
External system identifier.
Example Response
Get one Coworker