GET
/
collections
PINECONE_API_KEY="YOUR_API_KEY"

curl -i -X GET "https://api.pinecone.io/collections" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-API-Version: 2025-04"

{
    "collections": [
        {
            "name": "example-collection1",
            "status": "Ready",
            "environment": "us-east-1-aws",
            "size": 3081918,
            "vector_count": 99,
            "dimension": 3
        },
        {
            "name": "example-collection1",
            "status": "Ready",
            "environment": "us-east-1-aws",
            "size": 160087040000000,
            "vector_count": 10000000,
            "dimension": 1536
        }
    ]
}

PINECONE_API_KEY="YOUR_API_KEY"

curl -i -X GET "https://api.pinecone.io/collections" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-API-Version: 2025-04"

{
    "collections": [
        {
            "name": "example-collection1",
            "status": "Ready",
            "environment": "us-east-1-aws",
            "size": 3081918,
            "vector_count": 99,
            "dimension": 3
        },
        {
            "name": "example-collection1",
            "status": "Ready",
            "environment": "us-east-1-aws",
            "size": 160087040000000,
            "vector_count": 10000000,
            "dimension": 1536
        }
    ]
}

Authorizations

​
Api-Key
string
header
required

An API Key is required to call Pinecone APIs. Get yours from the console.

Response

200
application/json
List all the collections in your current project.

The list of collections that exist in the project.

​
collections
object[]

The CollectionModel describes the configuration and status of a Pinecone collection.

Was this page helpful?