ArgorantDocs

Find a work email

posthttps://app.argorant.com/api/v1/email-finder/find
POST
/api/v1/email-finder/find

First name.

Last name.

Full name instead of first_name and last_name; titles are ignored.

The company domain. A website URL or an email at the company also works. Personal mail domains are refused.

A person's name and company domain in, their work email out. 1 credit when the address is found and confirmed (valid). 1 credit when the domain accepts every address (catch_all); the most likely address comes back with confirmed: false. 0.25 credits when nothing is found. Free when the input is invalid, the domain has no email (no_mail_domain) or its mail server cannot be reached right now (retry_later). For more than a handful of people, start a list job.

The first lookup that finds nothing takes 1 credit and keeps 0.75 for the next three such lookups, so each costs 0.25.

CostWhat it doesKey scopes
1 credit when found, 0.25 credits when nothing is found; bad input, domains without email and unreachable mail servers are freeSpends creditsargorant:unlock_contacts

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

Header Parameters

Idempotency-Key?string

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.

Lengthlength <= 128
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}$

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

Shell
curl -X POST "https://app.argorant.com/api/v1/email-finder/find" \  -H "Idempotency-Key: 6f1c2e7a-run-42" \  -H "Content-Type: application/json" \  -d '{    "first_name": "Jane",    "last_name": "Doe",    "domain": "acme.com"  }'

JSON
{  "ok": true,  "lookup_id": "fl_3f9c2a7b1d4e5f60718293a4",  "status": "valid",  "status_label": "Confirmed",  "found": true,  "email": "jane.doe@acme.com",  "confirmed": true,  "confidence": 95,  "first_name": "Jane",  "last_name": "Doe",  "domain": "acme.com",  "credits_charged": 1,  "balance": {    "credits": 411,    "prepaid_no_result_lookups": 0,    "unlimited": false  },  "message": "Found and confirmed jane.doe@acme.com. 1 credit charged."}