---
title: "Get a Space"
method: POST
path: "/spaces/get"
---

# Get a Space

`POST /spaces/get`

Gets a space.

## Request body

- union
  - object
    - `space_id` string, uuid, required — ID of the space that you want to get.
  - object
    - `space_key` string, required — Unique key of the space that you want to get.

## Response `200`

OK

- object
  - `space` Space, required — Represents a space that is a logical grouping of devices and entrances. You can assign access to an entire space, thereby making granting access more efficient. See the [space object](/api/spaces/object).
    - `acs_entrance_count` number, float, required — Number of entrances in the space.
    - `created_at` string, date-time, required — Date and time at which the space was created.
    - `customer_data` object — Reservation/stay-related defaults for the space. Also carries the provider/PMS-supplied name under a `<connector_type>_name` key (e.g. `guesty_name`), which Seam preserves when you rename the space (read-only — managed by Seam).
      - `address` string, nullable — Postal address for the space.
      - `default_checkin_time` string, nullable — Default check-in time for reservations at the space, as HH:mm or HH:mm:ss.
      - `default_checkout_time` string, nullable — Default check-out time for reservations at the space, as HH:mm or HH:mm:ss.
      - `time_zone` string, nullable — IANA time zone for the space, e.g. America/Los_Angeles.
    - `customer_key` string — Customer key associated with the space.
    - `device_count` number, float, required — Number of devices in the space.
    - `display_name` string, required — Display name for the space.
    - `geolocation` object, nullable — Geographic coordinates (latitude and longitude) of the space.
      - `latitude` number, float, required — Latitude of the space, in decimal degrees.
      - `longitude` number, float, required — Longitude of the space, in decimal degrees.
    - `name` string, required — Name of the space.
    - `space_id` string, uuid, required — ID of the space.
    - `space_key` string — Unique key for the space within the workspace.
    - `workspace_id` string, uuid, required — ID of the workspace associated with the space.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/seam/apis/seam-connect.md) · [All operations](https://skmtc.net/seam/apis/seam-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seam/seam-connect/versions/00c35395ce12/schema)