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

# Get points

`POST /collections/{collection_name}/points`

Retrieve multiple points by specified IDs

## Path parameters

- `collection_name` string, required

## Query parameters

- `consistency` union — Read consistency parameter Defines how many replicas should be queried to get the result * `N` - send N random request and return points, which present on all of them * `majority` - send N/2+1 random request and return points, which present on all of them * `quorum` - send requests to all nodes and return points which present on majority of them * `all` - send requests to all nodes and return points which present on all of them Default value is `Factor(1)`
  - integer
  - 'majority' | 'quorum' | 'all' — * `majority` - send N/2+1 random request and return points, which present on all of them * `quorum` - send requests to all nodes and return points which present on majority of nodes * `all` - send requests to all nodes and return points which present on all nodes
- `timeout` integer

## Request body

- PointRequest
  - `shard_key` union — Specify in which shards to look for the points, if not specified - look in all shards
    - union
      - union
        - string
        - integer
      - ShardKey[]
        - union
          - string
          - integer
      - ShardKeyWithFallback
        - `target` union, required
          - string
          - integer
        - `fallback` union, required
          - string
          - integer
    - unknown
  - `ids` ExtendedPointId[], required — Look for points with ids
    - union — Type, used for specifying point ID in user interface
      - integer
      - string, uuid
  - `with_payload` union — Select which payload to return with the response. Default is true.
    - union — Options for specifying which payload to include or not
      - boolean — If `true` - return all payload, If `false` - do not return payload
      - string[] — Specify which fields to return
      - union — Specifies how to treat payload selector
        - PayloadSelectorInclude
          - `include` string[], required — Only include this payload keys
        - PayloadSelectorExclude
          - `exclude` string[], required — Exclude this fields from returning payload
    - unknown
  - `with_vector` union — Options for specifying which vector to include
    - boolean — If `true` - return all vector, If `false` - do not return vector
    - string[] — Specify which vector to return

## Response `200`

successful operation

- object
  - `usage` union
    - Usage — Usage of the hardware resources, spent to process the request
      - `hardware` union
        - HardwareUsage — Usage of the hardware resources, spent to process the request
          - `cpu` integer, required
          - `payload_io_read` integer, required
          - `payload_io_write` integer, required
          - `payload_index_io_read` integer, required
          - `payload_index_io_write` integer, required
          - `vector_io_read` integer, required
          - `vector_io_write` integer, required
        - unknown
      - `inference` union
        - InferenceUsage
          - `models` object, required
        - unknown
    - unknown
  - `time` number, float — Time spent to process this request
  - `status` string
  - `result` Record[]
    - `id` union, required — Type, used for specifying point ID in user interface
      - integer
      - string, uuid
    - `payload` union — Payload - values assigned to the point
      - Payload
      - unknown
    - `vector` union — Vector of the point
      - union — Vector data stored in Point
        - number[]
        - array[]
          - number[]
        - object
      - unknown
    - `shard_key` union — Shard Key
      - union
        - string
        - integer
      - unknown
    - `order_value` union
      - union
        - integer
        - number, double
      - unknown

## Other responses

- `default` — error
- `4XX` — error

## Changes

> 18 revisions in range; 1 could not be searched.

- **2025-11-17** `d09f337ca2f3` — 3 info
  - added `#/components/schemas/ShardKeyWithFallback` to the `shard_key/anyOf[#/components/schemas/ShardKeySelector]/` request property `anyOf` list
  - added `#/components/schemas/Usage` to the `usage` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/HardwareUsage` from the `usage` response property `anyOf` list for the response status `200`
- **2025-04-15** `5d330acca4cd` — 2 breaking, 6 info
  - removed the required property `usage/anyOf[#/components/schemas/HardwareUsage]/io_read` from the response with the `200` status
  - removed the required property `usage/anyOf[#/components/schemas/HardwareUsage]/io_write` from the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_index_io_read` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_index_io_write` to the response with the `200` status
  - …4 more
- **2025-01-17** `a7900f38a79d` — 5 info
  - api tag `Points` added
  - api tag `points` removed
  - added the optional property `usage` to the response with the `200` status
  - added `#/components/schemas/VectorStructOutput` to the `result/items/vector` response property `anyOf` list for the response status `200`
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/qdrant/apis/qdrant-api/changes/collections/:collection_name/points/post.md)

---

[API](https://skmtc.dev/qdrant/apis/qdrant-api.md) · [All operations](https://skmtc.dev/qdrant/apis/qdrant-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qdrant/qdrant-api/revisions/d08b1f613f29/schema)