{
  "service": "verifiedemail",
  "displayName": "VerifiedEmail",
  "categories": [
    "Communication",
    "Marketing"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "VERIFIEDEMAIL_API_KEY",
      "description": "VerifiedEmail API key sent with the Authorization Bearer header. Create or manage API keys in the VerifiedEmail dashboard: https://app.verified.email/apikeys"
    }
  ],
  "homepageUrl": "https://verified.email",
  "actions": [
    {
      "id": "verifiedemail.get_download",
      "service": "verifiedemail",
      "name": "get_download",
      "description": "Get one VerifiedEmail download request by ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "The VerifiedEmail resource ID."
          }
        },
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "description": "Input parameters for reading one VerifiedEmail resource."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "download": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The download request ID."
              },
              "listId": {
                "type": "string",
                "description": "The related verification list ID."
              },
              "include": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "pending",
                    "malformed",
                    "ghost",
                    "unknown",
                    "nonexistent",
                    "failed",
                    "full",
                    "deliverable"
                  ],
                  "description": "An email status included in the download."
                },
                "description": "Email statuses included in the download."
              },
              "url": {
                "type": "string",
                "description": "The direct download URL returned by VerifiedEmail."
              },
              "status": {
                "type": "string",
                "enum": [
                  "new",
                  "progress",
                  "completed",
                  "failed",
                  "deleted"
                ],
                "description": "The download request status."
              },
              "dateAdded": {
                "type": "string",
                "description": "Creation time returned by VerifiedEmail."
              },
              "dateReady": {
                "type": "string",
                "description": "File ready time returned by VerifiedEmail."
              }
            },
            "additionalProperties": true,
            "description": "A VerifiedEmail download request object."
          }
        },
        "additionalProperties": false,
        "description": "VerifiedEmail single download response."
      }
    },
    {
      "id": "verifiedemail.get_entitlements",
      "service": "verifiedemail",
      "name": "get_entitlements",
      "description": "Get VerifiedEmail verification credit entitlements for the account.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "This action does not require any input."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "entitlements": {
            "type": "object",
            "properties": {
              "payAsYouGo": {
                "type": "object",
                "properties": {
                  "credits": {
                    "type": "integer",
                    "description": "Credits available in this entitlement bucket."
                  },
                  "needed": {
                    "type": "integer",
                    "description": "Credits or email count needed in this entitlement bucket."
                  }
                },
                "additionalProperties": false,
                "description": "VerifiedEmail entitlement bucket."
              },
              "autoVerify": {
                "type": "object",
                "properties": {
                  "credits": {
                    "type": "integer",
                    "description": "Credits available in this entitlement bucket."
                  },
                  "needed": {
                    "type": "integer",
                    "description": "Credits or email count needed in this entitlement bucket."
                  }
                },
                "additionalProperties": false,
                "description": "VerifiedEmail entitlement bucket."
              }
            },
            "additionalProperties": false,
            "description": "VerifiedEmail entitlement details."
          }
        },
        "additionalProperties": false,
        "description": "VerifiedEmail entitlements response."
      }
    },
    {
      "id": "verifiedemail.get_list",
      "service": "verifiedemail",
      "name": "get_list",
      "description": "Get one VerifiedEmail verification list by ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "The VerifiedEmail resource ID."
          }
        },
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "description": "Input parameters for reading one VerifiedEmail resource."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "list": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The verification list ID."
              },
              "title": {
                "type": "string",
                "description": "The verification list title."
              },
              "status": {
                "type": "string",
                "enum": [
                  "new",
                  "ready",
                  "progress",
                  "failed",
                  "partial",
                  "verified"
                ],
                "description": "The verification list status."
              },
              "isAutoRefill": {
                "type": "boolean",
                "description": "Whether auto-refill is enabled for this list."
              },
              "score": {
                "type": "integer",
                "description": "The list score."
              },
              "type": {
                "type": "string",
                "enum": [
                  "user",
                  "system",
                  "widget",
                  "zapier",
                  "integration"
                ],
                "description": "The verification list type."
              },
              "error": {
                "type": "string",
                "description": "The last list error returned by VerifiedEmail."
              },
              "autoVerify": {
                "type": "string",
                "enum": [
                  "off",
                  "weekly"
                ],
                "description": "The auto verification mode."
              },
              "integration": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": true,
                    "description": "The related integration object, if any."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "records": {
                "type": "object",
                "properties": {
                  "total": {
                    "type": "integer",
                    "description": "Total records in the list."
                  },
                  "duplicate": {
                    "type": "integer",
                    "description": "Duplicate records in the list."
                  },
                  "malformed": {
                    "type": "integer",
                    "description": "Malformed records in the list."
                  },
                  "billable": {
                    "type": "integer",
                    "description": "Billable records in the list."
                  },
                  "pending": {
                    "type": "integer",
                    "description": "Pending records in the list."
                  },
                  "unknown": {
                    "type": "integer",
                    "description": "Unknown records in the list."
                  },
                  "nonexistent": {
                    "type": "integer",
                    "description": "Nonexistent records in the list."
                  },
                  "inactive": {
                    "type": "integer",
                    "description": "Inactive records in the list."
                  },
                  "full": {
                    "type": "integer",
                    "description": "Full mailbox records in the list."
                  },
                  "ghosts": {
                    "type": "integer",
                    "description": "Ghost records in the list."
                  },
                  "failed": {
                    "type": "integer",
                    "description": "Failed records in the list."
                  },
                  "undeliverable": {
                    "type": "integer",
                    "description": "Undeliverable records in the list."
                  },
                  "deliverable": {
                    "type": "integer",
                    "description": "Deliverable records in the list."
                  },
                  "free": {
                    "type": "integer",
                    "description": "Free-provider records in the list."
                  },
                  "government": {
                    "type": "integer",
                    "description": "Government-domain records in the list."
                  },
                  "academic": {
                    "type": "integer",
                    "description": "Academic-domain records in the list."
                  },
                  "military": {
                    "type": "integer",
                    "description": "Military-domain records in the list."
                  },
                  "disposable": {
                    "type": "integer",
                    "description": "Disposable records in the list."
                  },
                  "catchall": {
                    "type": "integer",
                    "description": "Catch-all records in the list."
                  },
                  "role": {
                    "type": "integer",
                    "description": "Role-address records in the list."
                  },
                  "googleworkspace": {
                    "type": "integer",
                    "description": "Google Workspace records in the list."
                  },
                  "outlook365": {
                    "type": "integer",
                    "description": "Outlook 365 records in the list."
                  }
                },
                "additionalProperties": true,
                "description": "VerifiedEmail list statistics."
              },
              "dateAdded": {
                "type": "string",
                "description": "Creation time returned by VerifiedEmail."
              },
              "dateLastVerified": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Last verification time returned by VerifiedEmail."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true,
            "description": "A VerifiedEmail verification list."
          }
        },
        "additionalProperties": false,
        "description": "VerifiedEmail single list response."
      }
    },
    {
      "id": "verifiedemail.list_downloads",
      "service": "verifiedemail",
      "name": "list_downloads",
      "description": "List VerifiedEmail download requests with optional pagination and sorting.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "offset": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of items to offset the result set by."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10,
            "description": "Number of items to return."
          },
          "sortField": {
            "type": "string",
            "minLength": 1,
            "description": "Field name to sort the result set by."
          },
          "sortOrder": {
            "type": "string",
            "enum": [
              "asc",
              "desc"
            ],
            "description": "Sort order for the result set."
          }
        },
        "additionalProperties": false,
        "description": "Optional pagination and sorting parameters."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "downloads": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The download request ID."
                },
                "listId": {
                  "type": "string",
                  "description": "The related verification list ID."
                },
                "include": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "enum": [
                      "pending",
                      "malformed",
                      "ghost",
                      "unknown",
                      "nonexistent",
                      "failed",
                      "full",
                      "deliverable"
                    ],
                    "description": "An email status included in the download."
                  },
                  "description": "Email statuses included in the download."
                },
                "url": {
                  "type": "string",
                  "description": "The direct download URL returned by VerifiedEmail."
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "new",
                    "progress",
                    "completed",
                    "failed",
                    "deleted"
                  ],
                  "description": "The download request status."
                },
                "dateAdded": {
                  "type": "string",
                  "description": "Creation time returned by VerifiedEmail."
                },
                "dateReady": {
                  "type": "string",
                  "description": "File ready time returned by VerifiedEmail."
                }
              },
              "additionalProperties": true,
              "description": "A VerifiedEmail download request object."
            },
            "description": "Download requests returned by VerifiedEmail."
          },
          "metadata": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "description": "Total count of matching items."
              },
              "limit": {
                "type": "integer",
                "description": "Limit applied to this result set."
              },
              "offset": {
                "type": "integer",
                "description": "Offset applied to this result set."
              },
              "sortField": {
                "type": "string",
                "description": "Sort field applied to this result set."
              },
              "sortOrder": {
                "type": "string",
                "description": "Sort order applied to this result set."
              }
            },
            "additionalProperties": false,
            "description": "VerifiedEmail pagination metadata."
          }
        },
        "additionalProperties": false,
        "required": [
          "downloads"
        ],
        "description": "VerifiedEmail download request collection response."
      }
    },
    {
      "id": "verifiedemail.list_lists",
      "service": "verifiedemail",
      "name": "list_lists",
      "description": "List VerifiedEmail verification lists with optional pagination and sorting.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "offset": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of items to offset the result set by."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10,
            "description": "Number of items to return."
          },
          "sortField": {
            "type": "string",
            "minLength": 1,
            "description": "Field name to sort the result set by."
          },
          "sortOrder": {
            "type": "string",
            "enum": [
              "asc",
              "desc"
            ],
            "description": "Sort order for the result set."
          }
        },
        "additionalProperties": false,
        "description": "Optional pagination and sorting parameters."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "lists": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The verification list ID."
                },
                "title": {
                  "type": "string",
                  "description": "The verification list title."
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "new",
                    "ready",
                    "progress",
                    "failed",
                    "partial",
                    "verified"
                  ],
                  "description": "The verification list status."
                },
                "isAutoRefill": {
                  "type": "boolean",
                  "description": "Whether auto-refill is enabled for this list."
                },
                "score": {
                  "type": "integer",
                  "description": "The list score."
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "user",
                    "system",
                    "widget",
                    "zapier",
                    "integration"
                  ],
                  "description": "The verification list type."
                },
                "error": {
                  "type": "string",
                  "description": "The last list error returned by VerifiedEmail."
                },
                "autoVerify": {
                  "type": "string",
                  "enum": [
                    "off",
                    "weekly"
                  ],
                  "description": "The auto verification mode."
                },
                "integration": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": true,
                      "description": "The related integration object, if any."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "records": {
                  "type": "object",
                  "properties": {
                    "total": {
                      "type": "integer",
                      "description": "Total records in the list."
                    },
                    "duplicate": {
                      "type": "integer",
                      "description": "Duplicate records in the list."
                    },
                    "malformed": {
                      "type": "integer",
                      "description": "Malformed records in the list."
                    },
                    "billable": {
                      "type": "integer",
                      "description": "Billable records in the list."
                    },
                    "pending": {
                      "type": "integer",
                      "description": "Pending records in the list."
                    },
                    "unknown": {
                      "type": "integer",
                      "description": "Unknown records in the list."
                    },
                    "nonexistent": {
                      "type": "integer",
                      "description": "Nonexistent records in the list."
                    },
                    "inactive": {
                      "type": "integer",
                      "description": "Inactive records in the list."
                    },
                    "full": {
                      "type": "integer",
                      "description": "Full mailbox records in the list."
                    },
                    "ghosts": {
                      "type": "integer",
                      "description": "Ghost records in the list."
                    },
                    "failed": {
                      "type": "integer",
                      "description": "Failed records in the list."
                    },
                    "undeliverable": {
                      "type": "integer",
                      "description": "Undeliverable records in the list."
                    },
                    "deliverable": {
                      "type": "integer",
                      "description": "Deliverable records in the list."
                    },
                    "free": {
                      "type": "integer",
                      "description": "Free-provider records in the list."
                    },
                    "government": {
                      "type": "integer",
                      "description": "Government-domain records in the list."
                    },
                    "academic": {
                      "type": "integer",
                      "description": "Academic-domain records in the list."
                    },
                    "military": {
                      "type": "integer",
                      "description": "Military-domain records in the list."
                    },
                    "disposable": {
                      "type": "integer",
                      "description": "Disposable records in the list."
                    },
                    "catchall": {
                      "type": "integer",
                      "description": "Catch-all records in the list."
                    },
                    "role": {
                      "type": "integer",
                      "description": "Role-address records in the list."
                    },
                    "googleworkspace": {
                      "type": "integer",
                      "description": "Google Workspace records in the list."
                    },
                    "outlook365": {
                      "type": "integer",
                      "description": "Outlook 365 records in the list."
                    }
                  },
                  "additionalProperties": true,
                  "description": "VerifiedEmail list statistics."
                },
                "dateAdded": {
                  "type": "string",
                  "description": "Creation time returned by VerifiedEmail."
                },
                "dateLastVerified": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Last verification time returned by VerifiedEmail."
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "additionalProperties": true,
              "description": "A VerifiedEmail verification list."
            },
            "description": "Verification lists returned by VerifiedEmail."
          },
          "metadata": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "description": "Total count of matching items."
              },
              "limit": {
                "type": "integer",
                "description": "Limit applied to this result set."
              },
              "offset": {
                "type": "integer",
                "description": "Offset applied to this result set."
              },
              "sortField": {
                "type": "string",
                "description": "Sort field applied to this result set."
              },
              "sortOrder": {
                "type": "string",
                "description": "Sort order applied to this result set."
              }
            },
            "additionalProperties": false,
            "description": "VerifiedEmail pagination metadata."
          }
        },
        "additionalProperties": false,
        "required": [
          "lists"
        ],
        "description": "VerifiedEmail verification list collection response."
      }
    },
    {
      "id": "verifiedemail.verify_emails",
      "service": "verifiedemail",
      "name": "verify_emails",
      "description": "Verify one to ten email addresses synchronously with VerifiedEmail.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "emails": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "An email address to verify.",
              "format": "email"
            },
            "description": "One to ten email addresses to verify.",
            "minItems": 1,
            "maxItems": 10
          }
        },
        "additionalProperties": false,
        "required": [
          "emails"
        ],
        "description": "Input parameters for verifying emails."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "verifications": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string",
                  "description": "The email address returned by VerifiedEmail."
                },
                "score": {
                  "type": "integer",
                  "description": "The email score returned by VerifiedEmail."
                },
                "result": {
                  "type": "string",
                  "enum": [
                    "pending",
                    "malformed",
                    "ghost",
                    "unknown",
                    "blocked",
                    "nonexistent",
                    "inactive",
                    "failed",
                    "full",
                    "deliverable"
                  ],
                  "description": "The verification result returned by VerifiedEmail."
                },
                "role": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The role value returned by VerifiedEmail, if any."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "alias": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The email alias returned by VerifiedEmail, if any."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "canonical": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The canonical email returned by VerifiedEmail, if any."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isGhost": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether VerifiedEmail marks the email as a ghost address."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isMX": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether VerifiedEmail found MX records for the email domain."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isSubdomain": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the email belongs to a subdomain."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isCatchAll": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the email domain is catch-all."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isFree": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the email belongs to a free email provider."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isDisposable": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the email is disposable."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isGovernment": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the email belongs to a government domain."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isAcademic": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the email belongs to an academic domain."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isMilitary": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the email belongs to a military domain."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isGoogleWorkspace": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the email domain uses Google Workspace."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "isOutlook365": {
                  "anyOf": [
                    {
                      "type": "boolean",
                      "description": "Whether the email domain uses Outlook 365."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "dateAdded": {
                  "type": "string",
                  "description": "Creation time returned by VerifiedEmail."
                },
                "dateLastVerified": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Last verification time returned by VerifiedEmail."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "dateLastValid": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Last valid time returned by VerifiedEmail."
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "additionalProperties": true,
              "description": "A VerifiedEmail verification object."
            },
            "description": "Verification objects returned by VerifiedEmail."
          },
          "metadata": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "listId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "description": "The related verification list ID, if any."
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "count": {
                    "type": "integer",
                    "description": "Number of verification objects returned."
                  }
                },
                "additionalProperties": false,
                "description": "VerifiedEmail metadata for a synchronous verification response."
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "required": [
          "verifications"
        ],
        "description": "VerifiedEmail synchronous verification response."
      }
    }
  ]
}