---
title: "List spaces"
method: GET
path: "/spaces/"
tags: ["space"]
---

# List spaces

`GET /spaces/`

## Request

- Base URL: `https://api.angelcam.com/v1`
- URL: `https://api.angelcam.com/v1/spaces/`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://my.angelcam.com/oauth/authorize/`, token URL `https://my.angelcam.com/oauth/token/`
    - Password, token URL `https://api.angelcam.com/oauth/token/`
    - Scopes: `space_access`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/angelcam/apis/angelcam-api/docs/spaces/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all spaces the authenticated user belongs to. Use the `is_default` flag to identify the user's default space. To operate within a specific space, pass the `X-Space-Id` request header with the desired space ID.

## Response `200`

List of spaces the user belongs to.

- SpaceObject[]
  - `id` integer, required: Space ID.
  - `name` string, required: Display name of the space.
  - `is_default` boolean, required: Whether this is the user's default space.
  - `owner_email` string, email, nullable: Email address of the space owner.
  - `owner_first_name` string, nullable: First name of the space owner.
  - `owner_last_name` string, nullable: Last name of the space owner.

## Other responses

- `401`: Missing or invalid authorization.
- `403`: Missing permission.

---

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