Clay logo

LeadMagic has made more than one billion API calls with Clay and won The Unstoppable Wheel award.

Recap
LeadMagicDocs

List Batches

Retrieve a paginated list of batch enrichment submissions. Filter by product, status, or client to track processing activity across your account.

GEThttps://api.leadmagic.io/v1/batch
Try 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.
MetricValue
CostFREE: listing batches does not consume credits

Quick Example


Request Parameters

product
string
query

Filter by product (e.g. email_finder). Applies automatically in per-product URL.

status
string
query

Filter by status: accepted, processing, completed, failed.

client_id
string
query

Filter by client ID for internal cost-tracking.

limit
integer
query

Number of batches per page. Defaults to 50. Maximum 200.

offset
integer
query

Number of batches to skip. Defaults to 0.


Response

batches
array

Array of batch summary objects.

limit
integer

Number of batches returned per page.

offset
integer

Offset applied to this page.


Status Codes

200

OK: batches returned

401

Unauthorized

429

Rate Limit

Best Practices

Pass status=completed or status=processing to narrow results and keep responses small.

Use limit and offset together. Increment offset by limit each page. The response does not include a total count.

Use client_id filtering to see all batches for a specific client. Combine with Client Metrics for aggregated credit tracking.