Skip to main content
Pinecone Docs

Search documentation

Type to search this documentation.

On this pageOverview

Describe an index

Python
# pip install "pinecone[grpc]"
from pinecone.grpc import PineconeGRPC as Pinecone

pc = Pinecone(api_key="YOUR_API_KEY")

pc.describe_index(name="movie-recommendations")
JavaScript
// npm install @pinecone-database/pinecone
import { Pinecone } from '@pinecone-database/pinecone';

const pc = new Pinecone({ apiKey: 'YOUR_API_KEY' });

await pc.describeIndex('movie-recommendations');
Java
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);
    }
}
Go
package main

import (
    "context"
    "encoding/json"
    "fmt"
    "log"

    "github.com/pinecone-io/go-pinecone/v2/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))
    }
}
C#
using Pinecone;

var pinecone = new PineconeClient("YOUR_API_KEY");

var indexModel = await pinecone.DescribeIndexAsync("docs-example");

Console.WriteLine(indexModel);
curl
PINECONE_API_KEY="YOUR_API_KEY"

curl -i -X GET "https://api.pinecone.io/indexes/movie-recommendations" \
    -H "Api-Key: $PINECONE_API_KEY" \
    -H "X-Pinecone-Api-Version: 2024-10"
Python
{'dimension': 1536,
  'host': 'example-index-4mkljsz.svc.aped-4627-b74a.pinecone.io',
  'metric': 'cosine',
  'name': 'docs-example',
  'spec': {'serverless': {'cloud': 'aws', 'region': 'us-east-1'}},
  'status': {'ready': True, 'state': 'Ready'}}
JavaScript
{
  "name": "docs-example",
  "dimension": 1536,
  "metric": "cosine",
  "host": "example-index-4mkljsz.svc.aped-4627-b74a.pinecone.io",
  "deletionProtection": "disabled",
  "tags": { "environment": "development", "example": "tag" },
  "spec": { "pod": undefined, "serverless": { "cloud": "aws", "region": "us-east-1" } },
  "status": { "ready": true, "state": "Ready" }
}
Java
class IndexModel {
    name: example-index
    dimension: 1536
    metric: cosine
    host: example-index-4mkljsz.svc.aped-4627-b74a.pinecone.io
    deletionProtection: disabled
    spec: class IndexModelSpec {
        pod: null
        serverless: class ServerlessSpec {
            cloud: aws
            region: us-east-1
        }
    }
    status: class IndexModelStatus {
        ready: true
        state: Ready
    }
}
Go
index: {
  "name": "docs-example",
  "dimension": 1536,
  "host": "example-index-4mkljsz.svc.aped-4627-b74a.pinecone.io",
  "metric": "cosine",
  "deletion_protection": "disabled",
  "spec": {
    "serverless": {
      "cloud": "aws",
      "region": "us-east-1"
    }
  },
  "status": {
    "ready": true,
    "state": "Ready"
  },
  "tags": {
    "environment": "development",
    "example": "tag"
  }
}
C#
{
  "name": "docs-example",
  "dimension": 1536,
  "metric": "cosine",
  "host": "example-index-4mkljsz.svc.aped-4627-b74a.pinecone.io",
  "deletion_protection": "disabled",
  "spec": {
    "pod": null,
    "serverless": {
      "cloud": "aws",
      "region": "us-east-1"
    }
  },
  "status": {
    "ready": true,
    "state": "Ready"
  }
}
curl
{
    "name": "docs-example",
    "metric": "cosine",
    "dimension": 1536,
    "status": {
        "ready": true,
        "state": "Ready"
    },
    "host": "example-index-4mkljsz.svc.aped-4627-b74a.pinecone.io",
    "spec": {
        "serverless": {
            "region": "us-east-1",
            "cloud": "aws"
        }
    },
    "deletion_protection": "disabled",
    "tags": {
        "environment": "development",
        "example": "tag"
    }
}

GET /indexes/{index_name}

  • index_name (path, string, required) — The name of the index to be described.
  • 200 — Configuration information and deployment status of the index.
  • 401 — Unauthorized. Possible causes: Invalid API key.
  • 404 — Index not found.
  • 500 — Internal server error.
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu