Describe an index
# pip install "pinecone[grpc]"
from pinecone.grpc import PineconeGRPC as Pinecone
pc = Pinecone(api_key="YOUR_API_KEY")
pc.describe_index(name="movie-recommendations")// npm install @pinecone-database/pinecone
import { Pinecone } from '@pinecone-database/pinecone';
const pc = new Pinecone({ apiKey: 'YOUR_API_KEY' });
await pc.describeIndex('movie-recommendations');import io.pinecone.clients.Pinecone;
import org.openapitools.db_control.client.model.*;
public class DescribeIndexExample {
public static void main(String[] args) {
Pinecone pc = new Pinecone.Builder("YOURE_API_KEY").build();
IndexModel indexModel = pc.describeIndex("movie-recommendations");
System.out.println(indexModel);
}
}package main
import (
"context"
"encoding/json"
"fmt"
"log"
"github.com/pinecone-io/go-pinecone/v4/pinecone"
)
func prettifyStruct(obj interface{}) string {
bytes, _ := json.MarshalIndent(obj, "", " ")
return string(bytes)
}
func main() {
ctx := context.Background()
pc, err := pinecone.NewClient(pinecone.NewClientParams{
ApiKey: "YOUR_API_KEY",
})
if err != nil {
log.Fatalf("Failed to create Client: %v", err)
}
idx, err := pc.DescribeIndex(ctx, "movie-recommendations")
if err != nil {
log.Fatalf("Failed to describe index \"%v\": %v", idx.Name, err)
} else {
fmt.Printf("index: %v\n", prettifyStruct(idx))
}
}using Pinecone;
var pinecone = new PineconeClient("YOUR_API_KEY");
var indexModel = await pinecone.DescribeIndexAsync("");
Console.WriteLine(indexModel);PINECONE_API_KEY="YOUR_API_KEY"
curl -X GET "https://api.pinecone.io/indexes/movie-recommendations" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2025-04"# Target the project that contains the index
pc target -o "example-org" -p "example-project"
# Describe the index.
pc index describe --name "movie-recommendations"{'deletion_protection': 'disabled',
'dimension': 1536,
'host': 'movie-recommendations-1c6ab6aa.svc.aped-4627-b74a.pinecone.io',
'metric': 'cosine',
'name': 'movie-recommendations',
'spec': {'serverless': {'cloud': 'aws', 'region': 'us-east-1'}},
'status': {'ready': True, 'state': 'Ready'},
'tags': {'environment': 'development'},
'vector_type': 'dense'}{
"name": "movie-recommendations",
"dimension": 1536,
"metric": "cosine",
"host": "movie-recommendations-1c6ab6aa.svc.aped-4627-b74a.pinecone.io",
"deletionProtection": "disabled",
"tags": { "environment": "development", "example": "tag" },
"embed": undefined,
"spec": { "pod": undefined, "serverless": { "cloud": "aws", "region": "us-east-1" } },
"status": { "ready": true, "state": "Ready" },
"vectorType": "dense"
}class IndexModel {
name: movie-recommendations
dimension: 1536
metric: cosine
host: movie-recommendations-1c6ab6aa.svc.aped-4627-b74a.pinecone.io
deletionProtection: disabled
tags: {environment=development}
embed: null
spec: class IndexModelSpec {
pod: null
serverless: class ServerlessSpec {
cloud: aws
region: us-east-1
additionalProperties: null
}
additionalProperties: null
}
status: class IndexModelStatus {
ready: true
state: Ready
additionalProperties: null
}
vectorType: dense
additionalProperties: null
}index: {
"name": "movie-recommendations",
"host": "movie-recommendations-1c6ab6aa.svc.aped-4627-b74a.pinecone.io",
"metric": "cosine",
"vector_type": "dense",
"deletion_protection": "disabled",
"dimension": 1536,
"spec": {
"serverless": {
"cloud": "aws",
"region": "us-east-1"
}
},
"status": {
"ready": true,
"state": "Ready"
},
"tags": {
"environment": "development"
}
}{
"name": "movie-recommendations",
"dimension": 1536,
"metric": "cosine",
"host": "movie-recommendations-1c6ab6aa.svc.aped-4627-b74a.pinecone.io",
"deletion_protection": "disabled",
"tags": {
"environment": "development"
},
"spec": {
"serverless": {
"cloud": "aws",
"region": "us-east-1"
}
},
"status": {
"ready": true,
"state": "Ready"
},
"vector_type": "dense"
}{
"name": "movie-recommendations",
"vector_type": "dense",
"metric": "cosine",
"dimension": 1536,
"status": {
"ready": true,
"state": "Ready"
},
"host": "movie-recommendations-1c6ab6aa.svc.aped-4627-b74a.pinecone.io",
"spec": {
"serverless": {
"region": "us-east-1",
"cloud": "aws"
}
},
"deletion_protection": "disabled",
"tags": {
"environment": "development"
}
}ATTRIBUTE VALUE
Name movie-recommendations
Dimension 1536
Metric cosine
Deletion Protection disabled
Vector Type dense
State Ready
Ready true
Host movie-recommendations-1c6ab6aa.svc.aped-4627-b74a.pinecone.io
Private Host <none>
Spec serverless
Cloud aws
Region us-east-1
Source Collection <none>GET /indexes/{index_name}
Parameters
Section titled “Parameters”index_name(path, string, required) — The name of the index to be described.
Responses
Section titled “Responses”200— Configuration information and deployment status of the index.401— Unauthorized. Possible causes: Invalid API key.404— Index not found.500— Internal server error.