Skip to main content
New to Corsair? See API access, authentication, and error handling.

Account

get

account.get Get the credits left on the account. The owner email is not stored. Risk: read
Input: empty object GET /v1/account. Stores available credits. The owner email is not stored. Output

Batches

create

batches.create Start verifying a list of up to 50,000 addresses. Uses one credit per address. Poll batches.get for the results. Risk: destructive
Input POST /v1/batch with a JSON body. Stores the batch id and message. Output

get

batches.get Get a batch: progress, counts per state and reason, and each address’s result (up to 1,000 addresses) or a download link (larger batches). Risk: read
Input GET /v1/batch. Results per address for batches up to 1,000, a download link above that. Output

Verifications

verify

verifications.verify Verify one email address: state (deliverable, undeliverable, risky, unknown), reason, score, and flags such as disposable, free, role and accept-all, plus a did-you-mean suggestion. Uses one credit. If pending is true, call again within 5 minutes at no extra cost. Risk: read
Input GET /v1/verify. Stores the address, state, score, and reason. HTTP 249 returns pending. Output