GET
/
vectors
/
list
# To get the unique host for an index,
# see https://docs.pinecone.io/guides/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=document1#" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-API-Version: 2025-01"
{
  "vectors": [
    {
      "id": "document1#abb"
    },
    {
      "id": "document1#abc"
    }
  ],
  "pagination": {
    "next": "Tm90aGluZyB0byBzZWUgaGVyZQo="
  },
  "namespace": "example-namespace",
  "usage": {
    "readUnits": 5
  }
}

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

Response

200 - application/json

The response for the list operation.

namespace
string

The namespace of the vectors.

pagination
object
usage
object
vectors
object[]