Changelog
How the API is versioned
The version is part of the URL: https://api.salchimail.com/v1.
Inside v1, changes are additive. These can happen without a version change, so write your integration to tolerate them:
- New endpoints, new optional request fields and new fields in responses.
- New values of
reason_codeand of the errorcode. Treat a value you do not know as itsverdictor its errortype. - New webhook event types.
Removing or renaming a field, changing its type or changing the meaning of a verdict would be a breaking change and would ship as a new version.
2026-11-17 · API v1.0.0
First version of the public API contract.
POST /verify: verify one address inbasicormailboxmode.POST /batches,GET /batches,GET /batches/{batch_id},GET /batches/{batch_id}/resultsandPOST /batches/{batch_id}/cancel: verify lists from JSON or CSV and download the results as JSON or CSV.GET /usageandGET /account: credits, usage, plan and limits.- Webhooks
batch.completedandcredits.low, signed with HMAC-SHA256. Idempotency-Keyon everyPOST, test mode withsk_test_keys and one error format for the whole API.