# pip install --upgrade pinecone
import os
from pinecone import Pinecone
pc = Pinecone(api_key=os.environ["PINECONE_API_KEY"])
for index_model in pc.indexes.list():
print(index_model.name, index_model.host, index_model.status.state)
// npm install @pinecone-database/pinecone
import { Pinecone } from '@pinecone-database/pinecone';
// Reads PINECONE_API_KEY from the environment
const pc = new Pinecone();
const { indexes = [] } = await pc.indexes.list();
for (const indexModel of indexes) {
console.log(indexModel.name, indexModel.host, indexModel.status.state);
}
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/pinecone-io/go-pinecone/v7/pinecone"
)
func main() {
ctx := context.Background()
pc, err := pinecone.NewClient(pinecone.NewClientParams{
ApiKey: os.Getenv("PINECONE_API_KEY"),
})
if err != nil {
log.Fatalf("Failed to create Client: %v", err)
}
idxs, err := pc.ListIndexes(ctx)
if err != nil {
log.Fatalf("Failed to list indexes: %v", err)
}
for _, idx := range idxs {
fmt.Println(idx.Name, idx.Host, idx.Status.State)
}
}
# Requires Terraform provider v5.0.0 or later
data "pinecone_indexes" "all" {}
output "indexes" {
value = {
for index in coalesce(data.pinecone_indexes.all.indexes, []) : index.name => {
host = index.host
state = index.status.state
}
}
}
PINECONE_API_KEY="YOUR_API_KEY"
curl "https://api.pinecone.io/indexes" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-07"
{
"indexes": [
{
"deletion_protection": "disabled",
"deployment": {
"cloud": "aws",
"deployment_type": "managed",
"region": "us-east-1"
},
"host": "movie-recommendations-c01b5b5.svc.us-east1-gcp.pinecone.io",
"name": "movie-recommendations",
"read_capacity": {
"mode": "OnDemand",
"status": {
"state": "Ready"
}
},
"schema": {
"fields": {
"your_vector": {
"dimension": 1536,
"metric": "cosine",
"type": "dense_vector"
}
}
},
"status": {
"ready": true,
"state": "Ready"
}
}
]
}Indexes
List indexes
List all indexes in a project.
GET
/
indexes
# pip install --upgrade pinecone
import os
from pinecone import Pinecone
pc = Pinecone(api_key=os.environ["PINECONE_API_KEY"])
for index_model in pc.indexes.list():
print(index_model.name, index_model.host, index_model.status.state)
// npm install @pinecone-database/pinecone
import { Pinecone } from '@pinecone-database/pinecone';
// Reads PINECONE_API_KEY from the environment
const pc = new Pinecone();
const { indexes = [] } = await pc.indexes.list();
for (const indexModel of indexes) {
console.log(indexModel.name, indexModel.host, indexModel.status.state);
}
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/pinecone-io/go-pinecone/v7/pinecone"
)
func main() {
ctx := context.Background()
pc, err := pinecone.NewClient(pinecone.NewClientParams{
ApiKey: os.Getenv("PINECONE_API_KEY"),
})
if err != nil {
log.Fatalf("Failed to create Client: %v", err)
}
idxs, err := pc.ListIndexes(ctx)
if err != nil {
log.Fatalf("Failed to list indexes: %v", err)
}
for _, idx := range idxs {
fmt.Println(idx.Name, idx.Host, idx.Status.State)
}
}
# Requires Terraform provider v5.0.0 or later
data "pinecone_indexes" "all" {}
output "indexes" {
value = {
for index in coalesce(data.pinecone_indexes.all.indexes, []) : index.name => {
host = index.host
state = index.status.state
}
}
}
PINECONE_API_KEY="YOUR_API_KEY"
curl "https://api.pinecone.io/indexes" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-07"
{
"indexes": [
{
"deletion_protection": "disabled",
"deployment": {
"cloud": "aws",
"deployment_type": "managed",
"region": "us-east-1"
},
"host": "movie-recommendations-c01b5b5.svc.us-east1-gcp.pinecone.io",
"name": "movie-recommendations",
"read_capacity": {
"mode": "OnDemand",
"status": {
"state": "Ready"
}
},
"schema": {
"fields": {
"your_vector": {
"dimension": 1536,
"metric": "cosine",
"type": "dense_vector"
}
}
},
"status": {
"ready": true,
"state": "Ready"
}
}
]
}Returns all indexes in the project, including their current status and configuration. Each item in the response has the same shape as the response from Describe an index.
# pip install --upgrade pinecone
import os
from pinecone import Pinecone
pc = Pinecone(api_key=os.environ["PINECONE_API_KEY"])
for index_model in pc.indexes.list():
print(index_model.name, index_model.host, index_model.status.state)
// npm install @pinecone-database/pinecone
import { Pinecone } from '@pinecone-database/pinecone';
// Reads PINECONE_API_KEY from the environment
const pc = new Pinecone();
const { indexes = [] } = await pc.indexes.list();
for (const indexModel of indexes) {
console.log(indexModel.name, indexModel.host, indexModel.status.state);
}
package main
import (
"context"
"fmt"
"log"
"os"
"github.com/pinecone-io/go-pinecone/v7/pinecone"
)
func main() {
ctx := context.Background()
pc, err := pinecone.NewClient(pinecone.NewClientParams{
ApiKey: os.Getenv("PINECONE_API_KEY"),
})
if err != nil {
log.Fatalf("Failed to create Client: %v", err)
}
idxs, err := pc.ListIndexes(ctx)
if err != nil {
log.Fatalf("Failed to list indexes: %v", err)
}
for _, idx := range idxs {
fmt.Println(idx.Name, idx.Host, idx.Status.State)
}
}
# Requires Terraform provider v5.0.0 or later
data "pinecone_indexes" "all" {}
output "indexes" {
value = {
for index in coalesce(data.pinecone_indexes.all.indexes, []) : index.name => {
host = index.host
state = index.status.state
}
}
}
PINECONE_API_KEY="YOUR_API_KEY"
curl "https://api.pinecone.io/indexes" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-07"
Authorizations
An API Key is required to call Pinecone APIs. Get yours from the console.
Was this page helpful?