Get an export batch
An export above 50,000 rows runs as a batch of files. This shows each file with its status and download path.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Reads only | argorant:create_exports |
Authorization
BearerAuth AuthorizationBearer <token>
Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.
In: header
Path Parameters
batch_id*integer
The batch id from create.
Header Parameters
X-Request-Id?string
Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.
Match
^[A-Za-z0-9._-]{8,64}$Response Body
application/json
application/json
application/json
application/json
application/json
Shell
curl -X GET "https://app.argorant.com/api/v1/export-batches/912"JSON
{ "batch_id": 912, "status": "processing", "requested_rows": 120000, "chunk_size": 50000, "total_chunks": 3, "chunks": [ { "job_id": 84301, "name": "CFOs Germany", "status": "done", "progress_pct": 100, "limit": 500, "total_rows": 500, "verified_rows": 482, "no_email_rows": 0, "grade_counts": { "valid": 470, "catch_all": 12 }, "downloadable": true, "include_phones": false, "exclude_previously_exported": true, "credits_charged": 482, "emails_billed": 482, "phones_billed": 0, "error_message": null, "billing_note": "482 contacts with a working email were charged 1 credit each.", "batch_id": null, "chunk_index": null, "filters": { "title": "CFO", "country": "Germany" }, "created_at": "2026-10-07T09:14:02+00:00", "started_at": "2026-10-07T09:14:03+00:00", "completed_at": "2026-10-07T09:16:40+00:00", "status_url": "/api/v1/exports/84213", "download_url": "/api/v1/exports/84213/download" } ]}