---
title: "List the spaces this key can read: scanned with the app (live keys) and created through the API"
method: GET
path: "/spaces"
---

# List the spaces this key can read: scanned with the app (live keys) and created through the API

`GET /spaces`

## Request

- Base URL: `https://api.spacecontext.app/v1`
- URL: `https://api.spacecontext.app/v1/spaces`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `source` 'app' | 'api'

## Response `200`

Spaces page

- SpaceListResponse
  - `data` SpaceSummary[], required
    - `object` 'space', required
    - `id` string, required
    - `source` 'app' | 'api', required
    - `name` string, required
    - `space_type` 'apartment' | 'house' | 'office' | 'warehouse' | 'vehicle' | 'boat' | 'camper' | 'shop' | 'garage' | 'appliance' | 'other' | 'null', nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `latest_scan` object, nullable, required
      - `id` string, required
      - `analyzed_at` string, date-time, nullable, required
      - `areas` integer, required
      - `items` integer, required
      - `issues` integer, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response
- `429`: Too many requests. Retry after the number of seconds in `Retry-After`.

---

[API](https://skmtc.dev/spacecontext/apis/space-context-api.md) · [All operations](https://skmtc.dev/spacecontext/apis/space-context-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacecontext/apis/space-context-api/revisions/1dca940259b4?raw)