---
title: "Get the details of a collection"
method: GET
path: "/collections/{collectionId}"
tags: ["Collection"]
---

# Get the details of a collection

`GET /collections/{collectionId}`

This endpoint attempts to also list the shards currently available in the collection. Some shards may be temporarily unavailable. In that case, you can retry at a future time.

## Response `200`

Collection with available shard details

- GetCollectionResponse
  - `id` string — The unique identifier of the collection
  - `indexSchema` IndexSchema — The schema for the collection, each property can be indexed with a different type of index.
  - `shards` object[]
    - `id` string, uuid
    - `pointCount` number

## Other responses

- `503` — Something unexpected happened

## Changes

- **2024-04-12** (v2) `ee4f570ccf0d` — 2 warning
  - added the new `haversine` enum value to the `indexSchema/additionalProperties/vectorFlat/distanceMetric` response property for the response status `200`
  - added the new `haversine` enum value to the `indexSchema/additionalProperties/vectorVamana/distanceMetric` response property for the response status `200`
- **2024-04-11** (v2) `e6fd80307fb5` — 1 breaking, 2 warning, 1 info
  - the `shards/items/pointCount` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
  - removed the optional property `distanceMetric` from the response with the `200` status
  - removed the optional property `vectorSize` from the response with the `200` status
  - added the optional property `indexSchema` to the response with the `200` status
- **2024-04-10** (v2) `046167f9ac01` — 1 breaking, 2 warning, 1 info
  - the `vectorSize` response property's max was increased from `2000.00` to `4096.00` for the response status `200`
  - added the new `hamming` enum value to the `distanceMetric` response property for the response status `200`
  - added the new `jaccard` enum value to the `distanceMetric` response property for the response status `200`
  - the `id` response's property pattern was changed from `^[a-z0-9]{3,16}$` to `^[a-z0-9]{3,24}$` for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/semafind/apis/semadb-api/changes/collections/:collectionId/get.md)

---

[API](https://skmtc.dev/semafind/apis/semadb-api.md) · [All operations](https://skmtc.dev/semafind/apis/semadb-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/semafind/semadb-api/revisions/e756ed7c3cd3/schema)