action neutrinoapi_email_verify {
  label: "Email Verify"
  description: "SMTP based email address verification"
  provider: neutrinoapi
  method: GET
  path: "/email-verify"
  encoding: json
  input: {
    type: "object"
    properties: {
      email: {
        type: "string"
      }
      "fix-typos": {
        type: "boolean"
      }
    }
    required: ["email"]
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["domain", "domain-error", "email", "is-catch-all", "is-deferred", "is-disposable", "is-freemail", "is-personal", "provider", "smtp-response", "smtp-status", "syntax-error", "typos-fixed", "valid", "verified"]
    properties: {
      domain: {
        type: "string"
        description: "The email domain"
      }
      "domain-error": {
        type: "boolean"
        description: "True if this address has a domain error (e.g. no valid mail server records)"
      }
      email: {
        type: "string"
        description: "The email address. If you have used the fix-typos option then this will be the fixed address"
      }
      "is-catch-all": {
        type: "boolean"
        description: "True if this email domain has a catch-all policy (it will accept mail for any username)"
      }
      "is-deferred": {
        type: "boolean"
        description: "True if the mail server responded with a temporary failure (either a 4xx response code or unresponsive server). You can retry this address later, we recommend waiting at least 15 minutes before retrying"
      }
      "is-disposable": {
        type: "boolean"
        description: "True if this address is a disposable, temporary or darknet related email address"
      }
      "is-freemail": {
        type: "boolean"
        description: "True if this address is a free-mail address"
      }
      "is-personal": {
        type: "boolean"
        description: "True if this address is for a person. False if this is a role based address, e.g. admin@, help@, office@, etc."
      }
      provider: {
        type: "string"
        description: "The email service provider domain"
      }
      "smtp-response": {
        type: "string"
        description: "The raw SMTP response message received during verification"
      }
      "smtp-status": {
        type: "string"
        description: "The SMTP verification status for the address: <br> <ul> <li>ok - SMTP verification was successful, this is a real address that can receive mail</li> <li>invalid - this is not a valid email address (has either a domain or syntax error)</li> <li>absent - this address is not registered with the email service provider</li> <li>unresponsive - the mail server(s) for this address timed-out or refused to open an SMTP connection</li> <li>unknown - sorry, we could not reliably determine the real status of this address (this address may or may not exist)</li> </ul>"
      }
      "syntax-error": {
        type: "boolean"
        description: "True if this address has a syntax error"
      }
      "typos-fixed": {
        type: "boolean"
        description: "True if typos have been fixed"
      }
      valid: {
        type: "boolean"
        description: "Is this a valid email address (syntax and domain is valid)"
      }
      verified: {
        type: "boolean"
        description: "True if this address has passed SMTP verification. Check the smtp-status and smtp-response fields for specific verification details"
      }
    }
  }
}