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

# List Spaces

`GET /v2/spaces`

## Query parameters

- `type` 'account' | 'project' | 'organization', nullable — Filter spaces by scope. Only `account`, `project`, and `organization` are filterable. Personal spaces are organization-exclusive and are never returned by this org-scoped listing, so `personal` is not a valid filter value and personal spaces are already excluded by default.
- `parent_id` string, nullable
- `user_id` string, nullable — Filter to spaces the given user is a member of
- `external_id` string, nullable — Filter by external ID value
- `external_id_type` 'jira' | 'linear' | 'azure_devops' | 'hubspot' | 'salesforce' | 'snow_acct' | 'snow_opp', nullable — External ID provider type (required when external_id is provided)
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- SpacesListResponse
  - `data` SpaceResponse[], required
    - `id` string, required
    - `external_ids` object, nullable, required
    - `parent_id` string, nullable, required
    - `type` 'organization' | 'account' | 'project', required — Scope of the space. The v2 spaces API is organization-scoped, so only `organization`, `account`, and `project` spaces are ever returned; personal spaces (`organization_id IS NULL`) are never returned by these endpoints.
    - `name` string, required
    - `created_at` string, required
    - `crm_integration` CrmIntegration
      - `deal` CrmDeal
        - `id` string, required
        - `name` string, required
        - `amount` number, nullable
        - `stage` string, nullable
        - `close_date` string, nullable
        - `currency` string, nullable
        - `external_url` string, nullable
        - `provider` 'hubspot' | 'salesforce', required
  - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getauctor/apis/fastapi.md) · [All operations](https://skmtc.dev/getauctor/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getauctor/fastapi/revisions/aeb6faa3b8f0/schema)