Batch progress

Counters and status. Free, and safe to poll.

GEThttps://api.easydata.win/v1/batches/{id}

free

Where a batch stands. Free, and safe to poll at meta.recommendedPollMs - a number the server sets so the cadence can be tuned without every integration being rewritten.

total, succeeded, failed and pending count TARGETS and always sum to total. results_available counts delivered ENTRIES, which is a different number for a paged operation: one search target produces one entry per page.

Request #

Field	Type	Notes
`id`required	path	The batch id.

Call it #

cURL

curl -X GET "https://api.easydata.win/v1/batches/{id}" \
  -H "X-API-Key: $API_KEY"

Response #

JSON

{
  "data": {
    "batch_id": "afec9131-080b-4b96-b3bb-726249e4bbf8",
    "operation": "profiles.enrich",
    "status": "processing",
    "total": 3,
    "succeeded": 2,
    "failed": 0,
    "pending": 1,
    "results_available": 2,
    "credits_used": 2,
    "created_at": "2026-09-01T10:00:00Z",
    "completed_at": null,
    "recommended_poll_ms": 2000
  },
  "meta": { "requestId": "req_8f2ka91x", "recommendedPollMs": 2000 }
}

Errors #

Status	Type	When
401	`invalid_api_key`	Missing, malformed, revoked or expired key. Never metered.
404	`not_found`	No such batch, or it belongs to another organization.

Every failure uses the same envelope, and none of them is metered - see Errors.