Export a list
Builds a CSV of the list's people. Every email is checked when the file is built and you pay only for people whose email passes. People you exported before are left out unless you set exclude_previously_exported: false. With include_phones: true each phone number written into the file costs 10 more credits (from the Pro plan).
| Cost | What it does | Key scopes |
|---|---|---|
| 1 credit per contact whose email passes the check, plus 10 per phone number with include_phones | Spends credits | argorant:create_exports, argorant:manage_lists |
Authorization
BearerAuth 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
The list id from create or list.
Header Parameters
Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.
length <= 128Your 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.
^[A-Za-z0-9._-]{8,64}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://app.argorant.com/api/v1/lists/312/export" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "limit": 5000, "exclude_previously_exported": true, "include_phones": false }'{ "type": "job", "job_id": 84260, "status": "queued", "source_list_id": 312, "include_phones": false, "phone_price": 0, "status_url": "/api/v1/exports/84260", "download_url": "/api/v1/exports/84260/download"}