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_code and of the error code. Treat a value you do not know as its verdict or its error type.
  • 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 in basic or mailbox mode.
  • POST /batches, GET /batches, GET /batches/{batch_id}, GET /batches/{batch_id}/results and POST /batches/{batch_id}/cancel: verify lists from JSON or CSV and download the results as JSON or CSV.
  • GET /usage and GET /account: credits, usage, plan and limits.
  • Webhooks batch.completed and credits.low, signed with HMAC-SHA256.
  • Idempotency-Key on every POST, test mode with sk_test_ keys and one error format for the whole API.

View this page as Markdown