---
title: "Get points by IDs"
method: POST
path: "/collections/{collection_name}/points"
tags: ["Points"]
---

# Get points by IDs

`POST /collections/{collection_name}/points`

Retrieve multiple points by their IDs. Returns the matching points with their vectors and payloads based on the request parameters.

## Path parameters

- `collection_name` string, required

## Request body

- object
  - `ids` union[], required — List of point IDs to retrieve.
    - union
      - integer
      - string
  - `with_payload` boolean — Whether to include payload data in the response.
  - `with_vectors` boolean — Whether to include vector data in the response.

## Response `200`

Points retrieved

- object
  - `usage` object — Resource usage information for this request.
    - `hardware` object, nullable — Hardware resource counters for the operation, including CPU, payload I/O, payload index I/O, and vector I/O metrics.
  - `time` number, double — Time spent to process this request, in seconds.
  - `status` string — Operation status. Returns `ok` on success.
  - `result` object[] — Array of matching points.
    - `id` union — The point's unique identifier.
      - integer
      - string
    - `payload` object, nullable — JSON payload metadata associated with the point, or `null` if `with_payload` is `false`.
    - `vector` unknown[], nullable — The vector embedding for the point, or `null` if `with_vectors` is `false`.
      - unknown

## Other responses

- `4XX` — Error response

---

[API](https://skmtc.dev/actiancorp/apis/actian-vectorai-db-points-api.md) · [All operations](https://skmtc.dev/actiancorp/apis/actian-vectorai-db-points-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/actiancorp/actian-vectorai-db-points-api/revisions/a1f393eb2a41/schema)