Find emails for a list

Server URLloading...

POST

/api/v1/email-finder/jobs

Send

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.

Authorization (Header)string

Header

Idempotency-Keystring

X-Request-Idstring

Body

rowsarray, JSON[ { "first_name": "Jane", "last_name": "Doe", "domain": "acme.com", "ref": "crm-1042" }, { "name": "Sam Lee", "domain": "globex.io" } ]

People to look up. Send rows or csv.

csvstring

CSV text with a header row, instead of rows. Columns like first_name, last_name, name, domain, company_domain, website and id are recognised.

namestring

A label for the list.

max_creditsnumber

Spending limit for this list in credits.

A background job for up to 10,000 people. Send rows (first_name and last_name, or name, plus domain and an optional ref of your own) or csv text with a header row. Same prices per row as a single lookup; maximum_charge is the most the list can cost. Set max_credits to cap the spend: the job pauses at that limit. It also pauses when credits run out, at the daily limit (it goes on after midnight UTC) or when most lookups find nothing. Repeated rows and rows without a usable name or domain are skipped for free.

Header Parameters

Response Body

curl -X POST "https://app.argorant.com/api/v1/email-finder/jobs" \  -H "Idempotency-Key: 6f1c2e7a-run-42" \  -H "Content-Type: application/json" \  -d '{    "rows": [      {        "first_name": "Jane",        "last_name": "Doe",        "domain": "acme.com",        "ref": "crm-1042"      },      {        "name": "Sam Lee",        "domain": "globex.io"      }    ],    "name": "Q4 accounts",    "max_credits": 100  }'

{  "ok": true,  "job": {    "job_id": "fj_5d6e7f8a9b0c1d2e3f4a5b6c",    "name": "Q4 accounts",    "status": "queued",    "paused_reason": null,    "total": 2,    "processed": 0,    "credits_charged": 0,    "max_credits": 100,    "maximum_charge": 2,    "results_url": "/api/v1/email-finder/jobs/fj_5d6e7f8a9b0c1d2e3f4a5b6c/results"  }}