---
title: "List Bulk Items"
method: GET
path: "/bulks/{bulk_id}/items"
tags: ["Bulks"]
---

# List Bulk Items

`GET /bulks/{bulk_id}/items`

Returns a paginated list of items inside a bulk. Use this endpoint to inspect which identifiers succeeded or failed, and why. Filter by `status` or `status_code` to drill into failures.

## Path parameters

- `bulk_id` string, uuid, required

## Query parameters

- `page` integer
- `items_per_page` integer
- `status` 'success' | 'error'
- `status_code` 'success' | 'invalid_identifier' | 'invalid_rfc' | 'invalid_ip_address' | 'invalid_email' | 'missing_ip_address' | 'consent_not_found' | 'consent_expired' | 'consent_mismatch' | 'verification_in_progress' | 'rate_limit_exceeded' | 'extraction_error' | 'internal_error' — Item status code. See the Bulks guide for meaning and recommended client action.
- `identifier` string

## Response `200`

Paginated list of bulk items.

- BulkItemsPage
  - `items` BulkItem[], required
    - `identifier` string, required — The input identifier (CURP or 12-char RFC).
    - `verification_id` string, uuid, nullable — Resulting verification ID. `null` if the item errored before a verification was created, or for consent bulks.
    - `consent_id` string, uuid, nullable — Consent ID associated with the verification. `null` if no consent was created or linked to the verification.
    - `status` 'success' | 'error', required — Final status of this item.
    - `status_code` 'success' | 'invalid_identifier' | 'invalid_rfc' | 'invalid_ip_address' | 'invalid_email' | 'missing_ip_address' | 'consent_not_found' | 'consent_expired' | 'consent_mismatch' | 'verification_in_progress' | 'rate_limit_exceeded' | 'extraction_error' | 'internal_error', required — Item status code. See the Bulks guide for meaning and recommended client action.
    - `created_at` string, date-time, required — When this item was processed.
  - `pagination` Pagination, required
    - `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.
- `404` — Bulk not found.

---

[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)