List Batches
Retrieve a paginated list of batch enrichment submissions. Filter by product, status, or client to track processing activity across your account.
https://api.leadmagic.io/v1/batchTry this endpointOpen the API playground
Endpoint Details
Retrieve a paginated list of batch submissions. Filter by product, status, or client_id to narrow results. Batches are returned newest first.
GET /v1/batch: list batches across all products.GET /v1/:product/batch: list batches for a specific product.
- Pricing
- Rate Limits
| Metric | Value |
|---|---|
| Cost | FREE: listing batches does not consume credits |
Quick Example
Request Parameters
Filter by product (e.g. email_finder). Applies automatically in per-product URL.
Filter by status: accepted, processing, completed, failed.
Filter by client ID for internal cost-tracking.
Number of batches per page. Defaults to 50. Maximum 200.
Number of batches to skip. Defaults to 0.
Response
Array of batch summary objects.
Number of batches returned per page.
Offset applied to this page.
Status Codes
200
401
429
Best Practices
Filter by status to reduce payload
Filter by status to reduce payload
Pass status=completed or status=processing to narrow results and keep responses small.
Page with limit and offset
Page with limit and offset
Use limit and offset together. Increment offset by limit each page. The response does not include a total count.
Track credits per client
Track credits per client
Use client_id filtering to see all batches for a specific client. Combine with Client Metrics for aggregated credit tracking.