---
title: "Search"
method: POST
path: "/v1/datasets/{dataset_id}/records/search"
---

# Search

`POST /v1/datasets/{dataset_id}/records/search`

## Request

- Base URL: `https://api.evidentia.bio` (the document declares no server; this is the origin it was published from)
- URL: `https://api.evidentia.bio/v1/datasets/{dataset_id}/records/search`
- Auth: none declared

## Path parameters

- `dataset_id` string, required

## Query parameters

- `view` 'canonical' | 'source-text/1'

## Request body

- SearchRequest
  - `query` string
  - `filters` object
  - `release_id` string, nullable
  - `limit` integer
  - `offset` integer

## Response `200`

Successful Response

- SearchResponse
  - `dataset_id` string, required
  - `release_id` string, required
  - `artifact_sha256` string, required
  - `record_schema_version` string, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `next_offset` integer, nullable, required
  - `records` object[], required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `413`: Content Too Large
- `422`: Unprocessable Content
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/evidentia/apis/evidentia-data-service.md) - [All operations](https://skmtc.dev/evidentia/apis/evidentia-data-service/llms.txt) - [OpenAPI document](https://skmtc.dev/evidentia/apis/evidentia-data-service/revisions/54a4dd310352?raw)