---
title: "Search for records (only available via proxy)"
method: POST
path: "/api/records/search/"
tags: ["records"]
---

# Search for records (only available via proxy)

`POST /api/records/search/`

## Request

- Base URL: `https://docs.blindinsight.io` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.blindinsight.io/api/records/search/`
- Auth: one of:
  - API key in cookie `sessionid`
  - HTTP basic
  - HTTP bearer
  - none
- TypeScript: <https://skmtc.dev/blindinsight/apis/blind-insight-rest-api/docs/api/records/search/post.ts> (a function with typed inputs; its response is checked against the schema)

[Blind Insight Proxy] Search for records by label and value. If label or value is specified, both must be present. If neither are present, this endpoint does not filter records.

## Request body

- object
  - `schema` string, required: Schema ID to search within
  - `filters` object[]: Array of label/value pairs to filter records
    - `label` string, required: Label to search for given value
    - `value` string, required: Value to search for given label
  - `limit` integer: Maximum number of records to return
  - `offset` integer: Number of records to skip

## Response `200`

- Record[]
  - `id` string, required
  - `url` string, uri, required
  - `schema` string, uri, required
  - `data` object: The data that this record represents.

## Other responses

- `422`

---

[API](https://skmtc.dev/blindinsight/apis/blind-insight-rest-api.md) - [All operations](https://skmtc.dev/blindinsight/apis/blind-insight-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blindinsight/apis/blind-insight-rest-api/revisions/0ac902401cea?raw)