---
title: "Search vectors."
method: POST
path: "/api/v1/tenants/{tenant_id}/vectors/search"
tags: ["Vectors"]
---

# Search vectors.

`POST /api/v1/tenants/{tenant_id}/vectors/search`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/api/v1/tenants/{tenant_id}/vectors/search`
- Auth: HTTP bearer

Runs a nearest-neighbour vector search and returns scored matches.

## Path parameters

- `tenant_id` string, required

## Request body

- VectorSearchRequest: A nearest-neighbour vector search.
  - `collection` string, required
  - `query_vector` number[], required: The query embedding.
  - `top_k` integer, nullable: Number of nearest neighbours to return.
  - `filter` object, nullable: Optional metadata filter.

## Response `200`

Search results with scores

## Other responses

- `401`: Missing or invalid API key
- `500`: Internal error

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)