---
title: "List Records"
method: GET
path: "/consent-hosting/records"
tags: ["consent-hosting"]
---

# List Records

`GET /consent-hosting/records`

## Request

- Base URL: `https://api.openproof.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openproof.io/consent-hosting/records`
- Auth: HTTP bearer

Consent decisions recorded against the current business's categories, newest first. At most `limit`
(default 1000, maximum 5000) per call; page with `offset`. `identifier` matches one person exactly,
`search` matches part of an identifier. Viewer+ role required.

## Query parameters

- `limit` integer
- `offset` integer
- `category_id` string, nullable
- `status` string, nullable
- `identifier` string, nullable
- `search` string, nullable
- `since` string, date-time, nullable
- `until` string, date-time, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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