Qualisend Email Verification

Verify a single email address - syntax, domain/MX, disposable + role detection, typo suggestion, and mailbox reachability. Returns a deliverability verdict (deliverable / risky / undeliverable / unknown). Consumes 1 credit.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address to verify."
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}

Verify up to 50 email addresses at once and get a deliverability verdict for each, synchronously. Consumes 1 credit per address. For larger lists (up to 1000), use verify_list.

{
  "type": "object",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 50,
      "description": "Email addresses to verify (1-50)."
    }
  },
  "required": [
    "emails"
  ],
  "additionalProperties": false
}

Verify a large list of up to 1000 email addresses. This runs ASYNCHRONOUSLY: it creates ONE bulk job, returns a job_id immediately, and the mailbox probes run in the background. Poll get_verification with the job_id for progress and a result summary (counts by verdict). Consumes 1 credit per address. For lists larger than 1000, use the Qualisend dashboard or bulk API.

{
  "type": "object",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 1000,
      "description": "Email addresses to verify (1-1000)."
    }
  },
  "required": [
    "emails"
  ],
  "additionalProperties": false
}

Return the number of verification credits available in your Qualisend workspace.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Look up the status and result of a verification you started, by job_id (returned from verify_email/verify_emails). For a single check it returns the final verdict once the mailbox probe completes; for a batch it returns progress + a result-mix summary.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job_id returned by a verify tool."
    }
  },
  "required": [
    "job_id"
  ],
  "additionalProperties": false
}

Check whether a domain is set up to send email that reaches the inbox - its mail servers plus its SPF and DMARC sender-authentication, and what's missing. A plain deliverability health check for a sending domain. No credit used. Available on the Qualisend Pro plan.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The domain to check, e.g. acme.com."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Create the exact DNS setting a domain needs so its email is trusted and harder to spoof - SPF, DMARC, BIMI, or MTA-STS. Returns the record to copy into DNS, with where to put it. No credit used. Available on the Qualisend Pro plan.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "spf",
        "dmarc",
        "bimi",
        "mta-sts"
      ],
      "description": "Which record to create."
    },
    "domain": {
      "type": "string",
      "description": "The domain the record is for."
    },
    "includes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "SPF: services allowed to send (e.g. _spf.google.com)."
    },
    "ip4": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "SPF: allowed IPv4 addresses/ranges."
    },
    "ip6": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "SPF: allowed IPv6 addresses/ranges."
    },
    "all": {
      "type": "string",
      "enum": [
        "~all",
        "-all",
        "?all"
      ],
      "description": "SPF: how strict to be with everyone else (default ~all)."
    },
    "policy": {
      "type": "string",
      "enum": [
        "none",
        "quarantine",
        "reject"
      ],
      "description": "DMARC: what to do with mail that fails checks."
    },
    "rua": {
      "type": "string",
      "description": "DMARC: email to receive summary reports."
    },
    "ruf": {
      "type": "string",
      "description": "DMARC: email to receive detailed failure reports."
    },
    "pct": {
      "type": "number",
      "description": "DMARC: percent of mail the policy applies to."
    },
    "logoUrl": {
      "type": "string",
      "description": "BIMI: https link to the brand's SVG logo."
    },
    "authorityUrl": {
      "type": "string",
      "description": "BIMI: https link to the VMC certificate."
    },
    "mode": {
      "type": "string",
      "enum": [
        "enforce",
        "testing",
        "none"
      ],
      "description": "MTA-STS: policy mode (default testing)."
    },
    "mxHosts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "MTA-STS: the domain's mail-server hostnames."
    }
  },
  "required": [
    "type",
    "domain"
  ],
  "additionalProperties": false
}

Read the hidden technical details of an email (its 'headers') to show the route it took, how long each step took, and whether it passed spam/authentication checks - handy for figuring out why a message was slow or went to spam. Paste the message source / 'Show original'. No credit used. Available on the Qualisend Pro plan.

{
  "type": "object",
  "properties": {
    "raw": {
      "type": "string",
      "description": "The raw email headers (paste the message source)."
    }
  },
  "required": [
    "raw"
  ],
  "additionalProperties": false
}

Tell whether an email address is a throwaway/temporary one, a generic team inbox (like info@ or support@), or a free consumer address (like gmail) - useful for spotting low-quality sign-ups. No credit used. Available on the Qualisend Pro plan.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address to check."
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}

Spot a likely typo in an email's domain (like gmial.com) and suggest the correct one, so you don't lose contacts to misspelled addresses. No credit used. Available on the Qualisend Pro plan.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address to check for a typo."
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}

Explain a mail-server reply/error code (like 550 or 5.1.1) in plain English, and say whether it's a temporary hiccup or a permanent failure. No credit used. Available on the Qualisend Pro plan.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "The SMTP code, e.g. 550 or 5.1.1."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

Check whether a sending domain or IP is currently on any of the major email blacklists that can push your mail to spam - a point-in-time reputation check across lists like Spamhaus, SpamCop, and Barracuda. No credit used. Requires the Qualisend Blacklist Monitoring add-on. Read the result carefully: `listed_on` are confirmed listings, while `undetermined_on` are lists that did not answer (commonly Spamhaus refusing a shared resolver). `clean` is true only when every list answered and none matched, so a non-empty `undetermined_on` means those lists are UNKNOWN - do not report them as clear or as listings.

{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "description": "A domain (acme.com) or an IPv4 address."
    }
  },
  "required": [
    "target"
  ],
  "additionalProperties": false
}