# 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.
