Start a list check
Checks the addresses of a quote. The list comes from the quote, so it cannot change after the user said yes. approved_maximum_charge is the most the user agreed to pay; the check never costs more. Half a credit per fresh check, rounded up per run. Starting the same quote again returns the same run.
| Cost | What it does | Key scopes |
|---|---|---|
| 0.5 credit per address that needs a fresh check, never more than approved_maximum_charge | Spends credits | argorant:verify_emails |
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
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/verifications" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "quote_id": "4b1d2c3e4f5a6b7c8d9e0f1a2b3c4d5e", "approved_maximum_charge": 1 }'{ "run_id": "9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b", "total": 3, "done": 1, "complete": false, "summary": { "valid": 1, "pending": 2 }, "credits_charged": 1, "checks_charged": 2, "results_url": "https://app.argorant.com/verify?run=9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b"}