Docs
Docs
Validate single or multiple email addresses with detailed results including status, sub-status, and additional metadata.
Validate a single email address using ZeroBounce API. Returns detailed validation results including status, sub-status, and additional metadata.
| Name | Type | Required | Description |
|---|---|---|---|
| string | Required | The email address to validate | |
| ipAddress | string | Optional | Optional IP address of the user (helps improve accuracy) |
Validate a single email address
Validate the email address "test@example.com"Validate with IP address for better accuracy
Validate "test@example.com" from IP address "192.168.1.1"Check if an email is valid before sending
Check if "user@domain.com" is a valid email addressValidate multiple email addresses in batch. More efficient for validating multiple emails at once.
| Name | Type | Required | Description |
|---|---|---|---|
| emails | array | Required | Array of email addresses to validate |
| ipAddress | string | Optional | Optional IP address of the user (applied to all emails) |
Validate multiple emails at once
Check if these emails are valid: ["user1@example.com", "user2@example.com", "user3@example.com"]Validate a list of emails from a file
I have a list of emails in data.csv. Can you read them and validate each one?Set up ZeroBounce MCP in your preferred AI client and start using these tools today.
Process large volumes of email addresses efficiently via CSV file uploads. Perfect for validating entire email lists.
Send a CSV file for bulk email validationⓘ. Returns a file ID for tracking.
| Name | Type | Required | Description |
|---|---|---|---|
| file | file/CSV | Required | CSV file containing email addresses to validate |
Upload a CSV file containing email addresses
Bulk validate the emails in this CSV file: [paste CSV content]Get the status of a bulk validation file upload.
| Name | Type | Required | Description |
|---|---|---|---|
| fileId | string | Required | The file ID returned from bulk_validate_send_file |
Check if your bulk validation file is ready
Check the status of my bulk validation file abc123Get the results of a completed bulk validation file.
| Name | Type | Required | Description |
|---|---|---|---|
| fileId | string | Required | The file ID returned from bulk_validate_send_file |
Download the results of a completed validation
Get the results for my completed bulk validation file abc123Delete a bulk validation file from your account.
| Name | Type | Required | Description |
|---|---|---|---|
| fileId | string | Required | The file ID returned from bulk_validate_send_file |
Remove a file from your account
Delete the bulk validation file with ID abc123Set up ZeroBounce MCP in your preferred AI client and start using these tools today.
Evaluate email quality and deliverability using AI. Score emails based on multiple factors to improve campaign performance.
Send a CSV file for bulk AI email scoringⓘ. Returns a file ID for tracking.
| Name | Type | Required | Description |
|---|---|---|---|
| file | file/CSV | Required | CSV file containing email addresses to score |
Upload emails for AI scoring
Use AI to score the quality and deliverability of these email addresses and return the results as a CSV: [paste CSV content]Get the status of a bulk AI scoring file upload.
| Name | Type | Required | Description |
|---|---|---|---|
| fileId | string | Required | The file ID returned from bulk_ai_scoring_send_file |
Check if AI scoring is complete
Check the status of my AI scoring file xyz789Get the results of a completed bulk AI scoring file.
| Name | Type | Required | Description |
|---|---|---|---|
| fileId | string | Required | The file ID returned from bulk_ai_scoring_send_file |
Download AI scoring results
Get the AI scoring results for file xyz789Delete a bulk AI scoring file from your account.
| Name | Type | Required | Description |
|---|---|---|---|
| fileId | string | Required | The file ID returned from bulk_ai_scoring_send_file |
Remove a scoring file from your account
Delete the AI scoring file with ID xyz789Set up ZeroBounce MCP in your preferred AI client and start using these tools today.
Find email addresses based on name, domain, and company information. Perfect for lead generation and prospecting.
Find an email address based on domain, name, and/or company.
| Name | Type | Required | Description |
|---|---|---|---|
| domain | string | Optional | Domain to search for email addresses |
| firstName | string | Optional | First name of the person |
| middleName | string | Optional | Middle name of the person |
| lastName | string | Optional | Last name of the person |
| company | string | Optional | Company name |
Find email using name and domain
Find the email for John Doe at example.comFind email using name and company
Find the email for John Doe at Example Corp (example.com)Find email with first, middle, and last name
Find the email for John Michael Doe at example.comSet up ZeroBounce MCP in your preferred AI client and start using these tools today.
Search for all email addresses in a domain. Discover contacts and build comprehensive email lists for organizations.
Search for email addresses in a domain.
| Name | Type | Required | Description |
|---|---|---|---|
| domain | string | Required | Domain to search |
| firstName | string | Optional | Optional first name filter |
| lastName | string | Optional | Optional last name filter |
| company | string | Optional | Optional company name filter |
Find all emails in a domain
Search for all email addresses at example.comFind emails for specific people
Find emails for people named John at example.comFind emails matching company
Search for emails at example.com for Example CorpSet up ZeroBounce MCP in your preferred AI client and start using these tools today.
Check if an email address has been recently active. Verify email engagement and activity before sending campaigns.
Get activity data for an email address to see if it has been active recently.
| Name | Type | Required | Description |
|---|---|---|---|
| string | Required | Email address to get activity data for |
Check if an email has been active
Check if test@example.com has been active recentlyVerify email engagement before sending
Get activity data for user@domain.comCheck activity for multiple emails
Check activity for these emails: ["email1@example.com", "email2@example.com"]Set up ZeroBounce MCP in your preferred AI client and start using these tools today.
Monitor your ZeroBounce account credits and API usage. Track your consumption and manage your account effectively.
Get the number of credits remaining in your ZeroBounce account.
See how many credits you have left
How many credits do I have left in my ZeroBounce account?Get your current credit balance
Show me my ZeroBounce account creditsGet API usage statistics for a date range. Shows validation counts by status and sub-status.
| Name | Type | Required | Description |
|---|---|---|---|
| startDate | string (YYYY-MM-DD) | Optional | Start date for usage statistics |
| endDate | string (YYYY-MM-DD) | Optional | End date for usage statistics |
View API usage for a specific month
Show me my ZeroBounce API usage for January 2024View usage for a specific date range
Get my API usage from 2024-01-01 to 2024-01-31See recent API usage
Show me my ZeroBounce account status and usage for this monthSet up ZeroBounce MCP in your preferred AI client and start using these tools today.