Scroll points | Qdrant | API Reference

curl  -X POST \
  'http://localhost:6333/collections/collection_name/points/scroll' \
  --header 'api-key: <api-key-value>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "with_payload": [
    "city",
    "color"
  ],
  "filter": {
    "must": [
      {
        "key": "color",
        "match": {
          "value": "red"
        }
      }
    ]
  },
  "limit": 2,
  "with_vector": false
}'

{
  "usage": {
    "hardware": {
      "cpu": 1,
      "payload_io_read": 1,
      "payload_io_write": 1,
      "payload_index_io_read": 1,
      "payload_index_io_write": 1,
      "vector_io_read": 1,
      "vector_io_write": 1
    },
    "inference": {
      "models": {}
    }
  },
  "time": 0.002,
  "status": "ok",
  "result": {
    "points": [
      {
        "id": 40,
        "payload": {
          "city": "London",
          "color": "green"
        },
        "vector": [
          0.875,
          0.140625,
          0.897599995136261
        ],
        "shard_key": "region_1"
      },
      {
        "id": 41,
        "payload": {
          "city": "Paris",
          "color": "red"
        },
        "vector": [
          0.75,
          0.640625,
          0.8945000171661377
        ],
        "shard_key": "region_1"
      }
    ],
    "next_page_offset": 42
  }
}

Returns all points in a page-by-page manner. By default, all resulting points are sorted by {id}. To query the next page specify the last {id} in the offset field. Additionally, you can specify filters and sorting options.

curl  -X POST \
  'http://localhost:6333/collections/collection_name/points/scroll' \
  --header 'api-key: <api-key-value>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "with_payload": [
    "city",
    "color"
  ],
  "filter": {
    "must": [
      {
        "key": "color",
        "match": {
          "value": "red"
        }
      }
    ]
  },
  "limit": 2,
  "with_vector": false
}'

{
  "usage": {
    "hardware": {
      "cpu": 1,
      "payload_io_read": 1,
      "payload_io_write": 1,
      "payload_index_io_read": 1,
      "payload_index_io_write": 1,
      "vector_io_read": 1,
      "vector_io_write": 1
    },
    "inference": {
      "models": {}
    }
  },
  "time": 0.002,
  "status": "ok",
  "result": {
    "points": [
      {
        "id": 40,
        "payload": {
          "city": "London",
          "color": "green"
        },
        "vector": [
          0.875,
          0.140625,
          0.897599995136261
        ],
        "shard_key": "region_1"
      },
      {
        "id": 41,
        "payload": {
          "city": "Paris",
          "color": "red"
        },
        "vector": [
          0.75,
          0.640625,
          0.8945000171661377
        ],
        "shard_key": "region_1"
      }
    ],
    "next_page_offset": 42
  }
}

Authentication

api-keystring

API Key authentication via header

Path parameters

collection_namestringRequired

Name of the collection to retrieve from

Query parameters

consistencyinteger or enumOptional

Define read consistency guarantees for the operation

timeoutintegerOptional>=1

If set, overrides global timeout for this request. Unit is seconds.

Request

Pagination and filter parameters

shard_keystring or uint64 or list of strings or uint64s or object or anyOptional

Specify in which shards to look for the points, if not specified - look in all shards

offsetuint64 or string or anyOptional

Start ID to read points from.

limitinteger or nullOptional>=1

Page size. Default: 10

filterobject or anyOptional

Look only for points which satisfies this conditions. If not provided - all points.

with_payloadboolean or list of strings or object or anyOptional

Select which payload to return with the response. Default is true.

with_vectorboolean or list of stringsOptional

Options for specifying which vector to include

order_bystring or object or anyOptional

Order the records by a payload field.

Response

successful operation

usageobject or any

timedouble

Time spent to process this request

statusstring

resultobject

Result of the points read request

$	curl -X POST \
>	'http://localhost:6333/collections/collection_name/points/scroll' \
>	--header 'api-key: <api-key-value>' \
>	--header 'Content-Type: application/json' \
>	--data-raw '{
>	"with_payload": [
>	"city",
>	"color"
>	],
>	"filter": {
>	"must": [
>	{
>	"key": "color",
>	"match": {
>	"value": "red"
>	}
>	}
>	]
>	},
>	"limit": 2,
>	"with_vector": false
>	}'

1	{
2	"usage": {
3	"hardware": {
4	"cpu": 1,
5	"payload_io_read": 1,
6	"payload_io_write": 1,
7	"payload_index_io_read": 1,
8	"payload_index_io_write": 1,
9	"vector_io_read": 1,
10	"vector_io_write": 1
11	},
12	"inference": {
13	"models": {}
14	}
15	},
16	"time": 0.002,
17	"status": "ok",
18	"result": {
19	"points": [
20	{
21	"id": 40,
22	"payload": {
23	"city": "London",
24	"color": "green"
25	},
26	"vector": [
27	0.875,
28	0.140625,
29	0.897599995136261
30	],
31	"shard_key": "region_1"
32	},
33	{
34	"id": 41,
35	"payload": {
36	"city": "Paris",
37	"color": "red"
38	},
39	"vector": [
40	0.75,
41	0.640625,
42	0.8945000171661377
43	],
44	"shard_key": "region_1"
45	}
46	],
47	"next_page_offset": 42
48	}
49	}