Skip to content
MailVet
Updated November 13, 2026

Errors

Errors use standard HTTP statuses and a JSON body with a stable code. An invalid email address is a result, not an error.

Error shape

HTTP/1.1 402 Payment Required

{
  "error": {
    "code": "insufficient_credits",
    "message": "This account has 0 credits. Top up at https://app.mailvet.app/billing",
    "request_id": "req_01JDA2W1"
  }
}

Error codes

HTTPcodeMeaningRetry?
400invalid_requestA required parameter is missing or malformed.No, fix the request
401unauthorizedMissing, revoked or mistyped API key.No
402insufficient_creditsThe account is out of credits.After topping up
404not_foundNo verification or bulk job with that id on this account.No
413file_too_largeThe bulk file is over 1,000,000 rows or 100 MB.Split the file
429rate_limitedOver the per-second limit.Yes, after Retry-After
500internal_errorSomething broke on our side.Yes, with backoff
503unavailableTemporarily overloaded or in maintenance.Yes, with backoff

Invalid addresses are results

GET /v1/verify?email=not-an-email returns HTTP 200 with result: "undeliverable" and reason: "invalid_syntax", free of charge. Errors are only for problems with the request itself.