EmailKind Classify API
The Classify API from EmailKind — 2 operation(s) for classify.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/emailkind-com:emailkind-com-classify-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: EmailKind Classify API
version: 1.0.0
description: Classify email addresses and domains by provider and type (business, personal, disposable, education, role) using passive DNS analysis. No email is ever sent.
contact:
name: EmailKind
url: https://emailkind.com/contact
license:
name: Proprietary
servers:
- url: https://emailkind.com/v1
description: Production
security:
- bearerAuth: []
tags:
- name: Classify
paths:
/classify:
get:
operationId: classify
summary: Classify a single email address or domain
description: Provide either an email or a domain. Returns the detected provider, classification flags, MX records and a confidence score.
parameters:
- name: email
in: query
required: false
schema:
type: string
format: email
description: Email address to classify. Either email or domain is required.
example: ceo@stripe.com
- name: domain
in: query
required: false
schema:
type: string
description: Domain to classify. Either email or domain is required.
example: stripe.com
- name: enrich
in: query
required: false
schema:
type: boolean
default: false
description: Include company-name resolution for the domain.
responses:
'200':
description: Classification result
content:
application/json:
schema:
$ref: '#/components/schemas/SuccessResponse'
'400':
description: Missing or invalid parameter
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: Rate limit or monthly quota exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Classify
/classify/batch:
post:
operationId: classifyBatch
summary: Classify up to 100 emails and/or domains in one call
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BatchRequest'
responses:
'200':
description: Batch results
content:
application/json:
schema:
$ref: '#/components/schemas/BatchResponse'
'400':
description: Invalid body or too many items
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Classify
components:
schemas:
ErrorResponse:
type: object
properties:
success:
type: boolean
example: false
request_id:
type: string
error:
type: object
properties:
code:
type: string
example: MISSING_PARAMETER
message:
type: string
BatchResponse:
type: object
properties:
success:
type: boolean
request_id:
type: string
count:
type: integer
results:
type: array
items:
$ref: '#/components/schemas/BatchResultItem'
Classification:
type: object
properties:
is_business:
type: boolean
is_free:
type: boolean
is_disposable:
type: boolean
is_education:
type: boolean
is_custom_domain:
type: boolean
is_role:
type: boolean
Company:
type: object
nullable: true
properties:
name:
type: string
domain:
type: string
SuccessResponse:
type: object
properties:
success:
type: boolean
example: true
request_id:
type: string
example: req_a1b2c3d4e5f6
email:
type: string
normalized_email:
type: string
domain:
type: string
example: stripe.com
provider:
$ref: '#/components/schemas/Provider'
classification:
$ref: '#/components/schemas/Classification'
company:
$ref: '#/components/schemas/Company'
mx:
type: array
items:
type: string
confidence:
type: number
format: float
example: 0.98
cached:
type: boolean
Provider:
type: object
properties:
id:
type: string
example: google_workspace
name:
type: string
example: Google Workspace
type:
type: string
enum:
- business
- personal
- disposable
- education
- hosting
- self-hosted
- unknown
BatchRequest:
type: object
description: At least one of emails or domains must be non-empty. Combined total capped at 100 items.
properties:
emails:
type: array
items:
type: string
format: email
domains:
type: array
items:
type: string
enrich:
type: boolean
default: false
BatchResultItem:
type: object
properties:
input:
type: string
success:
type: boolean
domain:
type: string
normalized_email:
type: string
provider:
$ref: '#/components/schemas/Provider'
classification:
$ref: '#/components/schemas/Classification'
company:
$ref: '#/components/schemas/Company'
confidence:
type: number
format: float
error:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'API key issued in the dashboard, sent as ''Authorization: Bearer sk_live_...''.'