---
title: "POST /api/v1/search/{indexName}/{indexVersion}"
method: POST
path: "/api/v1/search/{indexName}/{indexVersion}"
tags: ["SearchApi"]
---

# POST /api/v1/search/{indexName}/{indexVersion}

`POST /api/v1/search/{indexName}/{indexVersion}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/vektonn/apis/vektonn-api-v1/docs/api/v1/search/:indexName/:indexVersion/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `indexName` string, required
- `indexVersion` string, required

## Request body

- SearchQueryDto
  - `splitFilter` AttributeDto[], nullable
    - `key` string
    - `value` AttributeValueDto
      - `string` string, nullable
      - `guid` string, uuid, nullable
      - `bool` boolean, nullable
      - `int64` integer, nullable
      - `float64` number, double, nullable
      - `dateTime` string, date-time, nullable
  - `queryVectors` union[]
    - union
      - DenseVectorDto
        - `isSparse` boolean
        - `coordinates` number[]
      - SparseVectorDto
        - `isSparse` boolean
        - `coordinates` number[]
  - `k` integer
  - `retrieveVectors` boolean

## Response `200`

Success

- SearchResultDto[]
  - `queryVector` union
    - DenseVectorDto
      - `isSparse` boolean
      - `coordinates` number[]
    - SparseVectorDto
      - `isSparse` boolean
      - `coordinates` number[]
  - `nearestDataPoints` FoundDataPointDto[]
    - `vector` union
      - DenseVectorDto
        - `isSparse` boolean
        - `coordinates` number[]
      - SparseVectorDto
        - `isSparse` boolean
        - `coordinates` number[]
    - `attributes` AttributeDto[]
      - `key` string
      - `value` AttributeValueDto
        - `string` string, nullable
        - `guid` string, uuid, nullable
        - `bool` boolean, nullable
        - `int64` integer, nullable
        - `float64` number, double, nullable
        - `dateTime` string, date-time, nullable
    - `distance` number, double

## Changes

- **2026-07-17** `1f8e24d444f5`: 3 breaking, 9 info
  - the response property `items/nearestDataPoints/items/vector` became nullable for the status `200` (media type: text/plain)
  - the response property `items/nearestDataPoints/items/vector` became nullable for the status `200` (media type: application/json)
  - the response property `items/nearestDataPoints/items/vector` became nullable for the status `200` (media type: text/json)
  - added the new optional request property `retrieveVectors` (media type: application/json)
  - …8 more
- **2021-11-03** `435323081a30`: 1 info
  - endpoint added
- **2021-07-27** `67ba9c089ace`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/vektonn/apis/vektonn-api-v1/changes/api/v1/search/:indexName/:indexVersion/post.md)

---

[API](https://skmtc.dev/vektonn/apis/vektonn-api-v1.md) - [All operations](https://skmtc.dev/vektonn/apis/vektonn-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/vektonn/apis/vektonn-api-v1/revisions/1f8e24d444f5?raw)