How can I use the API?
You can use the VerifySwift REST API to automate your tasks.
You can generate and manage your API keys here.
Base URL:
https://verifyswift.com/api/[action]
Replace [action] with the endpoint name such as verify or user_info.
Authentication:
All requests require an API key. The API key must be sent using the api_key parameter in the url
verifyswift.com/api/[action]?api_key=[your api key]
Available Endpoints:
- •
GET /api/user_info– Retrieve authenticated user information - •
GET /api/verify– Verify a single email address
Verify Email Endpoint:
Verify a single email address and return detailed verification results.
GET https://verifyswift.com/api/verify
Query Parameters:
email(required) – Email address to verify
Sample cURL Request:
curl -X GET "https://verifyswift.com/api/[email protected]&api_key=[your api key]"
Sample Success Response:
{ "success": true, "data": { "email": "[email protected]", "is_reachable": "safe", "is_disposable": false, "is_role_account": false, "accepts_mail": true, "can_connect_smtp": true, "has_full_inbox": false, "is_catch_all": false, "is_deliverable": true, "is_disabled": false, "domain": "example.com", "is_valid_syntax": true, "username": "john.doe" } }
Status Field Meaning:
is_reachable: safe, invalid, or unknownis_disposable: Disposable email provider detectedis_role_account: Role-based address (info@, sales@, etc.)is_deliverable: SMTP server confirms deliveryis_catch_all: Domain accepts all emails
Error Responses:
{ "success": false, "error": "Out of credits" }
{ "success": false, "error": "Invalid API" }
User Info Endpoint:
GET https://verifyswift.com/api/user_info
curl -X GET "https://verifyswift.com/api/user_info?api_key=[your api key]"
Returns account details excluding sensitive information such as API keys and email address.