Authentication
PIPBIT.IO uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard.
Include your API key in requests using the Authorization header with the Bearer scheme, or pass it as a URL parameter.
Replace your_api_key with your actual API key.
Security
Private API Keys
Use private keys for server-side applications. Never expose them publicly. You can restrict keys to specific IP addresses for additional security.
Public API Keys
Use public keys for client-side applications. They require trusted domain configuration and are rate limited to 10 requests per day per user.
Testing
Use these test emails to validate your integration without consuming credits:
| Result | |
|---|---|
deliverable@test.pipbit.io |
Returns deliverable |
undeliverable@test.pipbit.io |
Returns undeliverable |
risky@test.pipbit.io |
Returns risky |
Verify Email
Verify a single email address and get detailed deliverability information.
Parameters
| Parameter | Type | Description |
|---|---|---|
email
REQUIRED
|
string | The email address to verify |
api_key
REQUIRED
|
string | Your API key (if not using header) |
Response
| Field | Type | Description |
|---|---|---|
email | string | The verified email address |
state | string | valid, invalid, risky, or unknown |
score | integer | Deliverability score (0-100) |
deliverability | string | deliverable, undeliverable, or risky |
disposable | boolean | Is disposable email domain |
role | boolean | Is role-based address |
free | boolean | Is free email provider |
Batch Verification
Submit multiple emails for batch verification. Results are processed asynchronously.
Request Body
| Parameter | Type | Description |
|---|---|---|
emails
REQUIRED
|
array | Array of email addresses (max 50,000) |
callback_url |
string | Webhook URL for completion notification |
Account
Retrieve your account information including credit balance and usage statistics.
Rate Limits
API requests are rate limited based on your subscription plan:
| Plan | Requests/Min | Requests/Day |
|---|---|---|
| Free | 10 | 100 |
| Starter | 60 | 10,000 |
| Professional | 120 | 50,000 |
| Enterprise | Custom | Unlimited |
Status Codes
| Code | Description |
|---|---|
| 200 | Success |
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid API key |
| 402 | Payment Required - Insufficient credits |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Server Error |
# Verify single email
curl "https://api.pipbit.io/v1/verify?email=test@example.com" \-H "Authorization: Bearer your_api_key"
# Batch verification
curl -X POST "https://api.pipbit.io/v1/batch" \-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{"emails": ["a@example.com"]}'
// Verify email
const response = await fetch('https://api.pipbit.io/v1/verify?email=test@example.com',
{ headers: { 'Authorization': 'Bearer your_api_key' }}
);
response = requests.get(
'https://api.pipbit.io/v1/verify',
params={'email': 'test@example.com'},
headers={'Authorization': 'Bearer your_api_key'}
)
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.pipbit.io/v1/verify?email=test@example.com',
CURLOPT_HTTPHEADER => ['Authorization: Bearer your_api_key']
]);
Replace your_api_key with your API key.