Skip to main content
Pinecone Docs

Search documentation

Type to search this documentation.

On this pageOverview

Describe a collection

Serverless indexes do not support collections.

curl
PINECONE_API_KEY="YOUR_API_KEY"

curl -i -X GET "https://api.pinecone.io/collections/tiny-collection" \
    -H "Api-Key: $PINECONE_API_KEY" \
    -H "X-Pinecone-Api-Version: 2026-04"
curl
{
    "name": "example-collection",
    "status": "Ready",
    "environment": "us-east-1-aws",
    "size": 3075398,
    "vector_count": 99,
    "dimension": 1536
}

GET /collections/{collection_name}

  • X-Pinecone-Api-Version (header, string, required) — Required date-based version header
  • collection_name (path, string, required) — The name of the collection to be described.
  • 200 — Configuration information and status of the collection.
  • 401 — Unauthorized. Possible causes: Invalid API key.
  • 404 — Collection not found.
  • 500 — Internal server error.
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu