---
title: "get latest status of spaces"
method: GET
path: "/spaces/status"
tags: ["spaces"]
---

# get latest status of spaces

`GET /spaces/status`

## Request

- Base URL: `https://api.relynk.io/v2.0.0`
- URL: `https://api.relynk.io/v2.0.0/spaces/status`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

get latest status of spaces

## Query parameters

- `customerId` string, uuid, required
- `limit` integer
- `offset` integer
- `order` 'asc' | 'desc'
- `sort` 'id' | 'name'
- `name` string
- `name__contains` string
- `displayName` string
- `displayName__contains` string
- `id` string, uuid
- `type` string
- `subtype` string
- `levelNumber` integer
- `isPartOfSpaceId` string, uuid
- `path__contains` string
- `includeOptionalFields` string[]

## Response `200`

get status of spaces available

- SpaceStatus[]
  - `customerId` string, uuid, required: customer id
  - `id` string, uuid, required: space id
  - `name` string, nullable: space name
  - `displayName` string, nullable: space display name
  - `occupancy` number, nullable: space occupancy
  - `occupancyCount` integer, nullable: space occupancy count
  - `todaysBookingEvents` SpaceStatusBookingEvent[], nullable: space todays booking events
    - `multiDay` boolean, required: booking event spans multiple days
    - `start` string, date-time, required: booking event start
    - `end` string, date-time, required: booking event end
    - `organizerName` string, required: booking event organizer name
    - `organizerDomain` string, required: booking event organizer domain
    - `isCancelled` boolean, required: booking event is cancelled
    - `cancelledAt` string, date-time: booking event cancelled at
    - `resourceMailboxIsOrganizer` boolean, required: booking event resource mailbox is organizer
  - `temperature` number, nullable: space temperature
  - `temperatureUnit` string, nullable: space temperature unit
  - `humidity` number, nullable: space humidity
  - `humidityUnit` string, nullable: space humidity unit
  - `co2` number, nullable: space co2
  - `co2Unit` string, nullable: space co2 unit
  - `tvoc` number, nullable: space tvoc
  - `tvocUnit` string, nullable: space tvoc unit

---

[API](https://skmtc.dev/relynk/apis/relynk-api.md) - [All operations](https://skmtc.dev/relynk/apis/relynk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/relynk/apis/relynk-api/revisions/735d9d0efe06?raw)