Skip to main content
GET
/
api
/
spaces
/
teams
/
{id}
Get one Team
curl --request GET \
  --url https://spaces.nexudus.com/api/spaces/teams/{id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "BusinessId": 123,
  "BusinessName": "<string>",
  "Name": "<string>",
  "Description": "<string>",
  "TunnelPrivateGroupId": "<string>",
  "TeamMembers": [
    123
  ],
  "TeamAdministrators": [
    123
  ],
  "CreateSingleInvoiceForTeam": true,
  "UseSpecialPrices": true,
  "PayingMemberId": 123,
  "PayingMemberFullName": "<string>",
  "PayingMemberCoworkerType": "<string>",
  "PayingMemberBillingName": "<string>",
  "PayingMemberCompanyName": "<string>",
  "DefaultMemberTariffId": 123,
  "DefaultMemberTariffName": "<string>",
  "MaxTeamMemberCount": 123,
  "TransferCreditsToPayingMember": true,
  "ShareTimePasses": true,
  "ShareExtraServices": true,
  "ShareBookingCredit": true,
  "DiscountExtraServices": 123,
  "DiscountTimePasses": 123,
  "DiscountCharges": 123,
  "DiscountTariffs": 123,
  "ProfileSummary": "<string>",
  "ProfileTags": "<string>",
  "ProfileWebsite": "<string>",
  "GoogleMapsLink": "<string>",
  "ProfileIsPublic": true,
  "HasCommunityGroup": true,
  "TeamLogoFileName": "<string>",
  "NewTeamLogoUrl": "<string>",
  "ClearTeamLogoFile": true,
  "TeamImage1FileName": "<string>",
  "NewTeamImage1Url": "<string>",
  "ClearTeamImage1File": true,
  "TeamImage2FileName": "<string>",
  "NewTeamImage2Url": "<string>",
  "ClearTeamImage2File": true,
  "TeamImage3FileName": "<string>",
  "NewTeamImage3Url": "<string>",
  "ClearTeamImage3File": true,
  "Twitter": "<string>",
  "Facebook": "<string>",
  "Linkedin": "<string>",
  "Skype": "<string>",
  "Telegram": "<string>",
  "Github": "<string>",
  "Pinterest": "<string>",
  "Flickr": "<string>",
  "Instagram": "<string>",
  "Vimeo": "<string>",
  "Tumblr": "<string>",
  "Blogger": "<string>",
  "CoworkerIds": "<string>",
  "CoworkerFullNames": "<string>",
  "CoworkerBillingNames": "<string>",
  "ActiveContracts": 123,
  "AvgChurnProbability": 123,
  "EngagementLevel": "<string>",
  "DisableAttendanceDashboard": true,
  "ExtraServices": [
    123
  ],
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}
A Team groups customers (coworkers) together for billing, access control, and administrative purposes. Teams can share invoicing, have a designated team leader, and be assigned dedicated resources such as desks or offices.

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 Team-Read role.

Path Parameters

id
integer
required
The Id of the Team record to retrieve.

Code Examples

curl -X GET \
  "https://spaces.nexudus.com/api/spaces/teams/87654321" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

