hubvibe-io.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`.",
  "properties": {
    "attribution": {
      "$ref": "#/components/schemas/Attribution"
    },
    "billing_warning": {
      "description": "Present only when the charge was recorded with a caveat.",
      "examples": [
        "settlement pending"
      ],
      "type": "string"
    },
    "price_usd": {
      "description": "What this call cost, in USD.",
      "examples": [
        0.02
      ],
      "type": "number"
    },
    "provenance": {
      "$ref": "#/components/schemas/Provenance"
    },
    "receipt_id": {
      "description": "Receipt id for this job.",
      "examples": [
        "rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "receipt_url": {
      "description": "Where to fetch the machine-readable receipt (free, no payment).",
      "examples": [
        "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "result": {
      "properties": {
        "accepts_mail": {
          "description": "The domain has somewhere to deliver mail (MX or address fallback); null when not looked up.",
          "examples": [
            true
          ],
          "type": [
            "boolean",
            "null"
          ]
        },
        "checked_at": {
          "description": "When this node read the source (UTC). Nothing here is cached.",
          "examples": [
            "2026-09-26T18:00:00Z"
          ],
          "format": "date-time",
          "type": "string"
        },
        "did_you_mean": {
          "description": "A likely intended address when the domain looks like a typo of a common provider (e.g. jane@gmial.com -> jane@gmail.com); null otherwise.",
          "examples": [
            null
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "disposable": {
          "description": "The domain is a known throwaway-mail domain.",
          "examples": [
            false
          ],
          "type": "boolean"
        },
        "disposable_list_as_of": {
          "description": "Date of the disposable-domain list used.",
          "examples": [
            "2026-09-28"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "domain": {
          "description": "The domain as given.",
          "examples": [
            "github.com"
          ],
          "type": "string"
        },
        "domain_ascii": {
          "description": "The domain in ASCII (punycode for internationalised names); null when invalid.",
          "examples": [
            "github.com"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "domain_exists": {
          "description": "The domain exists in DNS; null when not looked up.",
          "examples": [
            true
          ],
          "type": [
            "boolean",
            "null"
          ]
        },
        "email": {
          "description": "The address as given.",
          "examples": [
            "support@github.com"
          ],
          "type": "string"
        },
        "free_provider": {
          "description": "A free consumer mail provider (gmail.com, outlook.com...).",
          "examples": [
            false
          ],
          "type": "boolean"
        },
        "local_part": {
          "description": "The part before @.",
          "examples": [
            "support"
          ],
          "type": "string"
        },
        "mail_provider": {
          "description": "Who runs the domain's mail (google, microsoft, yahoo, zoho, proton, amazon_ses...); null when not recognised.",
          "examples": [
            "google"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "mailbox": {
          "description": "What the mail server said.",
          "properties": {
            "catch_all": {
              "description": "The server also accepted a random address on the domain; null when not tested.",
              "examples": [
                false
              ],
              "type": [
                "boolean",
                "null"
              ]
            },
            "checked": {
              "description": "The mail server gave a yes-or-no answer about the mailbox.",
              "examples": [
                true
              ],
              "type": "boolean"
            },
            "exists": {
              "description": "The mailbox exists; null when it could not be proved.",
              "examples": [
                true
              ],
              "type": [
                "boolean",
                "null"
              ]
            },
            "mx_host": {
              "description": "The mail server that answered.",
              "examples": [
                "aspmx.l.google.com"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "smtp_code": {
              "description": "The server's reply code to the mailbox question.",
              "examples": [
                250
              ],
              "type": [
                "integer",
                "null"
              ]
            },
            "smtp_message": {
              "description": "The server's reply text, trimmed.",
              "examples": [
                "2.1.5 OK"
              ],
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "checked",
            "exists",
            "catch_all",
            "smtp_code",
            "smtp_message",
            "mx_host"
          ],
          "type": "object"
        },
        "mx": {
          "description": "The domain's mail servers, in the order mail tries them.",
          "examples": [
            []
          ],
          "items": {
            "description": "One mail server.",
            "properties": {
              "host": {
                "description": "Mail server host.",
                "examples": [
                  "aspmx.l.google.com"
                ],
                "type": "string"
              },
              "priority": {
                "description": "MX preference (lower is tried first).",
                "examples": [
                  1
                ],
                "type": "integer"
              }
            },
            "required": [
              "host",
              "priority"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "normalized": {
          "description": "Local part with the domain lower-cased and punycoded; null when the syntax is invalid.",
          "examples": [
            "support@github.com"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "notes": {
          "description": "Caveats; empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A caveat.",
            "examples": [
              "Role address: it usually reaches a team or a shared inbox, not one person."
            ],
            "type": "string"
          },
          "type": "array"
        },
        "reason": {
          "description": "Why the verdict is what it is.",
          "enum": [
            "mailbox_exists",
            "invalid_syntax",
            "domain_not_found",
            "domain_accepts_no_mail",
            "no_mail_server",
            "mailbox_not_found",
            "disposable_domain",
            "accept_all_domain",
            "smtp_refused",
            "smtp_try_later",
            "smtp_unreachable",
            "smtp_inconclusive"
          ],
          "examples": [
            "mailbox_exists"
          ],
          "type": "string"
        },
        "role_account": {
          "description": "The local part is a role (info, sales, support...), not a person.",
          "examples": [
            true
          ],
          "type": "boolean"
        },
        "syntax_valid": {
          "description": "The address is well-formed.",
          "examples": [
            true
          ],
          "type": "boolean"
        },
        "verdict": {
          "description": "deliverable: the mail server confirmed the mailbox. undeliverable: bad syntax, no such domain, no mail server, or no such mailbox. risky: disposable domain or a server that accepts every address. unknown: the server would not say.",
          "enum": [
            "deliverable",
            "undeliverable",
            "risky",
            "unknown"
          ],
          "examples": [
            "deliverable"
          ],
          "type": "string"
        }
      },
      "required": [
        "email",
        "normalized",
        "local_part",
        "domain",
        "domain_ascii",
        "verdict",
        "reason",
        "syntax_valid",
        "domain_exists",
        "accepts_mail",
        "mx",
        "mail_provider",
        "mailbox",
        "disposable",
        "role_account",
        "free_provider",
        "did_you_mean",
        "disposable_list_as_of",
        "notes",
        "checked_at"
      ],
      "type": "object"
    },
    "status": {
      "const": "ok",
      "description": "Present only on a delivered result.",
      "type": "string"
    },
    "worker": {
      "description": "Catalog name of the worker that ran.",
      "examples": [
        "market.quote"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "worker",
    "price_usd",
    "result",
    "provenance",
    "receipt_id",
    "receipt_url"
  ],
  "title": "email.verify response",
  "type": "object"
}