API Documentation

Email

Email Verifier

Verify email deliverability and validity via multi-provider waterfall.

POST

/api/v1/email_verifier

2 credits per call

Parameters

Field	Type	Required	Description
`email`	string	Yes	Email address to verify

Response fields

Field	Type	Description
`email`	string	The email address that was verified
`valid`	boolean	Whether the email is deliverable
`status`	string	Verification status: valid, invalid, risky, or unknown
`disposable`	boolean	Whether the address uses a disposable email provider
`mxFound`	boolean	Whether MX records were found for the domain

Code

curl -X POST https://api.richapi.ai/api/v1/email_verifier \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "john.doe@acme.com"
}'

Try it

Email Finding

Find professional email addresses using first name, last name and domain. Async via webhook.

POST

/api/v1/email_finding

Parameters

Field	Type	Required	Description
`webhook`	string	Yes	URL to receive results when the job completes
`data`	array	Yes	List of people to find emails for
`data[].refId`	string	No	Your reference ID (echoed back in webhook payload)
`data[].firstname`	string	No	First name (either firstname or lastname required)
`data[].lastname`	string	No	Last name (either firstname or lastname required)
`data[].domain`	string	Yes	Company domain (e.g. acme.com)

Response fields

Field	Type	Description
`jobId`	string	Async job ID — use with email_finding_inquiry to poll status
`status`	string	Initial job status (e.g. 'pending')

Code

curl -X POST https://api.richapi.ai/api/v1/email_finding \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data": [
    {
      "refId": "1",
      "domain": "acme.com",
      "lastname": "Doe",
      "firstname": "John"
    }
  ],
  "webhook": "https://your-app.com/webhook"
}'

Try it

Email Verification

Verify email deliverability and validity before sending. Async via webhook.

POST

/api/v1/email_verification

Parameters

Field	Type	Required	Description
`webhook`	string	Yes	URL to receive results when the job completes
`data`	array	Yes	List of emails to verify. Each item: refId, email
`data[].refId`	string	No	Your reference ID (echoed back in webhook payload)
`data[].email`	string	Yes	Email address to verify

Response fields

Field	Type	Description
`jobId`	string	Async job ID — use with email_verification_inquiry to poll status
`status`	string	Initial job status (e.g. 'pending')

Code

curl -X POST https://api.richapi.ai/api/v1/email_verification \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data": [
    {
      "email": "john@acme.com",
      "refId": "1"
    }
  ],
  "webhook": "https://your-app.com/webhook"
}'

Try it

Email Finding Status

Check the status of an async email finding job.

POST

/api/v1/email_finding_inquiry

Free

Parameters

Field	Type	Required	Description
`jobId`	string	Yes	Job ID returned by email_finding (passed as a path segment)

Response fields

Field	Type	Description
`status`	string	Job status: pending, processing, completed, or failed
`data`	array	Results when completed — each item: refId, email, status, confidence

Code

curl -X POST https://api.richapi.ai/api/v1/email_finding_inquiry \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Try it

Email Verification Status

Check the status of an async email verification job.

POST

/api/v1/email_verification_inquiry

Free

Parameters

Field	Type	Required	Description
`jobId`	string	Yes	Job ID returned by email_verification (passed as a path segment)

Response fields

Field	Type	Description
`status`	string	Job status: pending, processing, completed, or failed
`data`	array	Results when completed — each item: refId, email, valid, status, disposable, mxFound

Code

curl -X POST https://api.richapi.ai/api/v1/email_verification_inquiry \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Try it