BusinessId
integer
ID of the business linked to this record.
BusinessName
string
Business name.
Name
string
Team name.
Description
string
Team description.
TunnelPrivateGroupId
string
Tunnel private group ID.
TeamMembers
integer[]
List of team members linked to this record.
TeamAdministrators
integer[]
List of team administrators linked to this record.
CreateSingleInvoiceForTeam
boolean
Create a single invoice for the team.
UseSpecialPrices
boolean
Use special prices.
PayingMemberId
integer
ID of the paying member linked to this record.
PayingMemberFullName
string
Paying member full name.
PayingMemberCoworkerType
string
Paying member coworker type.
PayingMemberBillingName
string
Paying member billing name.
PayingMemberCompanyName
string
Paying member company name.
DefaultMemberTariffId
integer
ID of the default member tariff linked to this record.
DefaultMemberTariffName
string
Default member tariff name.
MaxTeamMemberCount
number
Maximum team member count.
TransferCreditsToPayingMember
boolean
Transfer credits to paying member.
ShareTimePasses
boolean
Share time passes.
ShareExtraServices
boolean
Share extra services.
ShareBookingCredit
boolean
Share booking credit.
DiscountExtraServices
number
Discount for extra services.
DiscountTimePasses
number
Discount for time passes.
DiscountCharges
number
Discount for charges.
DiscountTariffs
number
Discount for tariffs.
ProfileSummary
string
Profile summary.
ProfileTags
string
Profile tags.
ProfileWebsite
string
Profile website.
Google Maps link.
ProfileIsPublic
boolean
Whether the profile is public.
HasCommunityGroup
boolean
Whether the team has a community group.
TeamLogoFileName
string
Current file name of the team logo (read-only; upload via the corresponding URL field).
NewTeamLogoUrl
string
URL of a new file to upload as the team logo.
ClearTeamLogoFile
boolean
Set to true to remove the current team logo file.
TeamImage1FileName
string
Current file name of the team image1 (read-only; upload via the corresponding URL field).
NewTeamImage1Url
string
URL of a new file to upload as the team image1.
ClearTeamImage1File
boolean
Set to true to remove the current team image1 file.
TeamImage2FileName
string
Current file name of the team image2 (read-only; upload via the corresponding URL field).
NewTeamImage2Url
string
URL of a new file to upload as the team image2.
ClearTeamImage2File
boolean
Set to true to remove the current team image2 file.
TeamImage3FileName
string
Current file name of the team image3 (read-only; upload via the corresponding URL field).
NewTeamImage3Url
string
URL of a new file to upload as the team image3.
ClearTeamImage3File
boolean
Set to true to remove the current team image3 file.
Twitter
string
Twitter handle.
Facebook
string
Facebook URL.
Linkedin
string
LinkedIn URL.
Skype
string
Skype handle.
Telegram
string
Telegram handle.
Github
string
GitHub URL.
Pinterest
string
Pinterest URL.
Flickr
string
Flickr URL.
Instagram
string
Instagram URL.
Vimeo
string
Vimeo URL.
Tumblr
string
Tumblr URL.
Blogger
string
Blogger URL.
CoworkerIds
string
Coworker IDs.
CoworkerFullNames
string
Coworker full names.
CoworkerBillingNames
string
Coworker billing names.
ActiveContracts
integer
Number of active contracts.
AvgChurnProbability
number
Average churn probability.
EngagementLevel
string
Engagement level.
DisableAttendanceDashboard
boolean
Disable attendance dashboard.
ExtraServices
integer[]
List of extra services linked to this record.
Id
integer
Unique record identifier.
UniqueId
string
UUID of the record.
CreatedOn
string
Date and time the record was created (ISO 8601).
UpdatedOn
string
Date and time the record was last updated (ISO 8601).
UpdatedBy
string
Email of the user who last updated this record.
IsNew
boolean
Whether the record was recently created.
SystemId
string
External system identifier.
Example Response
{
  "BusinessId": 0,
  "BusinessName": null,
  "Name": "",
  "Description": null,
  "TunnelPrivateGroupId": null,
  "TeamMembers": [],
  "TeamAdministrators": [],
  "CreateSingleInvoiceForTeam": false,
  "UseSpecialPrices": false,
  "PayingMemberId": null,
  "PayingMemberFullName": null,
  "PayingMemberCoworkerType": null,
  "PayingMemberBillingName": null,
  "PayingMemberCompanyName": null,
  "DefaultMemberTariffId": null,
  "DefaultMemberTariffName": null,
  "MaxTeamMemberCount": null,
  "TransferCreditsToPayingMember": false,
  "ShareTimePasses": false,
  "ShareExtraServices": false,
  "ShareBookingCredit": false,
  "DiscountExtraServices": null,
  "DiscountTimePasses": null,
  "DiscountCharges": null,
  "DiscountTariffs": null,
  "ProfileSummary": null,
  "ProfileTags": null,
  "ProfileWebsite": null,
  "GoogleMapsLink": null,
  "ProfileIsPublic": false,
  "HasCommunityGroup": false,
  "TeamLogoFileName": null,
  "NewTeamLogoUrl": null,
  "ClearTeamLogoFile": null,
  "TeamImage1FileName": null,
  "NewTeamImage1Url": null,
  "ClearTeamImage1File": null,
  "TeamImage2FileName": null,
  "NewTeamImage2Url": null,
  "ClearTeamImage2File": null,
  "TeamImage3FileName": null,
  "NewTeamImage3Url": null,
  "ClearTeamImage3File": null,
  "Twitter": null,
  "Facebook": null,
  "Linkedin": null,
  "Skype": null,
  "Telegram": null,
  "Github": null,
  "Pinterest": null,
  "Flickr": null,
  "Instagram": null,
  "Vimeo": null,
  "Tumblr": null,
  "Blogger": null,
  "CoworkerIds": null,
  "CoworkerFullNames": null,
  "CoworkerBillingNames": null,
  "ActiveContracts": 0,
  "AvgChurnProbability": null,
  "EngagementLevel": null,
  "DisableAttendanceDashboard": false,
  "ExtraServices": [],
  "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": "Team Example",
  "LocalizationDetails": null,
  "CustomFields": null
}