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
GET /v1/account. Stores available credits. The owner email is not stored.
Output
account full type
account full type
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
POST /v1/batch with a JSON body. Stores the batch id and message.
Output
batch full type
batch full type
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
GET /v1/batch. Results per address for batches up to 1,000, a download link above that.
Output
batch full type
batch full type
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
GET /v1/verify. Stores the address, state, score, and reason. HTTP 249 returns pending.
Output
verification full type
verification full type