Skip to main content
GET
/
vectors
/
list
# 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="INDEX_HOST"

curl -X GET "https://$INDEX_HOST/vectors/list?namespace=example-namespace&prefix=doc1#&limit=3" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-Api-Version: 2025-10"

{
  "vectors": [
    { "id": "doc1#chunk1" },
    { "id": "doc1#chunk2" },
    { "id": "doc1#chunk3" }
  ],
  "pagination": {
    "next": "c2Vjb25kY2FsbA=="
  },
  "namespace": "example-namespace",
  "usage": {
    "readUnits": 1
  }
}

# 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="INDEX_HOST"

curl -X GET "https://$INDEX_HOST/vectors/list?namespace=example-namespace&prefix=doc1#&limit=3" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-Api-Version: 2025-10"

{
  "vectors": [
    { "id": "doc1#chunk1" },
    { "id": "doc1#chunk2" },
    { "id": "doc1#chunk3" }
  ],
  "pagination": {
    "next": "c2Vjb25kY2FsbA=="
  },
  "namespace": "example-namespace",
  "usage": {
    "readUnits": 1
  }
}

Authorizations

​
Api-Key
string
header
required

An API Key is required to call Pinecone APIs. Get yours from the console.

Headers

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

Required date-based version header

Query Parameters

​
prefix
string

The vector IDs to fetch. Does not accept values containing spaces.

​
limit
integer
default:100

Max number of IDs to return per page.

​
paginationToken
string

Pagination token to continue a previous listing operation.

​
namespace
string

The namespace to list vectors from. If not provided, the default namespace is used.

Response

A successful response.

The response for the list operation.

​
vectors
A list of ids · object[]
Example:
[
  { "id": "document1#abb" },
  { "id": "document1#abc" }
]
​
pagination
object
​
namespace
string

The namespace of the vectors.

Example:

"example-namespace"

​
usage
object
⌘I