---
title: "Search stored Consent records"
method: GET
path: "/v1/projects/{projectId}/consent/records"
tags: ["Consent"]
---

# Search stored Consent records

`GET /v1/projects/{projectId}/consent/records`

## Request

- Base URL: `https://api.inth.com`
- URL: `https://api.inth.com/v1/projects/{projectId}/consent/records`
- Auth: HTTP bearer

Returns a fixed page of 50 records. nextPage is null on the final page. Search follows the Dashboard record search rules. Optional source fields normalize to null when unavailable. Requires consent.read and projects.read. Organization API keys cannot call this operation.

## Path parameters

- `projectId` string, required

## Query parameters

- `page` integer
- `q` string

## Response `200`

Success

- object
  - `success` unknown, required
  - `data` ProjectConsentRecords, required
    - `projectId` string, required
    - `organizationId` string, required
    - `items` object[], required
      - `action` string, nullable, required
      - `countryCode` string, nullable, required
      - `externalId` string, nullable, required
      - `givenAt` string, required
      - `id` string, required
      - `language` string, nullable, required
      - `policyId` string, nullable, required
      - `policyLabel` string, nullable, required
      - `policyRouteId` string, nullable, required
      - `policyType` string, nullable, required
      - `policyVersion` string, nullable, required
      - `policyIsActive` boolean, nullable, required
      - `purposeLabels` string[], required
      - `regionCode` string, nullable, required
      - `subjectId` string, required
      - `status` string, nullable, required
      - `isActive` boolean, nullable, required
      - `validUntil` string, nullable, required
      - `withdrawalReason` string, nullable, required
    - `page` integer, required
    - `pageSize` integer, required
    - `total` integer, required
    - `nextPage` integer, nullable, required

## Other responses

- `400`: The request payload or parameters are invalid.
- `401`: Authentication is missing, invalid, or expired.
- `403`: The credential is valid but may not perform the operation. `INSUFFICIENT_SCOPE`: the credential was never granted the capability the operation needs. `details.requiredScope` names it, and the `WWW-Authenticate` header carries `Bearer error="insufficient_scope"`. An OAuth client fixes this by requesting the scope; an organization API key cannot gain it. `FORBIDDEN`: the capability is present but the membership behind the credential lacks the role, or the resource belongs to another organization.
- `404`: The requested resource was not found.
- `409`: The request conflicts with the current resource state.
- `503`: The capability is temporarily paused by an operator. Retry later.

## Changes

- **2026-10-31** `a3f4100e14c9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/inth/apis/inth-api/changes/v1/projects/:projectId/consent/records/get.md)

---

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