---
title: "List Collections"
method: GET
path: "/collections"
tags: ["collections"]
---

# List Collections

`GET /collections`

Retrieve all collections belonging to your organization.

Collections are containers that group related data from one or more source
connections, enabling unified search across multiple data sources.

Results are sorted by creation date (newest first) and support pagination
and text search filtering.

## Query parameters

- `skip` integer — Number of collections to skip for pagination
- `limit` integer — Maximum number of collections to return (1-1000)
- `search` string — Search term to filter collections by name or readable_id

## Response `200`

Successful Response

- Collection[]
  - `name` string, required — Human-readable display name for the collection.
  - `readable_id` string, required — URL-safe unique identifier used in API endpoints. This becomes non-optional once the collection is created.
  - `id` string, uuid, required — Unique system identifier for the collection. This UUID is generated automatically and used for internal references.
  - `sync_config` SyncConfig — Sync configuration with automatic env var loading. Env vars use double underscore as delimiter: SYNC_CONFIG__HANDLERS__ENABLE_VECTOR_HANDLERS=false
    - `destinations` DestinationConfig — Controls where entities are written.
      - `skip_vespa` boolean — Skip writing to native Vespa
      - `target_destinations` string[], nullable — If set, ONLY write to these destination UUIDs
      - `exclude_destinations` string[], nullable — Skip these destination UUIDs
    - `handlers` HandlerConfig — Controls which handlers run during sync.
      - `enable_vector_handlers` boolean — Enable VectorDBHandler
      - `enable_raw_data_handler` boolean — Enable RawDataHandler (ARF)
      - `enable_postgres_handler` boolean — Enable EntityPostgresHandler
    - `cursor` CursorConfig — Controls incremental sync cursor behavior.
      - `skip_load` boolean — Don't load cursor (fetch all entities)
      - `skip_updates` boolean — Don't persist cursor progress
    - `behavior` BehaviorConfig — Miscellaneous execution behavior flags.
      - `skip_hash_comparison` boolean — Force INSERT for all entities
      - `replay_from_arf` boolean — Replay from ARF storage instead of calling source
      - `skip_guardrails` boolean — Skip usage guardrails (entity count checks)
  - `created_at` string, date-time, required — Timestamp when the collection was created (ISO 8601 format).
  - `modified_at` string, date-time, required — Timestamp when the collection was last modified (ISO 8601 format).
  - `organization_id` string, uuid, required — Identifier of the organization that owns this collection. Collections are isolated per organization.
  - `created_by_email` string, email, nullable — Email address of the user who created this collection.
  - `modified_by_email` string, email, nullable — Email address of the user who last modified this collection.
  - `status` 'ACTIVE' | 'NEEDS SOURCE' | 'ERROR' — Collection status enum.
  - `vector_size` integer, required — Vector dimensions used by this collection (derived from deployment metadata).
  - `embedding_model_name` string, required — Name of the embedding model used for this collection (derived from deployment metadata).
  - `source_connection_summaries` SourceConnectionSummary[] — Lightweight list of source connections attached to this collection. Contains only short_name and name, suitable for rendering icons in list views.
    - `short_name` string, required
    - `name` string, required

## Other responses

- `422` — Validation Error
- `429` — Rate Limit Exceeded

---

[API](https://skmtc.net/airweave-ai/apis/airweave.md) · [All operations](https://skmtc.net/airweave-ai/apis/airweave/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/airweave-ai/airweave/revisions/bf410c28c0c6/schema)