---
title: "Changes to Get points"
method: POST
path: "/collections/{collection_name}/points"
---

# Changes to Get points

`POST /collections/{collection_name}/points`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 20 revisions.

- **2025-11-17** `d09f337ca2f3`: 3 info
- **2025-04-15** `5d330acca4cd`: 2 breaking, 6 info
- **2025-01-17** `a7900f38a79d`: 5 info
- **2024-09-09** `99f8ca65a207`: 2 info
- **2024-08-13** `d530ad1be7de`: 3 breaking, 12 info
- **2024-07-01** `e1a916176c14`: 2 info

## Changes

- **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
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_io_read` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_io_write` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/vector_io_read` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/vector_io_write` to the response with the `200` status
- **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`
  - removed `#/components/schemas/VectorStruct` from the `result/items/vector` response property `anyOf` list for the response status `200`
- **2024-09-09** `99f8ca65a207`: 2 info
  - added `#/components/schemas/Document` to the `result/items/vector/anyOf[#/components/schemas/VectorStruct]/` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Document` to the `result/items/vector/anyOf[#/components/schemas/VectorStruct]/anyOf[subschema #3]/additionalProperties/` response property `anyOf` list for the response status `200`
- **2024-08-13** `d530ad1be7de`: 3 breaking, 12 info
  - removed `subschema #1, subschema #2` from the `ids/items/` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `shard_key/anyOf[#/components/schemas/ShardKeySelector]/anyOf[#/components/schemas/ShardKey]/` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `shard_key/anyOf[#/components/schemas/ShardKeySelector]/anyOf[subschema #2]/items/` request property `anyOf` list
  - added the new optional `query` request parameter `timeout`
  - added `subschema #1, subschema #2` to the `ids/items/` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `shard_key/anyOf[#/components/schemas/ShardKeySelector]/anyOf[#/components/schemas/ShardKey]/` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `shard_key/anyOf[#/components/schemas/ShardKeySelector]/anyOf[subschema #2]/items/` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `result/items/id` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `result/items/order_value/anyOf[#/components/schemas/OrderValue]/` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `result/items/shard_key/anyOf[#/components/schemas/ShardKey]/` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2, subschema #3` to the `result/items/vector/anyOf[#/components/schemas/VectorStruct]/` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `result/items/id` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `result/items/order_value/anyOf[#/components/schemas/OrderValue]/` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `result/items/shard_key/anyOf[#/components/schemas/ShardKey]/` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3` from the `result/items/vector/anyOf[#/components/schemas/VectorStruct]/` response property `anyOf` list for the response status `200`
- **2024-07-01** `e1a916176c14`: 2 info
  - added the optional property `result/items/order_value` to the response with the `200` status
  - added `subschema #2` to the `result/items/vector/anyOf[#/components/schemas/VectorStruct]/` response property `anyOf` list for the response status `200`

---

[Operation](https://skmtc.dev/qdrant/apis/qdrant-api/docs/collections/:collection_name/points/post.md) - [API](https://skmtc.dev/qdrant/apis/qdrant-api.md) - [Page](https://skmtc.dev/qdrant/apis/qdrant-api/changes/collections/:collection_name/points/post)