Skip to main content
POST
/
describe_index_stats
# To get the unique host for an index,
# see https://docs.pinecone.io/guides/manage-data/target-an-index
PINECONE_API_KEY="YOUR_API_KEY"
INDEX_HOST="YOUR_INDEX_HOST"

curl -X POST "https://$INDEX_HOST/describe_index_stats" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-Api-Version: 2025-10"
// EXAMPLE RESPONSE 1: Serverless index (on-demand)
{
  "namespaces": {
    "example-namespace": {
      "vectorCount": 10000
    }
  },
  "indexFullness": 0,
  "totalVectorCount": 10000,
  "dimension": 1024,
  "metric": "cosine",
  "vectorType": "dense"
}

// EXAMPLE RESPONSE 2: Serverless index (dedicated)
{
  "namespaces": {
    "example-namespace": {
      "vectorCount": 10000
    }
  },
  "indexFullness": 0.000309539,
  "totalVectorCount": 10000,
  "dimension": 1536,
  "metric": "cosine",
  "vectorType": "dense"
}
# To get the unique host for an index,
# see https://docs.pinecone.io/guides/manage-data/target-an-index
PINECONE_API_KEY="YOUR_API_KEY"
INDEX_HOST="YOUR_INDEX_HOST"

curl -X POST "https://$INDEX_HOST/describe_index_stats" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-Api-Version: 2025-10"
// EXAMPLE RESPONSE 1: Serverless index (on-demand)
{
  "namespaces": {
    "example-namespace": {
      "vectorCount": 10000
    }
  },
  "indexFullness": 0,
  "totalVectorCount": 10000,
  "dimension": 1024,
  "metric": "cosine",
  "vectorType": "dense"
}

// EXAMPLE RESPONSE 2: Serverless index (dedicated)
{
  "namespaces": {
    "example-namespace": {
      "vectorCount": 10000
    }
  },
  "indexFullness": 0.000309539,
  "totalVectorCount": 10000,
  "dimension": 1536,
  "metric": "cosine",
  "vectorType": "dense"
}

Authorizations

Api-Key
string
header
required

Headers

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

Body

application/json
filter
object

Response

namespaces
object
dimension
integer
Example:
indexFullness
number
Example:
totalVectorCount
integer
Example:
metric
string
Example:
vectorType
string
Example:
memory_fullness
number
storage_fullness
number