GET

team

profiles

List Team Profiles

curl --request GET \
  --url https://spaces.nexudus.com/en/team/profiles \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/en/team/profiles"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/en/team/profiles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "[].CanAddNewMembers": true,
  "[].CanRemoveMembers": true,
  "[].CanCancelMembers": true,
  "[].Team": {},
  "[].RecentBookings": "<any>",
  "[].AllTeamMembers": [
    {}
  ],
  "[].AllTeamMembers[].Contracts": [
    {}
  ],
  "401 Unauthorized": {}
}

List Team Profiles

Returns an array of team profile summaries for teams the authenticated customer belongs to. Each entry includes the team’s details, permission flags (can add/remove/cancel members), all team members with their contracts, and recent bookings. Primarily used in the booking flow to populate the “book for team” selector.

This endpoint uses a view-style URL (/en/team/profiles) rather than the /api/public/ convention. It returns server-rendered JSON and is called with the bookForTeam=true query parameter in the booking context.

Authentication

Requires a valid customer bearer token.

Query Parameters

boolean

When true, scopes the response to teams the customer can book on behalf of. Added conditionally in the booking flow.

string

Comma-separated list of field paths to include in the response. When provided, only the specified fields are returned — useful for reducing payload size. Supports nested paths using dot notation.

Response

Returns an array of TeamProfile objects (not wrapped in a list envelope).

TeamProfile Fields

boolean

Whether the authenticated customer can add new members to this team.

boolean

Whether the authenticated customer can remove members from this team.

boolean

Whether the authenticated customer can cancel member contracts in this team.

Team

Full team object with the same fields as the response from GET /api/public/teams/{teamId}/profile.

any

Recent bookings made by team members.

AllTeamMember[]

Extended member objects that include contract information alongside standard Customer fields.

CoworkerContract[]

Active contracts for this member, including plan name, start date, next invoice date, price, and cancellation details.

Examples

Fetch team profiles for booking

GET /en/team/profiles?bookForTeam=true
Authorization: Bearer {token}

[
  {
    "CanAddNewMembers": true,
    "CanRemoveMembers": true,
    "CanCancelMembers": false,
    "Team": {
      "Id": 55,
      "Name": "Tech Innovators",
      "BusinessName": "Downtown Coworking Hub",
      "TeamMembersCount": 12,
      "ProfileSummary": "Building the future",
      "MaxTeamMemberCount": 20
    },
    "RecentBookings": null,
    "AllTeamMembers": [
      {
        "Id": 101,
        "FullName": "Jane Smith",
        "Email": "jane@techinnovators.com",
        "Contracts": [
          {
            "Id": 5001,
            "StartDate": "2024-01-15T00:00:00",
            "NextInvoice": "2025-02-01T00:00:00",
            "Price": 250.0,
            "CurrencyCode": "GBP"
          }
        ]
      }
    ]
  }
]

TypeScript Integration

import { endpoints } from '@/api/endpoints'
import { TeamProfiles } from '@/types/endpoints/TeamProfiles'
import { useData } from '@/hooks/useData'

const { resource: teamProfiles } = useData<TeamProfiles>(httpClient, endpoints.teams.profiles)

Usage in Portal

Context	Source file
Booking flow team selector (`/checkout/...`)	`src/views/public/checkout/booking/useBookingData.tsx`

Error Responses

error

The customer is not authenticated or the session has expired.

Method	Endpoint	Description
`GET`	`/api/public/teams/my`	List the customer’s teams
`GET`	`/api/public/teams/{teamId}/profile`	Full team profile
`POST`	`/api/public/teams/{teamId}/members`	Add members to a team

List Published TeamsReturns a paginated list of teams with public profiles, filterable by search query and tags.

List Team Profiles

curl --request GET \
  --url https://spaces.nexudus.com/en/team/profiles \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/en/team/profiles"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/en/team/profiles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "[].CanAddNewMembers": true,
  "[].CanRemoveMembers": true,
  "[].CanCancelMembers": true,
  "[].Team": {},
  "[].RecentBookings": "<any>",
  "[].AllTeamMembers": [
    {}
  ],
  "[].AllTeamMembers[].Contracts": [
    {}
  ],
  "401 Unauthorized": {}
}

​List Team Profiles

​Authentication

​Query Parameters

​Response

​TeamProfile Fields

​Examples

​Fetch team profiles for booking

​TypeScript Integration

​Usage in Portal

​Error Responses

​Related Endpoints

List Team Profiles

Authentication

Query Parameters

Response

TeamProfile Fields

Examples

Fetch team profiles for booking

TypeScript Integration

Usage in Portal

Error Responses

Related Endpoints