GET

api

public

teams

{teamId}

attendance

Get Team Attendance

curl --request GET \
  --url https://spaces.nexudus.com/api/public/teams/{teamId}/attendance \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/public/teams/{teamId}/attendance"

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/api/public/teams/{teamId}/attendance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "IsTeamAdministrator": true,
  "Attendance": {},
  "Attendance.TeamId": 123,
  "Attendance.TeamName": "<string>",
  "Attendance.AvgBookedMinutesPerWeek": 123,
  "Attendance.AvgBookingsCoworkersPerDay": 123,
  "Attendance.AvgCheckedinCoworkersPerDay": 123,
  "Attendance.AvgCheckinsDaysPerWeek": 123,
  "Attendance.Coworkers[].CoworkerId": 123,
  "Attendance.Coworkers[].CoworkerFullName": "<string>",
  "Attendance.Coworkers[].CoworkerType": 123,
  "Attendance.Coworkers[].CoworkerCompanyName": {},
  "Attendance.Coworkers[].MondayAttendance": {},
  "Attendance.Coworkers[].TuesdayAttendance": {},
  "Attendance.Coworkers[].WednesdayAttendance": {},
  "Attendance.Coworkers[].ThursdayAttendance": {},
  "Attendance.Coworkers[].FridayAttendance": {},
  "Attendance.Coworkers[].SaturdayAttendance": {},
  "Attendance.Coworkers[].SundayAttendance": {},
  "Attendance.Days[].Date": "<string>",
  "Attendance.Days[].Bookings": [
    {}
  ],
  "Attendance.Days[].Bookings[].Id": 123,
  "Attendance.Days[].Bookings[].FromTime": "<string>",
  "Attendance.Days[].Bookings[].ToTime": "<string>",
  "Attendance.Days[].Bookings[].ResourceId": 123,
  "Attendance.Days[].Bookings[].ResourceName": "<string>",
  "Attendance.Days[].Bookings[].CoworkerId": {},
  "401 Unauthorized": {},
  "404 Not Found": {}
}

Get Team Attendance

Returns the attendance matrix for a team centred on a given date. Includes per-member day-of-week attendance preferences (office, home, abroad, not working), aggregate statistics, and any bookings overlapping the requested week.

Authentication

Requires a valid customer bearer token. The customer must be a member or administrator of the specified team.

Path Parameters

number

required

Numeric identifier of the team. Returned as Id from GET /api/public/teams/my.

Query Parameters

string

required

ISO 8601 UTC datetime specifying the week to retrieve. The API returns the full week containing this date.

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

boolean

Whether the authenticated customer is an administrator of this team. Used by the portal to show or hide the attendance editing UI.

TeamAttendanceDetails

required

The attendance data object.

Attendance Details

number

Numeric identifier of the team.

string

Display name of the team.

number

Average booked minutes per week across all members.

number

Average number of members with bookings per day.

number

Average number of members checked in per day.

number

Average check-in days per week.

Attendance.Coworkers[]

number

Numeric identifier of the member.

string

Display name of the member.

number

Member type code.

string | undefined

Company name associated with the member, if any.

eCoworkerAttendance

Monday attendance status: 1 = Office, 2 = Home, 3 = Abroad, 4 = Not Working, 5 = Undefined.

eCoworkerAttendance

Tuesday attendance status (same values as Monday).

eCoworkerAttendance

Wednesday attendance status.

eCoworkerAttendance

Thursday attendance status.

eCoworkerAttendance

Friday attendance status.

eCoworkerAttendance

Saturday attendance status.

eCoworkerAttendance

Sunday attendance status.

Attendance.Days[]

string

ISO 8601 date for this day.

AttendanceBooking[]

Bookings on this day.

number

Booking identifier.

string

Booking start time.

string

Booking end time.

number

Identifier of the booked resource.

string

Name of the booked resource.

number | undefined

Customer who owns the booking, if applicable.

Examples

Fetch attendance for a week

GET /api/public/teams/55/attendance?date=2025-01-20T00:00:00.000Z
Authorization: Bearer {token}

