---
title: "Describe a collection"
method: GET
path: "/collections/{collection_name}"
tags: ["Manage Indexes"]
---

# Describe a collection

`GET /collections/{collection_name}`

Get a description of a collection.
Serverless indexes do not support collections.

## Path parameters

- `collection_name` string, required

## Headers

- `X-Pinecone-Api-Version` string, required

## Response `200`

Configuration information and status of the collection.

- DbControlCollectionModel — The CollectionModel describes the configuration and status of a Pinecone collection.
  - `name` string, required — The name of the collection.
  - `size` integer — The size of the collection in bytes.
  - `status` string, required — The status of the collection. Possible values: `Initializing`, `Ready`, or `Terminating`.
  - `dimension` integer — The dimension of the vectors stored in each record held in the collection.
  - `vector_count` integer — The number of records stored in the collection.
  - `environment` string, required — The environment where the collection is hosted.

## Other responses

- `401` — Unauthorized. Possible causes: Invalid API key.
- `404` — Collection not found.
- `500` — Internal server error.

---

[API](https://skmtc.net/pinecone/apis/pinecone-api.md) · [All operations](https://skmtc.net/pinecone/apis/pinecone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinecone/pinecone-api/versions/35876583485d/schema)