API Reference #
Bulk Operations & Files #
POST /verifApiFile #
Description: Verify a file of email addresses.
Parameters #
Name | Type | Description |
---|---|---|
secret | string | API key |
file | multipart/form-data | Email list file |
Responses #
Status | Body |
---|---|
200 OK |
|
401 Unauthorized |
|
402 Payment Required |
|
POST /bulk #
Description: Upload a bulk file for processing.
Parameters #
Name | Type | Description |
---|---|---|
secret | string | API key |
file | multipart/form-data | File to upload |
Responses #
Status | Body |
---|---|
200 OK |
|
401 Unauthorized |
|
402 Payment Required |
|
GET /file #
Description: Download a processed file.
Parameters #
Name | Type | Description |
---|---|---|
secret | string | API key |
id | string | File ID |
type | string | File type |
Responses #
Status | Body |
---|---|
200 OK |
|
401 Unauthorized |
|
404 Not Found |
|
GET /fileOld #
Description: Legacy endpoint for downloading processed files.
Parameters #
Name | Type | Description |
---|---|---|
secret | string | API key |
id | string | File ID |
type | string | File type |
Responses #
Status | Body |
---|---|
200 OK |
|
400 Bad Request |
|
401 Unauthorized |
|
404 Not Found |
|
Zapier Integration Endpoints #
GET /zapier-auth #
Description: Authenticates API keys for Zapier integration.
Parameters #
Parameter | Type | Required | Description |
---|---|---|---|
api_key | string | Yes | User’s API key |
Responses #
Status | Body |
---|---|
200 OK |
|
401 Unauthorized |
|
POST /verify-single-email-zap #
Description: Verifies a single email address via Zapier.
Parameters #
Parameter | Location | Type | Required | Description |
---|---|---|---|---|
api_key | Query | string | Yes | User’s API key |
Body | string | Yes | Email to verify |
Responses #
Status | Body |
---|---|
200 OK |
|
400 Bad Request |
|
401 Unauthorized |
|
402 Payment Required |
|
500 Server Error |
|
Verification Result Codes #
Code | Description |
---|---|
valid | Email address is valid |
invalid | Email address is invalid |
unknown | Verification status could not be determined |
catch-all | Domain accepts all emails |
disposable | Temporary/disposable email address |