Check up to 50 email addresses
POST/v1/check/batch
Premium only. Checks up to 50 addresses in one request, for example to clean an existing user list. Each address
counts as one check. Enterprise accounts use their bulk credits first, then the monthly quota; single /v1/check
calls never use bulk credits. If the batch does not fit, nothing is counted and the whole batch gets 429.
Addresses the check could not complete (InternalServerError rows) are not counted.
Batches are limited to the same pace as single checks on your plan: when you get RateLimitError, wait Retry-After seconds.
Need more than 100,000 checks a month, or a one-time cleanup of a large user list? Write to support@signitize.io.
Request
Responses
- 200
- 401
- 403
- 413
- 422
- 429
One row per address, in the order sent. A row is either a check result or an error for that address.
Response Headers
Checks included per month in your plan.
Checks left this month.
Unix time (seconds) when the monthly quota resets (1st of the month, 00:00 UTC).
active, past_due (Premium ended, grace period with Premium limits) or expired (back to Free limits).
Plan whose limits apply to this request.
Missing, invalid or revoked API key.
Your plan has no bulk checks. Bulk checks need Premium (or Enterprise).
Request body too large.
The request body is invalid.
Two different limits, told apart by error.type:
QuotaExceededError: the monthly quota is used up.Retry-Afteris the number of seconds until the reset (1st of the month, 00:00 UTC). Don't retry before then; upgrade instead.RateLimitError: too many requests per second (or, on public endpoints, per hour from one IP).Retry-Aftersays how many seconds to wait.
Response Headers
Seconds to wait before retrying.
Checks included per month in your plan.
Checks left this month.
Unix time (seconds) when the monthly quota resets (1st of the month, 00:00 UTC).