Verification

Quote a list check

Send the emails of your own list (up to 5,000 rows, 1,000 different addresses) and get the most the check can cost. Addresses checked recently are free. Nothing is charged and nothing is checked yet. Show maximum_charge to the user and start only after their yes.

CostWhat it doesKey scopes
FreeReads onlyargorant:verify_emails
post/api/v1/verifications/quote

Request

  • Base URL: https://app.argorant.com
  • URL: https://app.argorant.com/api/v1/verifications/quote
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

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.

X-Request-Idstring

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.

Request body

emailsstring[] required

The addresses to check.

Response

OK

quote_idstring

Pass to start the check. Valid for 15 minutes.

expires_atstring date-time

When the quote ends.

unique_addressesinteger

Different addresses on the list.

to_checkinteger

Addresses that need a fresh check, half a credit each.

checked_recently_freeinteger

Addresses checked recently, free.

duplicates_removedinteger

Repeated addresses left out.

invalid_rowsinteger[]

Row numbers that are not an email address.

maximum_chargeinteger

The most this check can cost, in credits.

credits_per_checknumber

Credits per fresh check (0.5).

approval_requiredboolean

Always true. Start only after the person said yes to maximum_charge.

next_stepstring

What to do next.

Changes

No recorded changes to this operation across all 1 revision of this API.