---
title: "Query vectors in a collection"
method: POST
path: "/vectors/query"
tags: ["Vectors"]
---

# Query vectors in a collection

`POST /vectors/query`

## Request

- Base URL: `https://apipie.ai`
- URL: `https://apipie.ai/vectors/query`
- Auth: API key in header `Authorization`

Queries the vectors in the specified collection based on input criteria.

## Request body

- QueryVectorsRequest
  - `collection_name` string
  - `vector` number[]
  - `top_k` integer
  - `include_values` boolean
  - `include_metadata` boolean
  - `filter` object
  - `metatag` string

## Response `200`

Query results retrieved successfully

## Other responses

- `400`: Bad request
- `404`: Collection not found
- `500`: Internal server error

---

[API](https://skmtc.dev/apipie/apis/introduction.md) · [All operations](https://skmtc.dev/apipie/apis/introduction/llms.txt) · [OpenAPI document](https://skmtc.dev/apipie/apis/introduction/revisions/f8386be4eb3f?raw)