{
  "IsTeamAdministrator": true,
  "Attendance": {
    "TeamId": 55,
    "TeamName": "Tech Innovators",
    "AvgBookedMinutesPerWeek": 480,
    "AvgBookingsCoworkersPerDay": 3,
    "AvgCheckedinCoworkersPerDay": 5,
    "AvgCheckinsDaysPerWeek": 4.2,
    "Coworkers": [
      {
        "CoworkerId": 101,
        "CoworkerFullName": "Jane Smith",
        "CoworkerType": 1,
        "CoworkerCompanyName": "Tech Innovators Ltd",
        "MondayAttendance": 1,
        "TuesdayAttendance": 1,
        "WednesdayAttendance": 2,
        "ThursdayAttendance": 1,
        "FridayAttendance": 2,
        "SaturdayAttendance": 4,
        "SundayAttendance": 4
      }
    ],
    "Days": [
      {
        "Date": "2025-01-20T00:00:00",
        "Bookings": [
          {
            "Id": 5001,
            "FromTime": "09:00",
            "ToTime": "17:00",
            "ResourceId": 201,
            "ResourceName": "Meeting Room A",
            "CoworkerId": 101
          }
        ]
      }
    ]
  }
}

TypeScript Integration

import { endpoints } from '@/api/endpoints'
import { TeamAttendance } from '@/types/endpoints/TeamAttandance'
import { useData } from '@/hooks/useData'
import { DateTime } from 'luxon'

const { resource: attendance } = useData<TeamAttendance>(httpClient, endpoints.teams.attendance(teamId, DateTime.now()))

Usage in Portal

Context	Source file
Team dashboard attendance KPIs (`/dashboard/team/{teamId}`)	`src/views/user/dashboards/team/components/TeamAttendanceKpiSection.tsx`
Team attendance section (`/team/attendance/{teamId}`)	`src/views/user/team/attendance/components/TeamAttedanceSection.tsx`
Attendance management (`/team/attendance/{teamId}`)	`src/views/user/team/attendance/components/AttendanceManagementSection.tsx`

Error Responses

error

The customer is not authenticated or the session has expired.

error

Team with the specified ID does not exist.

Method	Endpoint	Description
`PUT`	`/api/public/teams/{teamId}/attendance`	Update member attendance preferences
`GET`	`/api/public/teams/{teamId}/kpi`	Team KPI data
`GET`	`/api/public/teams/{teamId}/metrics`	Team performance metrics
`GET`	`/api/public/teams/{teamId}/profile`	Full team profile

Update Team AttendanceUpdates per-member weekly attendance preferences for a team.

Get Team Attendance

curl --request GET \
  --url https://spaces.nexudus.com/api/public/teams/{teamId}/attendance \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/public/teams/{teamId}/attendance"

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/api/public/teams/{teamId}/attendance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "IsTeamAdministrator": true,
  "Attendance": {},
  "Attendance.TeamId": 123,
  "Attendance.TeamName": "<string>",
  "Attendance.AvgBookedMinutesPerWeek": 123,
  "Attendance.AvgBookingsCoworkersPerDay": 123,
  "Attendance.AvgCheckedinCoworkersPerDay": 123,
  "Attendance.AvgCheckinsDaysPerWeek": 123,
  "Attendance.Coworkers[].CoworkerId": 123,
  "Attendance.Coworkers[].CoworkerFullName": "<string>",
  "Attendance.Coworkers[].CoworkerType": 123,
  "Attendance.Coworkers[].CoworkerCompanyName": {},
  "Attendance.Coworkers[].MondayAttendance": {},
  "Attendance.Coworkers[].TuesdayAttendance": {},
  "Attendance.Coworkers[].WednesdayAttendance": {},
  "Attendance.Coworkers[].ThursdayAttendance": {},
  "Attendance.Coworkers[].FridayAttendance": {},
  "Attendance.Coworkers[].SaturdayAttendance": {},
  "Attendance.Coworkers[].SundayAttendance": {},
  "Attendance.Days[].Date": "<string>",
  "Attendance.Days[].Bookings": [
    {}
  ],
  "Attendance.Days[].Bookings[].Id": 123,
  "Attendance.Days[].Bookings[].FromTime": "<string>",
  "Attendance.Days[].Bookings[].ToTime": "<string>",
  "Attendance.Days[].Bookings[].ResourceId": 123,
  "Attendance.Days[].Bookings[].ResourceName": "<string>",
  "Attendance.Days[].Bookings[].CoworkerId": {},
  "401 Unauthorized": {},
  "404 Not Found": {}
}

​Get Team Attendance

​Authentication

​Path Parameters

​Query Parameters

​Response

​Attendance Details

​Attendance.Coworkers[]

​Attendance.Days[]

​Examples

​Fetch attendance for a week

​TypeScript Integration

​Usage in Portal

​Error Responses

​Related Endpoints

Get Team Attendance

Authentication

Path Parameters

Query Parameters

Response

Attendance Details

Attendance.Coworkers[]

Attendance.Days[]

Examples

Fetch attendance for a week

TypeScript Integration

Usage in Portal

Error Responses

Related Endpoints