---
title: "List Consents"
method: GET
path: "/consents"
tags: ["Consents"]
---

# List Consents

`GET /consents`

Retrieves a paginated list of consents, optionally filtered by identifier.

## Query parameters

- `identifier` string
- `page` integer
- `items_per_page` integer

## Response `200`

A paginated list of consents.

- ConsentListResponse
  - `consents` SummarizedConsent[]
    - `id` string, uuid — Unique identifier for the consent.
    - `identifier` string — The CURP or RFC associated with the consent.
    - `ip_address` string — The IP address of the user who gave consent (IPv4 or IPv6).
    - `privacy_notice_url` string, uri — URL of the privacy notice accepted by the user.
    - `expires_at` string, date-time — Timestamp of when the consent expires.
  - `pagination` Pagination
    - `page` integer — The current page number.
    - `items_per_page` integer — The number of items returned per page.
    - `total_items` integer — The total number of items available.
    - `total_pages` integer — The total number of pages available.

## Other responses

- `401` — Unauthorized - Invalid or missing API key.

---

[API](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api.md) · [All operations](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/burodeingresos/bur-de-ingresos-api/versions/59e48cdbdd84/schema)