# pip install --upgrade pinecone
import os
from pinecone import Pinecone

pc = Pinecone(api_key=os.environ["PINECONE_API_KEY"])
index = pc.Index(name="articles")

NAMESPACE = "example-namespace"

# List every document ID in the namespace.
# The SDK returns a paginator, so iterating it walks every page.
for document in index.documents.list(namespace=NAMESPACE):
    print(document._id)

# List only the IDs beginning with a prefix.
for document in index.documents.list(namespace=NAMESPACE, prefix="report-2026#"):
    print(document._id)

// npm install @pinecone-database/pinecone
import { Pinecone } from '@pinecone-database/pinecone';

// Reads PINECONE_API_KEY from the environment
const pc = new Pinecone();

const index = pc.index({
  name: 'articles',
  namespace: 'example-namespace',
});

// List every document ID in the namespace.
// Each response holds one page, so pass the pagination token to walk every page.
let paginationToken;
do {
  const page = await index.documents.list({
    paginationToken,
  });
  for (const doc of page.documents) {
    console.log(doc._id);
  }
  paginationToken = page.pagination?.next;
} while (paginationToken);

// List only the IDs beginning with a prefix.
const response = await index.documents.list({
  prefix: 'report-2026#',
});
for (const doc of response.documents) {
  console.log(doc._id);
}

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)
    }

    idx, err := pc.DescribeIndex(ctx, "articles")
    if err != nil {
        log.Fatalf("Failed to describe index: %v", err)
    }

    idxConnection, err := pc.Index(pinecone.NewIndexConnParams{
        Host:      idx.Host,
        Namespace: "example-namespace",
    })
    if err != nil {
        log.Fatalf("Failed to create IndexConnection: %v", err)
    }

    // List every document ID in the namespace.
    // Each response holds one page, so pass the pagination token to walk every page.
    var paginationToken *string
    for {
        res, err := idxConnection.ListDocuments(ctx, &pinecone.ListDocumentsRequest{
            PaginationToken: paginationToken,
        })
        if err != nil {
            log.Fatalf("Failed to list documents: %v", err)
        }
        for _, doc := range res.Documents {
            fmt.Println(doc.Id)
        }
        if res.Pagination == nil || res.Pagination.Next == "" {
            break
        }
        paginationToken = &res.Pagination.Next
    }

    // List only the IDs beginning with a prefix.
    prefix := "report-2026#"
    res, err := idxConnection.ListDocuments(ctx, &pinecone.ListDocumentsRequest{
        Prefix: &prefix,
    })
    if err != nil {
        log.Fatalf("Failed to list documents: %v", err)
    }
    for _, doc := range res.Documents {
        fmt.Println(doc.Id)
    }
}

PINECONE_API_KEY="YOUR_API_KEY"
INDEX_HOST="articles-abc123.svc.us-east-1.pinecone.io"

# EXAMPLE REQUEST 1: List the first page of document IDs
curl "https://$INDEX_HOST/namespaces/__default__/documents/list" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Pinecone-Api-Version: 2026-07" \
  -d '{
    "limit": 20
  }'

# EXAMPLE REQUEST 2: List only the IDs beginning with a prefix
curl "https://$INDEX_HOST/namespaces/__default__/documents/list" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Pinecone-Api-Version: 2026-07" \
  -d '{
    "prefix": "report-2026#"
  }'

# EXAMPLE REQUEST 3: Retrieve the next page
curl "https://$INDEX_HOST/namespaces/__default__/documents/list" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Pinecone-Api-Version: 2026-07" \
  -d '{
    "pagination_token": "Tm90aGluZyB0byBzZWUgaGVyZQo="
  }'