GET /vectors/list

List the IDs of vectors in a single namespace of a serverless index. An optional prefix can be passed to limit the results to IDs with a common prefix.

Returns up to 100 IDs at a time by default in sorted order (bitwise "C" collation). If the limit parameter is set, list returns up to that number of IDs instead. Whenever there are additional IDs to return, the response also includes a pagination_token that you can use to get the next batch of IDs. When the response does not include a pagination_token, there are no more IDs to return.

For guidance and examples, see List record IDs.

Note: list is supported only for serverless indexes.

Servers

Request headers

Name Type Required Description
X-Pinecone-Api-Version String Yes

Required date-based version header

Default value: "2025-10"

Query parameters

Name Type Required Description
prefix String No

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

limit Integer No

Max number of IDs to return per page.

Default value: 100

namespace String No

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

paginationToken String No

Pagination token to continue a previous listing operation.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.