canonical: https://jentic.com/apis/zerobounce.net/zerobounce

# ZeroBounce API

Email validation and verification API. The API exposes 7 endpoints secured with apiKey authentication.

## For AI agents

Programmatically get credit balance, validate single email. Covers 7 operations with apiKey authentication.

## Scope

Does not handle payments, crm, or developer tools - use for communications only.

## Capabilities

- Get credit balance
- Validate single email
- Send file for bulk validation
- Delete file
- Monitor ZeroBounce API operational status and events

## Use cases

### Communications Operations

Use the ZeroBounce API to perform communications operations programmatically. The API provides 7 endpoints covering core functionality including get credit balance, validate single email, validate batch of emails.

Example prompt: Call GET /getcredits to get credit balance

### Automated Account Management

Automate account operations by combining multiple ZeroBounce API endpoints. Agents can validate single email and then validate batch of emails in a single workflow.

Example prompt: Call GET /validate to validate single email, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call ZeroBounce API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'get credit balance', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /getcredits | Get credit balance |
| GET | /validate | Validate single email |
| POST | /validatebatch | Validate batch of emails |
| POST | /sendfile | Send file for bulk validation |
| GET | /filestatus | Get file processing status |
| GET | /getfile | Get validation results file |
| GET | /deletefile | Delete file |

## Key resources

- **Account** — Operations related to Account
- **Bulk** — Operations related to Bulk
- **Validation** — Operations related to Validation

## Why Jentic

- **Setup:** Wiring ZeroBounce by hand means passing its api_key on every query string, choosing between the API and bulkapi hosts for single versus batch validation, and polling file status yourself. Through Jentic you install once, import ZeroBounce from the API Directory, store the API key once, and your agent calls it.
- **Permission scoping:** ZeroBounce validates emails through operations rather than owned resources, so limit the agent to the operations it needs, such as single-address validation and credit balance checks. You choose the operations it may call, so bulk file submission and file deletion are not included unless you add them.
- **Credential handling:** Your ZeroBounce API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'validate an email address' or 'get credit balance', and Jentic returns the matching ZeroBounce operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Twilio** — Alternative communications API
- **Sendgrid** — Alternative communications API
- **Pusher** — Complementary communications API

## FAQ

### What authentication does the ZeroBounce API use?

The ZeroBounce API uses an API key passed in the `api_key` query. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I get credit balance with the ZeroBounce API?

Yes. Use the GET /getcredits endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the ZeroBounce API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I get credit balance through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'get credit balance'. Jentic returns the matching ZeroBounce API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the ZeroBounce API have?

The ZeroBounce API exposes 7 endpoints covering account, bulk, validation operations.

### Can I limit what my agent is allowed to do with the ZeroBounce API?

Yes. ZeroBounce works through operations rather than owned resources, so in your self-hosted Jentic One instance you decide which operations the agent may call and which credentials it may use. You can allow only the operations it needs, such as single-address validation (GET /validate) and credit balance checks (GET /getcredits), while excluding higher-impact calls like bulk file submission (POST /sendfile) and file deletion (GET /deletefile). Because those rules live with you as the operator, the agent can never invoke an operation you have not granted.