Skip to main content
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-10"

{
    "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-10"

{
    "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.

Headers

​
X-Pinecone-Api-Version
string
default:2025-10
required

Required date-based version header

Response

List all the collections in your current project.

The list of collections that exist in the project.

​
collections
object[]

List of collections in the project