Support

ApexVerify verifies two types of contact data:

• Email addresses — We run syntax validation, domain/MX record checks, SMTP probing, and flag disposable, role-based, free-provider, and catch-all addresses.
• Phone numbers — We identify number type (mobile, landline, VoIP, toll-free, etc.), check live network status, detect porting, and identify the current operator via HLR lookup.

Both modes are available for batch processing (file upload) and real-time unit verification (single record via API).

Credits are consumed per verified record:

• 1 email credit per email address verified
• 1 phone credit per phone number verified

Credits are deducted at the time verification launches, not at upload. If a batch uses cached results (account cache or global cache), you receive a 50% credit refund for those cache-hit records.

Check your current balance at any time with GET /v1/account/credits.

Both caches reduce cost on repeat verifications by reusing prior results:

You can configure use_account_cache and use_global_cache on each batch via PUT /v1/batch/{uuid}. Both are enabled by default and checked in order: account cache first, then global cache. You can also set max_account_cache_backoff and max_global_cache_backoff (1–180 days) to control how far back the system looks.

Batch uploads accept a plain .TXT file with one email or phone number per line, UTF-8 encoded. No headers, no commas, no CSV — just raw values.

Example for email:

alice@example.com
bob@company.org
carol@domain.net

Example for phone (E.164 format recommended):

+447891234567
+447911123456
+441255512349

The file is uploaded via POST /v1/batch as multipart/form-data. Maximum file size and row limits are shown in the dashboard.

Parsing and parameter configuration are intentionally decoupled so you can iterate freely:

1. Update parameters at any time using PUT /v1/batch/{uuid}
2. Trigger a re-parse by calling PATCH /v1/batch/{uuid} again

You can repeat this cycle as many times as needed — there is no limit on re-parses before a batch is launched. The PATCH endpoint is idempotent and safe to call multiple times. See the API Verification Workflow guide for the full step-by-step.

Batch status is returned by GET /v1/batch/{uuid} and GET /v1/batch/{uuid}/details. Here are all possible values:

Once a batch reaches verification_done, call:

1
GET /v1/batch/{batch_uuid}/export?format=xlsx
2
GET /v1/batch/{batch_uuid}/export?format=json

• xlsx — Returns a binary Excel file, matching the layout from the web dashboard. Download with curl -o results.xlsx.
• json — Returns a JSON object keyed by email/phone, each with full result fields (valid, wrong, quality, is_disposable, etc.).

You can also include include_details=true and include_statistics=true in the query string (both default to true) to control what sections appear in the JSON export.