VerifyRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/mailprobe-dev/json-schema/mailprobe-dev-verify-request-schema.json",
  "title": "VerifyRequest",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/mailprobe-dev-openapi.yml#/components/schemas/VerifyRequest",
  "type": "object",
  "required": [
    "emails"
  ],
  "properties": {
    "emails": {
      "type": "array",
      "description": "Addresses to verify. Entries are lower-cased and trimmed before probing. Up to 20 addresses per call; longer lists belong in the dashboard batch screen, which runs them in the background and retries deferrals. The JSON body is capped at 50 kB, far above 20 addresses of ordinary length.",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 20
    },
    "timeout": {
      "type": "integer",
      "description": "Seconds after which the request answers, whatever is still being probed. Use it when something in front of your code gives up before 95 seconds: a gateway, a sign-up form, an automation step with a time limit. An address that has no verdict yet at that point comes back `unknown` with reason `timeout`, at no charge.",
      "minimum": 5,
      "maximum": 95,
      "default": 95
    }
  }
}