v1
latestOpenAPI 3.0.32026-07-242644125.9 KBBulks
List Bulk 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.
get/bulks/{bulk_id}/items
Path parameters
bulk_idstring uuid required
The unique identifier for the bulk job.
Query parameters
pageinteger
Page number (1-indexed).
items_per_pageinteger
Number of items per page. Max 500.
status'success' | 'error'
Filter items by status.
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.
Filter items by status code. See BulkItemStatusCode for the closed enum of values.
identifierstring
Filter items by exact identifier match.
Response
Paginated list of bulk items.