---
title: "List collections"
method: GET
path: "/api/v2/tenants/{tenant}/databases/{database}/collections"
tags: ["Collection"]
---

# List collections

`GET /api/v2/tenants/{tenant}/databases/{database}/collections`

Lists all collections in a database.

## Path parameters

- `tenant` string, required
- `database` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

List of collections

- object[]
  - `configuration_json` CollectionConfiguration, required
    - `embedding_function` union
      - object
        - `type` 'legacy', required
      - object
        - `config` unknown, required
        - `name` string, required
        - `type` 'known', required
      - object
        - `type` 'unknown', required
    - `hnsw` HnswConfiguration
      - `ef_construction` integer, nullable
      - `ef_search` integer, nullable
      - `max_neighbors` integer, nullable
      - `resize_factor` number, double, nullable
      - `space` 'l2' | 'cosine' | 'ip'
      - `sync_threshold` integer, nullable
    - `spann` SpannConfiguration
      - `ef_construction` integer, nullable
      - `ef_search` integer, nullable
      - `max_neighbors` integer, nullable
      - `merge_threshold` integer, nullable
      - `reassign_neighbor_count` integer, nullable
      - `search_nprobe` integer, nullable
      - `space` 'l2' | 'cosine' | 'ip'
      - `split_threshold` integer, nullable
      - `write_nprobe` integer, nullable
  - `database` string, required
  - `dimension` integer, nullable
  - `id` string, uuid, required
  - `log_position` integer, required
  - `metadata` HashMap
  - `name` string, required
  - `schema` Schema — Schema representation for collection index configurations This represents the server-side schema structure used for index management
    - `cmek` object, nullable — Customer-managed encryption key for collection data
    - `defaults` ValueTypes, required — Strongly-typed value type configurations Contains optional configurations for each supported value type
      - `bool` BoolValueType — Boolean value type index configurations
        - `bool_inverted_index` BoolInvertedIndexType
          - `config` BoolInvertedIndexConfig, required
          - `enabled` boolean, required
      - `float` FloatValueType — Float value type index configurations
        - `float_inverted_index` FloatInvertedIndexType
          - `config` FloatInvertedIndexConfig, required
          - `enabled` boolean, required
      - `float_list` FloatListValueType — Float list value type index configurations (for vectors)
        - `vector_index` VectorIndexType
          - `config` VectorIndexConfig, required
            - `embedding_function` union
              - …
            - `hnsw` HnswIndexConfig — Configuration for HNSW vector index algorithm parameters
              - …
            - `source_key` string, nullable — Key to source the vector from
            - `space` 'l2' | 'cosine' | 'ip'
            - `spann` SpannIndexConfig — Configuration for SPANN vector index algorithm parameters
              - …
          - `enabled` boolean, required
      - `int` IntValueType — Integer value type index configurations
        - `int_inverted_index` IntInvertedIndexType
          - `config` IntInvertedIndexConfig, required
          - `enabled` boolean, required
      - `sparse_vector` SparseVectorValueType — Sparse vector value type index configurations
        - `sparse_vector_index` SparseVectorIndexType
          - `config` SparseVectorIndexConfig, required
            - `algorithm` 'wand' | 'max_score' — Sparse vector index algorithm. Controls which posting list format and query engine are used for sparse vector search within a collection.
            - `bm25` boolean, nullable — Whether this embedding is BM25
            - `embedding_function` union
              - …
            - `source_key` string, nullable — Key to source the sparse vector from
          - `enabled` boolean, required
      - `string` StringValueType — String value type index configurations
        - `fts_index` FtsIndexType
          - `config` FtsIndexConfig, required
            - `algorithm` 'trigram' | 'token_bitmap' — Full-text search index algorithm. Controls which index format and query pipeline are used for document substring search within a collection.
          - `enabled` boolean, required
        - `string_inverted_index` StringInvertedIndexType
          - `config` StringInvertedIndexConfig, required
          - `enabled` boolean, required
    - `keys` object, required — Key-specific index overrides TODO(Sanket): Needed for backwards compatibility. Should remove after deploy.
  - `tenant` string, required
  - `version` integer, required

## Other responses

- `401` — Unauthorized
- `500` — Server error

---

[API](https://skmtc.net/trychroma/apis/chroma-frontend.md) · [All operations](https://skmtc.net/trychroma/apis/chroma-frontend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trychroma/chroma-frontend/versions/9b96550f70f6/schema)