Retrieves points in batches based on the target and/or positive and negative example pairs.

Define read consistency guarantees for the operation

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

Discover batch points

Query points

Discover points

AnyVariants

Condition

ContextExamplePair

DatetimeRange

Use context and a target to find the most similar points, constrained by the context.

DiscoverRequest

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

Look only for points which satisfies this conditions

Offset of the first result to return. May be used to paginate results. Note: large offset values may cause performance issues.

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

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

Define which vector to use for recommendation, if not specified - try to use default vector

The location used to lookup vectors. If not specified - use current collection. Note: the other collection should have the same vector size as the current collection

DiscoverRequestFilter

DiscoverRequestLookupFrom

DiscoverRequestParams

DiscoverRequestShardKey

DiscoverRequestTarget

DiscoverRequestUsing

DiscoverRequestWithPayload

DiscoverRequestWithVector

Document

Text of the document This field will be used as input for the embedding model

Name of the model used to generate the vector List of available models depends on a provider

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

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.

LookupLocationShardKey

Match

MatchAny

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

MatchExcept

MatchText

MatchValue

MinShould

Select points with payload for a specified nested field

Nested

NestedCondition

OrderValue

Payload

PayloadField

PayloadSelector

PayloadSelectorExclude

Exclude this fields from returning payload

PayloadSelectorInclude

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.

Range

RangeInterface

ReadConsistency

ReadConsistencyType

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/discover/batch' \
3	--header 'api-key: <api-key-value>' \
4	--header 'Content-Type: application/json' \
5	--data-raw '{
6	"searches": [
7	{
8	"target": [
9	0.2,
10	0.1,
11	0.9,
12	0.7
13	],
14	"context": [
15	{
16	"positive": "7f6652c4-89bd-40e0-ab1d-510f7fcddd2b",
17	"negative": "2c2c9f86-0171-4bd2-9ab0-b4754682cddd"
18	}
19	],
20	"limit": 1
21	},
22	{
23	"target": [
24	0.5,
25	0.3,
26	0.2,
27	0.3
28	],
29	"context": [
30	{
31	"positive": 342,
32	"negative": 213
33	}
34	],
35	"limit": 1
36	}
37	]
38	}'

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

Discover batch points

Path parameters

Query parameters

Request

Response