API Documentation

Everything you need to integrate Flarereach email validation into your application.

Base URL

https://api.flarereach.com

Authentication

All API requests require authentication via an API key. Include your API key in the request header:

X-Api-Key: akp_YOUR_API_KEY

You can generate API keys from your dashboard. Each account can have up to 10 active API keys.

Rate Limits

API calls are limited by your subscription plan. Each plan includes a monthly quota of email validations. When the quota is exceeded, the API will return an error response until the next billing cycle.

Plan	Monthly Quota
Starter	3,000 validations
Pro	10,000 validations

Endpoints

GET /api-base/v1/email/

Validate Email Address

Validates a single email address. Returns information about the email's validity, deliverability, and whether it is a disposable address.

Query Parameters

Parameter	Type	Required	Description
`email`	string	Yes	The email address to validate

Request Headers

Header	Value
`X-Api-Key`	Your API key (starts with `akp_`)

Example Request

curl -X GET "https://api.flarereach.com/api-base/v1/email/[email protected]" \
-H "X-Api-Key: akp_YOUR_API_KEY"

Example Response

200 OK

{
  "valid": true,
  "deliverable": true,
  "disposable": false,
  "domain": "example.com",
  "mx_found": true
}

Response Fields

Field	Type	Description
`valid`	boolean	Whether the email has valid syntax and structure
`deliverable`	boolean	Whether the email can receive messages
`disposable`	boolean	Whether the email belongs to a disposable/temporary provider
`domain`	string	The domain part of the email address
`mx_found`	boolean	Whether valid MX records exist for the domain

Error Responses

Status	Description
`401`	Missing or invalid API key
`400`	Invalid email parameter
`429`	Monthly quota exceeded

Need help integrating?

Create an account and start making API calls in minutes. Our API follows REST conventions and returns standard JSON responses.

Get Your API Key