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
}'

{
  "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
}'

{
  "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 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

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	"time": 0.002,
3	"status": "ok",
4	"result": {
5	"points": [
6	{
7	"id": 40,
8	"payload": {
9	"city": "London",
10	"color": "green"
11	},
12	"vector": [
13	0.875,
14	0.140625,
15	0.897599995136261
16	],
17	"shard_key": "region_1"
18	},
19	{
20	"id": 41,
21	"payload": {
22	"city": "Paris",
23	"color": "red"
24	},
25	"vector": [
26	0.75,
27	0.640625,
28	0.8945000171661377
29	],
30	"shard_key": "region_1"
31	}
32	],
33	"next_page_offset": 42
34	}
35	}