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 unknown
  • is_disposable: Disposable email provider detected
  • is_role_account: Role-based address (info@, sales@, etc.)
  • is_deliverable: SMTP server confirms delivery
  • is_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.