API Overview
This API classifies the domain behind any email address into one of six categories: Business, Government, Education, Generic, Disposable, or Unknown. That single classification delivers organizational context even when nothing else is known about a person, making it a fast, inexpensive first-level signal for lead scoring, free trial qualification, CRM enrichment, sales routing, marketing segmentation, and fraud prevention.
Instant Organizational Context
Know immediately whether an email address represents a company, a public-sector agency, an academic institution, or a personal consumer mailbox, without asking the user a single additional question.
Disposable Address Detection
Identify temporary and throwaway addresses commonly used for repeated free trial signups, promotional abuse, fake registrations, bot activity, and API key farming.
Qualify Before You Enrich
Use domain type as the first stage of a larger enrichment pipeline, spending deeper enrichment and human sales effort only where there is a higher probability of commercial value.
Domain Type Classifications
Every request returns exactly one of the following six values:
| Domain Type | Example Address | What It Indicates |
|---|---|---|
| Business | john.king@nvidia.com | The person is associated with an identifiable commercial organization |
| Government | john.smith@ca.gov | Government or public-sector affiliation |
| Education | jsmith@stanford.edu | Student, faculty, researcher, or academic administrator |
| Generic | john@gmail.com | Consumer or free email provider with limited organizational context |
| Disposable | tonytiger@10minutemail.com | Temporary address, a potential signal of low intent, trial abuse, or fraud |
| Unknown | info@obscure-domain.xyz | The domain could not be confidently classified into the categories above |
Sample Results (Input = 'john.king@nvidia.com')
| Field | Example Value | Description |
|---|---|---|
DomainType |
Business | The classification of the email address domain |
Code |
Success | API response status |
Credits |
5848 | Remaining API credits |
API Details
Endpoint
https://api.interzoid.com/getemaildomaintype
Request Format
https://api.interzoid.com/getemaildomaintype?license=[licensekey]&email=[email address]
Sample Request
https://api.interzoid.com/getemaildomaintype?license=fh5hs7*****&email=john.king@nvidia.com
Sample Response
{ "DomainType": "Business", "Code": "Success", "Credits": "5848" }
cURL Example (with API key in header)
curl --header "x-api-key: fh5hs7*****" "https://api.interzoid.com/getemaildomaintype?email=john.king@nvidia.com"
Additional Examples
Here are real-world examples demonstrating how different categories of email addresses are classified:
Corporate Address Business
// email=john.king@nvidia.com { "DomainType": "Business", "Code": "Success", "Credits": "5848" } // Route to sales enrichment and score as a qualified B2B lead
Temporary Mailbox Service Disposable
// email=tonytiger@10minutemail.com { "DomainType": "Disposable", "Code": "Success", "Credits": "5846" } // Apply additional verification or restrict promotional credits
Academic Institution Education
// email=jsmith@stanford.edu { "DomainType": "Education", "Code": "Success", "Credits": "5845" } // Route to academic pricing, research programs, or student offers
Public Sector Agency Government
// email=john.smith@ca.gov { "DomainType": "Government", "Code": "Success", "Credits": "5844" } // Route to public-sector sales, procurement, and compliance messaging
Consumer Mailbox Generic
// email=johnsmith72@gmail.com { "DomainType": "Generic", "Code": "Success", "Credits": "5843" } // Send to the normal self-service flow and broader nurture messaging
Unclassified Domain Unknown
// email=info@obscure-domain.xyz { "DomainType": "Unknown", "Code": "Success", "Credits": "5842" } // Flag for manual review or additional verification steps
Turning Email Addresses into Business Context
See how a list of otherwise anonymous email addresses becomes an actionable segmentation of your database. The API returns the domain type. The actions beside each one are examples of what teams commonly do with a given classification, not something the API returns or prescribes:
| Before (Email Address) | After (Domain Type Returned, with Example Action) |
|---|---|
| john.king@nvidia.com | Business Enterprise sales routing, high lead score |
| j.smith@pfizer.com | Business B2B intent signal on a white paper download |
| jsmith@stanford.edu | Education Academic pricing and research programs |
| procurement@ca.gov | Government Public sector team, compliance messaging |
| johnsmith72@gmail.com | Generic Self-service flow and marketing nurture |
| abc@mailinator.com | Disposable Suppress, verify, or limit free credits |
| tonytiger@10minutemail.com | Disposable Likely repeat trial signup, flag as high risk |
| info@obscure-domain.xyz | Unknown Manual review or secondary verification |
Use Cases
Lead Scoring
Score corporate domains higher, consumer domains neutral, and disposable domains as negative or disqualified. Combine domain type with job title, geography, company identification, and web activity to prioritize the leads most likely to convert.
Free Trials and Product Signups
Automatically route business signups to sales enrichment, education signups to academic programs, and government signups to public-sector teams, while applying additional verification to disposable addresses. Especially valuable for free credits, freemium plans, and API keys.
CRM Enrichment
Add a Domain Type field to every contact record to drive segmentation, workflows, and reporting. A business classification can also trigger the next stage of enrichment, resolving the domain to an organization name, industry, company size, and country.
Marketing Segmentation
Build campaigns tailored to enterprise prospects, academic audiences, public-sector buyers, and consumer accounts. Particularly powerful for analyzing existing marketing databases holding millions of email addresses with little firmographic information.
Sales Routing
Send corporate domains to enterprise or commercial sales, government domains to public sector, education domains to academic teams, generic domains to nurture, and disposable domains to suppression, so human effort goes where commercial value is highest.
Trial Abuse and Fraud Detection
Detect the throwaway addresses behind repeated free-trial creation, promotional abuse, fake registrations, bot activity, spam accounts, and API key farming, then combine that signal with other risk factors to identify high-risk registrations.
Database Analytics
Profile an entire customer or prospect database by domain type, then measure which segments convert best, generate the most revenue, churn the most, and turn free-trial users into paying customers.
Data Quality and Entity Resolution
Corroborate company affiliation on existing records. A contact listed at a large employer with a matching corporate domain is stronger evidence than the same record with a consumer address, which supports validation, deduplication, and entity resolution.
Code Examples, Database Queries, and Specifications
Usage Examples
See quick and easy code examples in multiple programming languages, including Python, Node.js, Java, Typescript, and Go. Also see how to use within database queries on popular database platforms and open specifications such as OpenAPI.
See All ExamplesOpenAPI 3.1 Specification (Optional)
You do not need this to use the API. It is a machine-readable description of every parameter, classification, and response code, useful if you would rather not write the request code yourself. Import either file into Postman, Insomnia, or Swagger Editor to try the API without writing anything, or feed it to a code generator to produce a ready-made client in your language of choice.
YAML JSONAdditional Resources
Try this API Interactively
Our API interactive usage tool enables you to try this API interactively with a user interface and without writing code. The tool is available for all of our APIs.
Try it NowUse this API in a High-Performance, No-Code, Cloud Batch Mode
Our Enrich Wizard no-code batch tool enables you to quickly use this API within our parallel-processing Cloud platform, enriching text files (CSV/TSV) with a few clicks and without writing code. This is the fastest and easiest way to classify an entire list of email addresses, enabling results in minutes.
Start Now