canonical: https://jentic.com/apis/interzoid.com/interzoid-get-email-information-api

# Interzoid Get Email Information API

The Interzoid Get Email Information API validates an email address for deliverability by checking syntax, verifying that the domain has reachable mail servers, and running additional liveness checks. The response also classifies the address against demographic categories such as generic, vulgar, education, government, or other entity types so downstream systems can suppress low-value or risky contacts. The single GET /getemailinfo endpoint authenticates with a license key passed as a query parameter and returns the validation result as JSON.

## For AI agents

Validate an email for deliverability and classify it by entity type. One GET endpoint, license-key auth.

## Scope

Does not send verification emails, scrape email addresses from web pages, or check inbox contents - use for syntax, mail-server, and entity-type checks on a single email address only.

## Capabilities

- Verify that an email address is syntactically valid and routable
- Detect that the domain's mail servers are reachable before sending
- Classify an email as generic, vulgar, education, government, or other entity type
- Flag form submissions that supply throwaway or non-deliverable addresses
- Suppress likely-bouncing addresses from a marketing send list before launch

## Use cases

### Signup form email validation

Web signup flows pass each submitted email through the Interzoid Get Email Information API and reject submissions whose domain has no reachable mail servers or whose syntax fails. This catches typos like 'gmial.com' before the user completes onboarding and reduces the welcome-email bounce rate.

Example prompt: On form submit, call /getemailinfo with email set to the submitted address and block submission if the response indicates the domain mail servers are unreachable.

### Marketing list hygiene

Before a campaign launches, marketing operations runs every address on the send list through the Interzoid Get Email Information API and removes addresses flagged as undeliverable, generic, or vulgar. This protects sender reputation by reducing bounce and complaint rates on the upcoming send.

Example prompt: Iterate the campaign recipients table, call /getemailinfo for each address, and tag rows whose response indicates an undeliverable domain so they are excluded from the next send.

### Lead-quality scoring

Inbound lead forms enrich each lead with the Interzoid email classification - distinguishing personal, generic, education, and government addresses. Lead scoring rules then weight personal-domain addresses higher than role-based ones such as info@ or support@ when prioritising sales follow-up.

Example prompt: On lead create, call /getemailinfo and add 10 points to the lead score if the classification is 'personal' and 0 points if 'generic'.

### AI agent contact validation

An AI agent processing a contact import discovers the Interzoid Get Email Information API through Jentic and validates each email inline before writing rows into the CRM. Jentic stores the Interzoid license key in the credential vault and injects it as the license query parameter at execution time, so the agent never sees the raw key.

Example prompt: Search Jentic for 'validate an email address for deliverability', load the Interzoid Get Email Information operation, and execute it for each email in the import file.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/getemailinfo` | Validate an email address and return deliverability and classification info |

## Key resources

- **Email information lookup** — Single GET operation that validates an email address for deliverability and returns demographic classification.

## Why Jentic

- **Setup:** Wiring the Interzoid Get Email Information API by hand means obtaining a license key, appending it as a license query parameter on each call to /getemailinfo, and handling the request plumbing yourself. Through Jentic you install once, import this API from the API Directory, store the license key once, and your agent calls it.
- **Permission scoping:** This API exposes a single read-only GET /getemailinfo operation that takes an email address in the query, with no resource id in the URL path, so scoping is at the operation level: you limit the agent to the syntax and mail-server check it needs. It only inspects one address and writes nothing, so there is no destructive operation to include.
- **Credential handling:** Your Interzoid license key is stored once, encrypted, by your own Jentic One instance and injected as the license parameter 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 'check a mail server', and Jentic returns the Get Email Information operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Interzoid Get Address Match Similarity Key API** — Generates similarity keys for street addresses, useful alongside email validation in full contact-record cleansing
- **Interzoid Get Full Name Match Similarity Key API** — Fuzzy-match key for full names, useful alongside email validation when deduping contacts
- **Interzoid Get Global Phone Number Information API** — Validates phone numbers, parallel to email validation for full contact-record verification

## FAQ

### What authentication does the Interzoid Get Email Information API use?

The API uses a license key passed as the license query parameter on every call to /getemailinfo. Through Jentic the license key is held in the credential vault and injected at execution time, so the agent never handles the raw key.

### Can the Interzoid Get Email Information API tell me if an email is from a free or disposable provider?

The response classifies addresses across categories including generic, vulgar, education, government, and other entity types, which helps distinguish business addresses from generic or low-value ones. For finer-grained disposable-domain detection, combine the result with your own deny-list.

### What are the rate limits for the Interzoid Get Email Information API?

The OpenAPI spec does not publish a numeric rate limit. Interzoid enforces per-license-tier quotas on the account dashboard, so check your account before running list-cleansing batches.

### How do I validate an email through Jentic?

Install the SDK with pip install jentic, search for 'validate an email address for deliverability', load the Interzoid Get Email Information operation, and execute it with the email parameter set to the address you want to check.

### Does the Interzoid Get Email Information API send a verification email to the address?

No. /getemailinfo performs syntax checks and verifies that the domain's mail servers are reachable but does not deliver a verification message. For double-opt-in flows you still need to send a confirmation email yourself.

### Can I limit what my agent is allowed to do with the Interzoid Get Email Information API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use, and this API exposes only a single read-only GET /getemailinfo call that checks an email's syntax and mail-server reachability. You can scope the agent to just that one operation, and since it reads a single address and writes nothing there is no destructive action to grant. Your Interzoid license key stays with your self-hosted instance and is injected as the license query parameter at execution time, so the agent never handles the raw key.