Piloterr

Email Verify

GET
/v2/email/verify

Verify whether an email address is valid and deliverable, returning a clear status to prevent bounces and maintain list hygiene.

Credit cost: 1 credit per call

Autorización

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parámetros de consulta

query*string

The email address you want to verify.

Example:

name@example.com

Note: Provide the full email address including the domain. The API checks deliverability and returns valid, invalid, or unknown as the status.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Cuerpo de la respuesta

Successful response

application/json
  1. response
email?string
status?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/email/verify?query=string'
Example Response
{  "email": "name@example.com",  "status": "invalid"}