> ## Documentation Index > Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt > Use this file to discover all available pages before exploring further. # Get one Coworker > Retrieve a single Coworker record by its Id. 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 The Id of the Coworker record to retrieve. ## Code Examples ```bash cURL theme={null} curl -X GET \ "https://spaces.nexudus.com/api/spaces/coworkers/87654321" \ -H "Authorization: Bearer YOUR_TOKEN" ``` ```javascript JavaScript theme={null} const response = await fetch( 'https://spaces.nexudus.com/api/spaces/coworkers/87654321', { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } } ); const record = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://spaces.nexudus.com/api/spaces/coworkers/87654321', headers={ 'Authorization': 'Bearer YOUR_TOKEN' } ) record = response.json() ``` ## Response ### 200 Coworker type. See `eCoworkerRecordType` enum values: `1` = Individual, `2` = Company. Businesses. Teams. Full name. Salutation. Gender. See `eGender` enum values: `0` = None, `1` = NotSet, `2` = Male, `3` = Female, `4` = Other, `5` = RatherNotSay. Email address. Create user account. Grants portal and app access and sends a welcome email with the access details. Avatar File Name. New Avatar Url. Clear Avatar File. Banner Image File Name. New Banner Image Url. Clear Banner Image File. Address. Post code. City name. State. Country Id. Simple Time Zone Id. Mobile phone. Land line. Date of birth. Nickname. Business area. Position. Company name. Profile website. Profile tags. Profile summary. Twitter handle. Facebook profile. Google. Telegram handle. LinkedIn profile. Skype handle. GitHub profile. Pinterest. Flickr. Instagram profile. Vimeo. Tumblr. Blogger. Profile is public. Invoicing Business Id. The name of the customer home location. Billing email. Billing name. Billing address. Billing post code. Billing city. Billing state. Billing Country Id. Billing Simple Time Zone Id. Tax rate type. See `eCoworkerTaxRateType` enum values: `1` = Default, `2` = Reduced, `3` = Exempt. Tax rate. Tax ID number. Bank name. Bank account. Bank branch. Notify on new invoice. Notify on new payment. Notify on failed payment. Show paying member invoices. Enable GoCardless payments. Use Go Cardless Pro Payments. GoCardless contract number. Stripe Bacs DDPayment Method Id. Stripe Bacs DDMandate Id. Stripe Bacs DDCustomer Token. Stripe Bacs DDEnabled. Last Over Due Invoice Reminder. Last Low Credit Reminder. Referer Guid. Regular payment provider. Regular payment contract number. Card number. Do not process invoices automatically. Allow network check-in. Check-ins since last renewal. Minutes since last renewal. Access card ID. Access PIN code. Key fob number. Notify on delivery. Ezeep User Id. Ezeep Free Printing. Ezeep Blue User Id. Ezeep Blue Free Printing. Ezeep Blue Printing Enabled. Paper Cut Pay As You Print. Paper Cut Free Printing. Paper Cut User Id. Can make bookings. Can book for team. Can purchase products. Can purchase events. Can access community. Reference number. Tag. Notes. Show alert. Alert note. User Id. User Full Name. User Is Admin. User Last Access. User Active. User Receive Community Digest. User Receive Every Message. Active. Next auto invoice date. Invoice due date period. Registration date. General terms accepted. Last Renewal. Last Invoice Attempt. Custom field 1. Custom field 2. Custom field 3. Custom field 4. Custom field 5. Custom field 6. Custom field 7. Custom field 8. Custom field 9. Custom field 10. Custom field 11. Custom field 12. Custom field 13. Custom field 14. Custom field 15. Custom field 16. Custom field 17. Custom field 18. Custom field 19. Custom field 20. Custom field 21. Custom field 22. Custom field 23. Custom field 24. Custom field 25. Custom field 26. Custom field 27. Custom field 28. Custom field 29. Custom field 30. Next Invoice Local. Next Auto Invoice Local. Registration Date Local. Access Control Debounce Time. Office365Access Token. Office365Refresh Token. Zoom Access Token. Zoom Refresh Token. Zoom User Id. Doordeck Private Key. Doordeck Public Key. Doordeck User Guid. Office365Subscription Id. Salto V2Access Token. Stripe ACHBank Token. Stripe ACHCustomer Token. Has Accepted Stripe ACHAgreement. Has Verified Stripe ACHDeposits. Purchase order. Sync To Square. Notify on deliveries email. Access Control Error Notification Sent. Sync To Paper Cut Due. Google Api Token. Google Subscription Id. Coworker Contract Ids. Coworker Contract Tariff Names. Billing day. Used with `TariffId` to fix the billing day (defaults to current day or the plan's default billing day). Plan ID. Creates a new contract for this plan at the same time as the customer. Combine with `BillingDay` and `RenewalDate`. Tariff invoice every N months. Tariff invoice every N weeks. Renewal date. Used with `TariffId` as the date when the plan starts and will be invoiced first. Team Name. Team Id. Team names. Team Ids. Current Access Signature. Current Access Signatures. Invoice Segregation Override. Invoice Segregate Contracts. Invoice Segregate Bookings. Invoice Segregate Products. Invoice Segregate Time Passes. Invoice Segregate Tickets. Is Default Profile. Invoice Segregate Charges. Brivo User Id. Ezeep Printing Enabled. Churn Probability. Engagement Level. Invoice Due Date Day. Monday attendance. See `eCoworkerAttendance` enum values: `1` = WorkingFromOffice, `2` = WorkingFromHome, `3` = WorkingFromAbroad, `4` = NotWorking, `5` = Undefined. Tuesday attendance. See `eCoworkerAttendance` enum values: `1` = WorkingFromOffice, `2` = WorkingFromHome, `3` = WorkingFromAbroad, `4` = NotWorking, `5` = Undefined. Wednesday attendance. See `eCoworkerAttendance` enum values: `1` = WorkingFromOffice, `2` = WorkingFromHome, `3` = WorkingFromAbroad, `4` = NotWorking, `5` = Undefined. Thursday attendance. See `eCoworkerAttendance` enum values: `1` = WorkingFromOffice, `2` = WorkingFromHome, `3` = WorkingFromAbroad, `4` = NotWorking, `5` = Undefined. Friday attendance. See `eCoworkerAttendance` enum values: `1` = WorkingFromOffice, `2` = WorkingFromHome, `3` = WorkingFromAbroad, `4` = NotWorking, `5` = Undefined. Saturday attendance. See `eCoworkerAttendance` enum values: `1` = WorkingFromOffice, `2` = WorkingFromHome, `3` = WorkingFromAbroad, `4` = NotWorking, `5` = Undefined. Sunday attendance. See `eCoworkerAttendance` enum values: `1` = WorkingFromOffice, `2` = WorkingFromHome, `3` = WorkingFromAbroad, `4` = NotWorking, `5` = Undefined. Longitude. Latitude. Billing longitude. Billing latitude. Archived. 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. ```json Example Response theme={null} { "CoworkerType": 0, "Businesses": [], "Teams": [], "FullName": "", "Salutation": null, "Gender": 0, "Email": "", "CreateUser": false, "AvatarFileName": null, "NewAvatarUrl": null, "ClearAvatarFile": null, "BannerImageFileName": null, "NewBannerImageUrl": null, "ClearBannerImageFile": null, "Address": null, "PostCode": null, "CityName": null, "State": null, "CountryId": 0, "SimpleTimeZoneId": 0, "MobilePhone": null, "LandLine": null, "DateOfBirth": null, "NickName": null, "BusinessArea": null, "Position": null, "CompanyName": null, "ProfileWebsite": null, "ProfileTags": null, "ProfileSummary": null, "Twitter": null, "Facebook": null, "Google": null, "Telegram": null, "Linkedin": null, "Skype": null, "Github": null, "Pinterest": null, "Flickr": null, "Instagram": null, "Vimeo": null, "Tumblr": null, "Blogger": null, "ProfileIsPublic": false, "InvoicingBusinessId": null, "InvoicingBusinessName": null, "BillingEmail": null, "BillingName": null, "BillingAddress": null, "BillingPostCode": null, "BillingCityName": null, "BillingState": null, "BillingCountryId": null, "BillingSimpleTimeZoneId": null, "TaxRateType": 0, "TaxRate": null, "TaxIDNumber": null, "BankName": null, "BankAccount": null, "BankBranch": null, "NotifyOnNewInvoice": false, "NotifyOnNewPayment": false, "NotifyOnFailedPayment": false, "ShowPayingMemberInvoices": false, "EnableGoCardlessPayments": false, "UseGoCardlessProPayments": false, "GoCardlessContractNumber": null, "StripeBacsDDPaymentMethodId": null, "StripeBacsDDMandateId": null, "StripeBacsDDCustomerToken": null, "StripeBacsDDEnabled": false, "LastOverDueInvoiceReminder": null, "LastLowCreditReminder": null, "RefererGuid": null, "RegularPaymentProvider": 0, "RegularPaymentContractNumber": null, "CardNumber": null, "DoNotProcessInvoicesAutomatically": false, "AllowNetworkCheckin": false, "CheckinSinceLastRenewal": 0, "MinutesSinceLastRenewal": 0, "AccessCardId": null, "AccessPincode": null, "KeyFobNumber": null, "NotifyOnDelivery": false, "EzeepUserId": null, "EzeepFreePrinting": false, "EzeepBlueUserId": null, "EzeepBlueFreePrinting": false, "EzeepBluePrintingEnabled": false, "PaperCutPayAsYouPrint": false, "PaperCutFreePrinting": false, "PaperCutUserId": null, "CanMakeBookings": false, "CanBookForTeam": false, "CanPurchaseProducts": false, "CanPurchaseEvents": false, "CanAccessCommunity": false, "ReferenceNumber": null, "Tag": null, "Notes": null, "ShowAlert": false, "AlertNote": null, "UserId": null, "UserFullName": null, "UserIsAdmin": null, "UserLastAccess": null, "UserActive": null, "UserReceiveCommunityDigest": null, "UserReceiveEveryMessage": null, "Active": false, "NextAutoInvoice": null, "InvoiceDueDatePeriod": null, "RegistrationDate": null, "GeneralTermsAccepted": false, "LastRenewal": null, "LastInvoiceAttempt": null, "Custom1": null, "Custom2": null, "Custom3": null, "Custom4": null, "Custom5": null, "Custom6": null, "Custom7": null, "Custom8": null, "Custom9": null, "Custom10": null, "Custom11": null, "Custom12": null, "Custom13": null, "Custom14": null, "Custom15": null, "Custom16": null, "Custom17": null, "Custom18": null, "Custom19": null, "Custom20": null, "Custom21": null, "Custom22": null, "Custom23": null, "Custom24": null, "Custom25": null, "Custom26": null, "Custom27": null, "Custom28": null, "Custom29": null, "Custom30": null, "NextInvoiceLocal": null, "NextAutoInvoiceLocal": null, "RegistrationDateLocal": null, "AccessControlDebounceTime": null, "Office365AccessToken": null, "Office365RefreshToken": null, "ZoomAccessToken": null, "ZoomRefreshToken": null, "ZoomUserId": null, "DoordeckPrivateKey": null, "DoordeckPublicKey": null, "DoordeckUserGuid": null, "Office365SubscriptionId": null, "SaltoV2AccessToken": null, "StripeACHBankToken": null, "StripeACHCustomerToken": null, "HasAcceptedStripeACHAgreement": false, "HasVerifiedStripeACHDeposits": false, "PurchaseOrder": null, "SyncToSquare": false, "NotifyOnDeliveriesEmail": null, "AccessControlErrorNotificationSent": false, "SyncToPaperCutDue": false, "GoogleApiToken": null, "GoogleSubscriptionId": null, "CoworkerContractIds": null, "CoworkerContractTariffNames": null, "BillingDay": null, "TariffId": null, "TariffInvoiceEvery": 0, "TariffInvoiceEveryWeeks": 0, "RenewalDate": null, "TeamName": null, "TeamId": null, "TeamNames": null, "TeamIds": null, "CurrentAccessSignature": null, "CurrentAccessSignatures": null, "InvoiceSegregationOverride": false, "InvoiceSegregateContracts": false, "InvoiceSegregateBookings": false, "InvoiceSegregateProducts": false, "InvoiceSegregateTimePasses": false, "InvoiceSegregateTickets": false, "IsDefaultProfile": false, "InvoiceSegregateCharges": false, "BrivoUserId": null, "EzeepPrintingEnabled": false, "ChurnProbability": null, "EngagementLevel": null, "InvoiceDueDateDay": null, "MondayAttendance": 0, "TuesdayAttendance": 0, "WednesdayAttendance": 0, "ThursdayAttendance": 0, "FridayAttendance": 0, "SaturdayAttendance": 0, "SundayAttendance": 0, "Longitude": null, "Latitude": null, "BillingLongitude": null, "BillingLatitude": null, "Archived": false, "Id": 87654321, "UpdatedOn": "2025-01-15T10:30:00Z", "CreatedOn": "2025-01-10T08:00:00Z", "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "UpdatedBy": "admin@example.com", "IsNew": false, "SystemId": null, "ToStringText": "Coworker Example", "LocalizationDetails": null, "CustomFields": null } ```