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.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/verifly-email:verifly-email-list-cleaning-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
title: Verifly Email Verification List Cleaning API
version: 2.0.0
description: 'Pay-as-you-go email verification API for developers, SaaS products, signup validation, bulk email list cleaning, CSV workflows, and AI agents. Verifly verifies deliverability, cleans lists, extracts emails from text, detects risky/disposable/role addresses, checks domain DNS health, and exposes usage/credit/billing endpoints.
AGENT SELF-ONBOARDING: An autonomous agent can get a working API key with NO human, captcha, or payment by calling POST /api/v1/autonomous/register with an email + password. It returns a vf_ API key and 100 free credits (auto-confirmed). Use that key as ''Authorization: Bearer vf_...'' on every /api/v1 endpoint.
PURCHASING (agent-native): POST /api/v1/billing with method ''crypto'' and a currency (BTC/ETH/LTC/USDT/USDC) returns a raw wallet address + amount + QR so an agent can top up credits from a wallet with no browser.
RATE LIMITS: Responses include X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers; 429 responses also include Retry-After (seconds).'
contact:
name: Verifly Support
email: hello@veriflyemail.com
url: https://verifly.email/docs
termsOfService: https://verifly.email/terms
servers:
- url: https://verifly.email
description: 'Production API. All /api/v1/* paths require Authorization: Bearer vf_<key>.'
security:
- bearerAuth: []
tags:
- name: List Cleaning
description: Email list cleaning and extraction utilities (no mailbox verification).
paths:
/api/v1/files:
post:
tags:
- List Cleaning
operationId: processFile
summary: Clean (and optionally verify and save) a list
description: Clean a list supplied as emails[], raw text, or a multipart CSV file. Optionally verify=true (costs credits) and save=true to store the result as a downloadable file. Returns cleaning stats, results, and (when saved) a file reference.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/FileProcessRequest'
multipart/form-data:
schema:
type: object
properties:
file:
type: string
format: binary
verify:
type: string
save:
type: string
filename:
type: string
responses:
'200':
description: Processing result.
content:
application/json:
schema:
$ref: '#/components/schemas/FileProcessResult'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/InsufficientCredits'
'429':
$ref: '#/components/responses/RateLimited'
x-openai-isConsequential: true
/api/v1/clean:
post:
tags:
- List Cleaning
operationId: cleanEmailList
summary: Clean and filter an email list
description: Clean a list (up to 10000 emails) without mailbox verification. Removes duplicates, invalid formats, and optionally public-domain emails, role accounts, disposable domains, blacklisted domains, and pattern matches. Free (no credits).
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CleanRequest'
examples:
list:
value:
emails:
- lead@example.com
- lead@example.com
- info@example.com
- bad-email
options:
exclude_role_accounts: true
remove_disposable: true
responses:
'200':
description: Cleaned list and stats.
content:
application/json:
schema:
$ref: '#/components/schemas/CleanResult'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
x-openai-isConsequential: false
/api/v1/extract:
post:
tags:
- List Cleaning
operationId: extractEmails
summary: Extract email addresses from text
description: Extract email addresses from raw text, documents, logs, scraped snippets, or pasted notes. Does not verify deliverability. Free (no credits).
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ExtractRequest'
examples:
note:
value:
text: Contact jane@example.com and sales@example.com.
options:
deduplicate: true
lowercase: true
responses:
'200':
description: Extracted emails and stats.
content:
application/json:
schema:
$ref: '#/components/schemas/ExtractResult'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
x-openai-isConsequential: false
components:
schemas:
ExtractResult:
type: object
properties:
success:
type: boolean
count:
type: integer
emails:
type: array
items:
type: string
format: email
stats:
type: object
properties:
total_matches:
type: integer
unique_count:
type: integer
domains_found:
type: integer
top_domains:
type: array
items:
type: object
properties:
domain:
type: string
count:
type: integer
required:
- domain
- count
required:
- success
- count
- emails
- stats
ErrorResult:
type: object
properties:
success:
type: boolean
const: false
error:
type: object
properties:
code:
type: string
description: Machine-readable code, e.g. invalid_email, invalid_password, email_exists, invalid_api_key, invalid_package, invalid_currency, invalid_method, insufficient_credits, rate_limit_exceeded.
message:
type: string
suggestion:
type: string
required:
- code
- message
required:
- success
- error
SkippedEmail:
type: object
properties:
email:
type: string
reason:
type: string
description: e.g. invalid_format, duplicate, public_domain, role_account, disposable, blacklisted_domain, matched_pattern:<value>.
required:
- email
- reason
CleanOptions:
type: object
properties:
exclude_public_domains:
type: boolean
default: false
remove_public:
type: boolean
default: false
description: Alias of exclude_public_domains.
exclude_role_accounts:
type: boolean
default: false
remove_role:
type: boolean
default: false
description: Alias of exclude_role_accounts.
remove_disposable:
type: boolean
default: false
domain_blacklist:
type: array
items:
type: string
pattern_blacklist:
type: array
items:
type: string
additionalProperties: false
ExtractRequest:
type: object
required:
- text
properties:
text:
type: string
maxLength: 1000000
description: Text or CSV content to scan for emails.
options:
type: object
properties:
deduplicate:
type: boolean
default: true
lowercase:
type: boolean
default: true
additionalProperties: false
FileProcessRequest:
type: object
properties:
emails:
type: array
items:
type: string
text:
type: string
options:
type: object
properties:
deduplicate:
type: boolean
default: true
exclude_public_domains:
type: boolean
remove_public:
type: boolean
exclude_role_accounts:
type: boolean
remove_role:
type: boolean
remove_disposable:
type: boolean
domain_blacklist:
type: array
items:
type: string
pattern_blacklist:
type: array
items:
type: string
verify:
type: boolean
default: false
description: Verify each email (costs credits).
save:
type: boolean
default: false
description: Save the result as a downloadable file.
filename:
type: string
CleanRequest:
type: object
required:
- emails
properties:
emails:
type: array
minItems: 1
maxItems: 10000
items:
type: string
options:
$ref: '#/components/schemas/CleanOptions'
CleanResult:
type: object
properties:
success:
type: boolean
original_count:
type: integer
cleaned_count:
type: integer
removed_count:
type: integer
emails:
type: array
items:
type: string
format: email
removed:
type: array
items:
$ref: '#/components/schemas/SkippedEmail'
stats:
type: object
properties:
duplicates:
type: integer
invalid_format:
type: integer
public_domains:
type: integer
role_accounts:
type: integer
disposable:
type: integer
blacklisted_domains:
type: integer
matched_patterns:
type: integer
required:
- success
- original_count
- cleaned_count
- removed_count
- emails
- removed
- stats
Credits:
type: object
properties:
used:
type: integer
minimum: 0
description: Credits charged by this request.
remaining:
type: integer
minimum: 0
required:
- used
- remaining
FileProcessResult:
type: object
properties:
success:
type: boolean
stats:
type: object
properties:
original:
type: integer
duplicates_removed:
type: integer
public_domains_removed:
type: integer
role_accounts_removed:
type: integer
disposable_removed:
type: integer
blacklisted_removed:
type: integer
patterns_removed:
type: integer
final_count:
type: integer
results:
type: array
items:
type: object
additionalProperties: true
description: Omitted when more than 1000 rows.
count:
type: integer
saved:
type:
- object
- 'null'
properties:
id:
type: string
filename:
type: string
download_url:
type: string
credits:
$ref: '#/components/schemas/Credits'
required:
- success
- stats
- count
responses:
InsufficientCredits:
description: Not enough Verifly credits to complete the request.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResult'
RateLimited:
description: Too many requests. Includes Retry-After (seconds) and the X-RateLimit-* headers.
headers:
Retry-After:
schema:
type: string
description: Seconds to wait before retrying.
X-RateLimit-Limit:
schema:
type: string
X-RateLimit-Remaining:
schema:
type: string
X-RateLimit-Reset:
schema:
type: string
description: Unix epoch seconds when the limit window resets.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResult'
Unauthorized:
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResult'
BadRequest:
description: Invalid request or invalid input.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResult'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: Verifly API key
description: 'Use ''Authorization: Bearer vf_your_api_key''. Get a key with no human via POST /api/v1/autonomous/register. Never expose API keys in prompts, logs, screenshots, client-side code, or public examples.'
externalDocs:
description: Verifly API docs
url: https://verifly.email/docs
x-agent-guidance:
selfOnboarding: 'POST /api/v1/autonomous/register {email,password} -> returns a vf_ API key + 100 free credits, no human/captcha/payment. Use it as ''Authorization: Bearer vf_...''.'
buyCredits: POST /api/v1/billing {package_id, method:'crypto', currency:'USDT'} returns a raw wallet address + amount + qr_code for browserless payment; or method:'stripe' for a hosted checkout_url.
useWhen:
- email verification API
- bulk email list cleaning
- signup validation
- disposable/role/catch-all email detection
- domain MX/SPF/DMARC health check
- AI agent email hygiene
- ChatGPT email verification action
safety:
- Do not expose API keys.
- Do not invent verification results.
- Ask before processing private or large email lists.
- Verifly verifies and cleans lists; it does not send outreach emails.
mcp:
name: verifly-mcp-server
install: npx verifly-mcp-server
env: VERIFLY_API_KEY
hosted: https://verifly.email/mcp
transport: Streamable HTTP (POST)
github: https://github.com/james-sib/verifly-mcp-server
tools:
- verify_email
- verify_batch
- clean_email_list
- extract_emails
- check_domain_health
- get_credits
chatgptAction: https://verifly.email/chatgpt-action-openapi.json
cli: https://verifly.email/cli