---
title: "List Verifications"
method: GET
path: "/verifications"
tags: ["Verifications"]
---

# List Verifications

`GET /verifications`

Retrieves a paginated list of verifications. Each item in the list provides a summarized view.

## Query parameters

- `page` integer
- `items_per_page` integer
- `identifier` string
- `start_date` string, date

## Response `200`

A paginated list of summarized verifications.

- VerificationListResponse
  - `verifications` SummarizedVerification[]
    - `id` string, uuid — Unique ID for the verification.
    - `identifier` string — The identifier (CURP/RFC) associated with the verification.
    - `status` 'in_progress' | 'completed' | 'failed' — The current status of the verification.
    - `consent_id` string, uuid, nullable — The consent ID used for this verification. Can be null if no consent was associated.
    - `entities` string[] — A list of data entities (e.g., 'profile', 'invoices', 'employment', 'employment_files', 'earnings', 'business_profile') that were found for this identifier.
    - `data_available` boolean — Indicates if any data was found for this identifier during the verification.
    - `can_retry` boolean — Indicates if this verification can be retried (e.g., in case of failure with no data).
    - `created_at` string, date-time — Timestamp of when the verification was created.
    - `external_id` string, nullable — Optional external identifier provided during verification creation.
  - `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)