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

# List Spaces

`GET /v2/spaces`

## Request

- Base URL: `https://api.getauctor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getauctor.com/v2/spaces`
- Auth: none declared

## 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)
- `custom_field_id` string, nullable: Filter to account/project spaces whose template defines this custom field (the `id` returned by `GET /v2/spaces/{space_id}/custom-fields`). Combine with `custom_field_value` to match a specific value.
- `custom_field_value` string, nullable: Filter to spaces whose custom field equals this value. The stored value is compared as text, so numbers and booleans match their string form (`42`, `true`). Requires `custom_field_id`.
- `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

## Changes

- **2026-09-22** `a5de876e9fc3`: 2 info
  - added the new optional `query` request parameter `custom_field_id`
  - added the new optional `query` request parameter `custom_field_value`
- **2026-09-01** `aeb6faa3b8f0`: 2 info
  - added the new optional `query` request parameter `user_id`
  - removed the `personal` enum value from the `data/items/type` response property for the response status `200`

[Operation history](https://skmtc.dev/getauctor/apis/getauctor-api/changes/v2/spaces/get.md)

---

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