---
title: "List record IDs"
method: GET
path: "/vectors/list"
tags: ["Vector Operations"]
---

# List record IDs

`GET /vectors/list`

List the IDs of records 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](https://docs.pinecone.io/guides/manage-data/list-record-ids).

**Note:** `list` is supported only for serverless indexes.

## Query parameters

- `prefix` string
- `limit` integer
- `paginationToken` string
- `namespace` string

## Headers

- `X-Pinecone-Api-Version` string, required

## Response `200`

A successful response.

- DbDataListResponse — The response for the `list` operation.
  - `vectors` DbDataListItem[]
    - `id` string
  - `pagination` DbDataPagination
    - `next` string
  - `namespace` string — The namespace of the vectors.
  - `usage` DbDataUsage
    - `readUnits` integer — The number of read units consumed by this operation.

## Other responses

- `400` — Bad request. The request body included invalid request parameters.
- `4XX` — An unexpected error response.
- `5XX` — An unexpected error response.

---

[API](https://skmtc.net/pinecone/apis/pinecone-api.md) · [All operations](https://skmtc.net/pinecone/apis/pinecone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinecone/pinecone-api/revisions/35876583485d/schema)