v3

latestOpenAPI 3.0.3raw.githubusercontent.com2026-04-279152.1 KB
Points

Get points by IDs

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

post/collections/{collection_name}/points

Path parameters

collection_namestring required
Example:my_collection

The name of the collection to retrieve points from.

Request body

with_payloadboolean

Whether to include payload data in the response.

with_vectorsboolean

Whether to include vector data in the response.

Example request

{
  "ids": [
    1,
    2,
    3
  ],
  "with_payload": true,
  "with_vectors": true
}

Response

Points retrieved

timenumber double

Time spent to process this request, in seconds.

statusstring

Operation status. Returns ok on success.

Example response

{
  "time": 0.000159851,
  "status": "ok",
  "result": [
    {
      "payload": {
        "category": "electronics",
        "price": 299.99
      }
    }
  ]
}