Skip to main content
GET
/
collections
/
{collection_name}
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: 2025-10"

{
    "name": "example-collection",
    "status": "Ready",
    "environment": "us-east-1-aws",
    "size": 3075398,
    "vector_count": 99,
    "dimension": 1536
}

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: 2025-10"

{
    "name": "example-collection",
    "status": "Ready",
    "environment": "us-east-1-aws",
    "size": 3075398,
    "vector_count": 99,
    "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

Path Parameters

​
collection_name
string
required

The name of the collection to be described.

Response

Configuration information and status of the collection.

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

​
name
string
required

The name of the collection.

Example:

"example-collection"

​
status
string
required

The status of the collection. Possible values: Initializing, Ready, or Terminating.

Example:

"Initializing"

​
environment
string
required

The environment where the collection is hosted.

Example:

"us-east1-gcp"

​
size
integer<int64>

The size of the collection in bytes.

Example:

10000000

​
dimension
integer<int32>

The dimension of the vectors stored in each record held in the collection.

Required range: 1 <= x <= 20000
Example:

1536

​
vector_count
integer<int32>

The number of records stored in the collection.

Example:

120000