REST API Documentation

API Documentation

Integrate email verification into your application in minutes. Simple REST API with comprehensive examples.

Get API Key Quick Start

<1s Response

Average latency

99.9% Uptime

SLA guarantee

REST API

Any language

10 req/sec

Rate limit

Quick Start

Get your API key

Get API Key

Make your first request

Use the API endpoint with your key to verify any email address.

Single Email Verification

1# Single email verification
2curl -X GET "https://api.mailveri.com/v1/[email protected]" \
3  -H "Authorization: Bearer YOUR_API_KEY"
4 
5# Response
6{
7  "email": "[email protected]",
8  "status": "VALID",
9  "is_disposable": false,
10  "is_role_account": false,
11  "is_catch_all": false,
12  "domain": "example.com",
13  "mx_records": ["mx1.example.com"]
14}

Handle the response

Parse the JSON response and use the verification status in your application.

Code Examples

Python

verify.py

1import requests
2 
3API_KEY = "YOUR_API_KEY"
4email = "[email protected]"
5 
6response = requests.get(
7    "https://api.mailveri.com/v1/verify",
8    params={"email": email},
9    headers={"Authorization": f"Bearer {API_KEY}"}
10)
11 
12result = response.json()
13print(f"Status: {result['status']}")
14print(f"Is Disposable: {result['is_disposable']}")

JavaScript

verify.js

1const API_KEY = 'YOUR_API_KEY';
2const email = '[email protected]';
3 
4const response = await fetch(
5  `https://api.mailveri.com/v1/verify?email=${email}`,
6  {
7    headers: {
8      'Authorization': `Bearer ${API_KEY}`
9    }
10  }
11);
12 
13const result = await response.json();
14console.log('Status:', result.status);
15console.log('Is Disposable:', result.is_disposable);

PHP

verify.php

1<?php
2$apiKey = 'YOUR_API_KEY';
3$email = '[email protected]';
4 
5$ch = curl_init();
6curl_setopt($ch, CURLOPT_URL, 
7    "https://api.mailveri.com/v1/verify?email=" . urlencode($email));
8curl_setopt($ch, CURLOPT_HTTPHEADER, [
9    "Authorization: Bearer " . $apiKey
10]);
11curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
12 
13$response = curl_exec($ch);
14$result = json_decode($response, true);
15 
16echo "Status: " . $result['status'];
17?>

API Endpoints

GET/v1/verify

Verify a single email address

Parameters

email(string)required– Email address to verify

POST/v1/verify/batch

Verify multiple emails in a batch (up to 100)

Parameters

emails(array)required– Array of email addresses

POST/v1/lists

Upload a file for bulk verification

Parameters

file(file)required– CSV, Excel, or TXT file

column(integer)– Column index for emails (default: auto-detect)

GET/v1/lists/{id}

Get status and results of a verification job

Parameters

id(string)required– Job ID from upload

GET/v1/credits

Get current credit balance

Response Status Codes

VALIDEmail exists and can receive messages

INVALIDMailbox does not exist or is disabled

DISPOSABLETemporary email address

ROLE_ACCOUNTRole-based email (info@, support@)

CATCH_ALLDomain accepts all emails

FULL_INBOXMailbox is full

UNKNOWNCould not verify

Authentication

All API requests require authentication using a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from the MailVeri dashboard.

Ready to integrate?

Get 1,000 free API credits when you sign up. Start building in minutes.

Get API Key

Quick Start

Get your API key

Get API Key

Make your first request

Use the API endpoint with your key to verify any email address.

Single Email Verification

1# Single email verification
2curl -X GET "https://api.mailveri.com/v1/[email protected]" \
3  -H "Authorization: Bearer YOUR_API_KEY"
4 
5# Response
6{
7  "email": "[email protected]",
8  "status": "VALID",
9  "is_disposable": false,
10  "is_role_account": false,
11  "is_catch_all": false,
12  "domain": "example.com",
13  "mx_records": ["mx1.example.com"]
14}

Handle the response

Parse the JSON response and use the verification status in your application.

Code Examples

Python

verify.py

1import requests
2 
3API_KEY = "YOUR_API_KEY"
4email = "[email protected]"
5 
6response = requests.get(
7    "https://api.mailveri.com/v1/verify",
8    params={"email": email},
9    headers={"Authorization": f"Bearer {API_KEY}"}
10)
11 
12result = response.json()
13print(f"Status: {result['status']}")
14print(f"Is Disposable: {result['is_disposable']}")

JavaScript

verify.js

1const API_KEY = 'YOUR_API_KEY';
2const email = '[email protected]';
3 
4const response = await fetch(
5  `https://api.mailveri.com/v1/verify?email=${email}`,
6  {
7    headers: {
8      'Authorization': `Bearer ${API_KEY}`
9    }
10  }
11);
12 
13const result = await response.json();
14console.log('Status:', result.status);
15console.log('Is Disposable:', result.is_disposable);

PHP

verify.php

1<?php
2$apiKey = 'YOUR_API_KEY';
3$email = '[email protected]';
4 
5$ch = curl_init();
6curl_setopt($ch, CURLOPT_URL, 
7    "https://api.mailveri.com/v1/verify?email=" . urlencode($email));
8curl_setopt($ch, CURLOPT_HTTPHEADER, [
9    "Authorization: Bearer " . $apiKey
10]);
11curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
12 
13$response = curl_exec($ch);
14$result = json_decode($response, true);
15 
16echo "Status: " . $result['status'];
17?>

API Endpoints

GET/v1/verify

Verify a single email address

Parameters

email(string)required– Email address to verify

POST/v1/verify/batch

Verify multiple emails in a batch (up to 100)

Parameters

emails(array)required– Array of email addresses

POST/v1/lists

Upload a file for bulk verification

Parameters

file(file)required– CSV, Excel, or TXT file

column(integer)– Column index for emails (default: auto-detect)

GET/v1/lists/{id}

Get status and results of a verification job

Parameters

id(string)required– Job ID from upload

GET/v1/credits

Get current credit balance