Email Verify
GET
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
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringThe email address you want to verify.
Example:
name@example.comNote: Provide the full email address including the domain. The API checks deliverability and returns valid, invalid, or unknown as the status.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
email?stringstatus?stringcurl -X GET 'https://api.piloterr.com/v2/email/verify?query=string'Example Response
{ "email": "name@example.com", "status": "invalid"}