---
title: "Fetch records"
method: GET
path: "/vectors/fetch"
tags: ["Vector Operations"]
---

# Fetch records

`GET /vectors/fetch`

Look up and return records by ID from a single namespace. The returned records include the vector data and/or metadata.
For on-demand indexes, since vector values are retrieved from object storage, fetch operations may have increased latency. If you only need metadata or IDs, consider using the query operation with `includeValues` set to `false` instead.
For guidance and examples, see [Fetch data](https://docs.pinecone.io/guides/manage-data/fetch-data).

## Query parameters

- `ids` string[], required
- `namespace` string

## Headers

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

## Response `200`

A successful response.

- DbDataFetchResponse — The response for the `fetch` operation.
  - `vectors` object
  - `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)
