Universally query points in batch. This endpoint covers all capabilities of search, recommend, discover, filters. But also enables hybrid and multi-stage queries.

Define read consistency guarantees for the operation

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

Query points in batch

Query point groups

Query points

AnyVariants

Condition

ContextInput

ContextPair

ContextQuery

DatetimeRange

Direction

DiscoverInput

Search space will be constrained by these pairs of vectors

DiscoverInputContext

DiscoverQuery

Type, used for specifying point ID in user interface

ExtendedPointId

All possible payload filtering conditions

FieldCondition

Check if point has field with a given value

Check if points value lies in a given range

Check if points geo location lies in a given area

Check if geo point is within a given radius

Check if geo point is within a given polygon

FieldConditionGeoBoundingBox

FieldConditionGeoPolygon

FieldConditionGeoRadius

FieldConditionMatch

FieldConditionRange

FieldConditionValuesCount

Filter

At least one of those conditions should match

At least minimum amount of given conditions should match

FilterMinShould

FilterMust

FilterMustNot

FilterShould

Fusion

FusionQuery

GeoBoundingBox

Ordered sequence of GeoPoints representing the line

GeoLineString

GeoPoint

GeoPolygon

Interior lines (if present) bound holes within the surface each GeoLineString must consist of a minimum of 4 points, and the first and last points must be the same.

GeoRadius

HasIdCondition

Select points with empty payload for a specified field

IsEmptyCondition

Select points with null payload for a specified field

IsNullCondition

Defines a location to use for looking up the vector. Specifies collection and vector field name.

LookupLocation

Optional name of the vector field within the collection. If not provided, the default vector field will be used.

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

LookupLocationShardKey

Match

MatchAny

Should have at least one value not matching the any given values

MatchExcept

MatchText

MatchValue

MinShould

NearestQuery

Select points with payload for a specified nested field

Nested

NestedCondition

OrderBy

OrderByDirection

OrderByInterface

OrderByQuery

OrderByStartFrom

OrderValue

Payload

PayloadField

PayloadSelector

PayloadSelectorExclude

Exclude this fields from returning payload

PayloadSelectorInclude

Prefetch

Sub-requests to perform first. If present, the query will be performed on the results of the prefetches.

Query to perform. If missing without prefetches, returns points ordered by their IDs.

Define which vector name to use for querying. If missing, the default vector is used.

Filter conditions - return only those points that satisfy the specified conditions.

Search params for when there is no prefetch

Return points with scores better than this threshold.

Max number of points to return. Default is 10.

The location to use for IDs lookup, if not specified - use the current collection and the 'using' vector Note: the other collection vectors should have the same vector size as the 'using' vector in the current collection

PrefetchFilter

PrefetchLookupFrom

PrefetchParams

PrefetchPrefetch

PrefetchQuery

QuantizationSearchParams

If true, quantized vectors are ignored. Default is false.

If true, use original vectors to re-score top-k results. Might require more time in case if original vectors are stored on disk. If not set, qdrant decides automatically apply rescoring or not.

Query

QueryInterface

QueryRequest

Sub-requests to perform first. If present, the query will be performed on the results of the prefetch(es).

Offset of the result. Skip this many points. Default is 0

Options for specifying which vectors to include into the response. Default is false.

Options for specifying which payload to include or not. Default is false.

QueryRequestFilter

QueryRequestLookupFrom

QueryRequestParams

QueryRequestPrefetch

QueryRequestQuery

QueryRequestShardKey

QueryRequestWithPayload

QueryRequestWithVector

QueryResponse

Range

RangeInterface

ReadConsistency

ReadConsistencyType

Sample

SampleQuery

ScoredPoint

Points vector distance to the query vector

ScoredPointOrderValue

ScoredPointPayload

ScoredPointShardKey

ScoredPointVector

SearchParams

Params relevant to HNSW index Size of the beam in a beam-search. Larger the value - more accurate the result, more time required for search.

Search without approximation. If set to true, search may run long but with exact results.

If enabled, the engine will only perform search among indexed or small segments. Using this option prevents slow searches in case of delayed index, but does not guarantee that all uploaded vectors will be included in search results

1	curl -X POST \
2	'http://localhost:6333/collections/collection_name/points/query/batch' \
3	--header 'api-key: <api-key-value>' \
4	--header 'Content-Type: application/json' \
5	--data-raw '{
6	"searches": [
7	{
8	"query": [
9	0.23,
10	0.325,
11	0.623
12	],
13	"limit": 1
14	},
15	{
16	"query": [
17	0.423,
18	0.23,
19	0.623
20	],
21	"limit": 5,
22	"using": "image-vector"
23	}
24	]
25	}'

1	{
2	"time": 0.002,
3	"status": "ok",
4	"result": [
5	{
6	"points": [
7	{
8	"id": 42,
9	"version": 3,
10	"score": 0.75,
11	"payload": {
12	"city": "London",
13	"color": "green"
14	},
15	"vector": [
16	0.875,
17	0.140625,
18	0.897599995136261
19	],
20	"shard_key": "region_1",
21	"order_value": 42
22	}
23	]
24	}
25	]
26	}

Query points in batch

Path parameters

Query parameters

Request

Response