Skip to content
/
Find an email

Evaboot Public API (1.1.0)

Documentation for the Evaboot Public API

Authentication

All API requests must include an Authorization header with Bearer authentication:

Authorization: Bearer xyz

Replace xyz with your API key from the Evaboot dashboard.

Download OpenAPI description
schema.json
schema.yaml
Languages
Servers
Mock server
https://docs.evaboot.com/_mock/schema
Production Server
https://api.evaboot.com

LinkedIn Extraction

Operations for extracting profiles from LinkedIn

Operations

Email Finder

Operations for finding email addresses

Operations

Find an email

Request

Find and validate email for a single person by providing their first name, last name, and company information. This endpoint runs synchronously and returns the email result immediately.

Company Information: Either company_name or company_domain must be provided to improve email finding accuracy.

Security
BearerToken
Body
required
first_namestring<= 100 charactersrequired

First name of the person

last_namestring<= 100 charactersrequired

Last name of the person

company_namestring<= 200 characters

Name of the company (required if company_domain not provided)

company_domainstring<= 200 characters

Domain of the company (required if company_name not provided)

curl -i -X POST \
  https://docs.evaboot.com/_mock/schema/v1/email-finder/single/ \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "company_name": "Example Corp",
    "company_domain": "example.com"
  }'

Responses

Email found successfully

List Email Finder jobs

Request

List all email finder jobs created by the authenticated user

Security
BearerToken
curl -i -X GET \
  https://docs.evaboot.com/_mock/schema/v1/email-finder/ \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/jsonArray [
idstringread-onlyrequired
statusstringread-onlyrequired
  • pending - Pending
  • running - Running
  • complete - Complete
  • failed - Failed
Enum"pending""running""complete""failed"
created_atstring(date-time)read-onlyrequired
updated_atstring(date-time)read-onlyrequired
progressintegerread-onlyrequired
error_messagestring or nullread-onlyrequired
prospect_countstringread-onlyrequired
job_typestringread-onlyrequired
  • email_finder - Email Finder
  • email_validation - Email Validation
Enum"email_finder""email_validation"
]
Response
application/json
[
  [
    { … },
    { … }
  ]
]

Find emails in bulk

Request

Create a new job to find email addresses for the provided prospects. Each prospect requires first_name, last_name, and company_name. The company_domain field is optional and can help improve email finding accuracy if you know the company's web domain.

Webhook Support: This endpoint supports webhooks. Include a webhook_url in your request to receive a POST notification when the job completes. The webhook will receive the same data as the GET detail endpoint.

Security
BearerToken
Body
required
job_namestring<= 255 charactersrequired
webhook_urlstring or null(uri)<= 500 characters
prospectsArray of objects(EmailFinderProspect)required
prospects[].​first_namestring<= 100 charactersrequired
prospects[].​last_namestring<= 100 charactersrequired
prospects[].​company_namestring<= 200 characters
prospects[].​company_domainstring<= 200 characters
curl -i -X POST \
  https://docs.evaboot.com/_mock/schema/v1/email-finder/ \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "job_name": "Tech Startup Email Hunt",
    "webhook_url": "https://myapp.com/webhook/email-finder",
    "prospects": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "company_name": "Example Corp",
        "company_domain": "example.com"
      },
      {
        "first_name": "Jane",
        "last_name": "Smith",
        "company_name": "TechStart Inc"
      }
    ]
  }'

Responses

Job accepted and processing started

Get Email Finder job results

Request

Retrieve the results of a specific email finder job

Security
BearerToken
Path
idstringrequired
curl -i -X GET \
  'https://docs.evaboot.com/_mock/schema/v1/email-finder/{id}/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Email finder job results retrieved successfully

Bodyapplication/json
idstringread-onlyrequired
statusstringread-onlyrequired
  • pending - Pending
  • running - Running
  • complete - Complete
  • failed - Failed
Enum"pending""running""complete""failed"
created_atstring(date-time)read-onlyrequired
updated_atstring(date-time)read-onlyrequired
progressintegerread-onlyrequired
error_messagestring or nullread-onlyrequired
prospectsArray of objects(EmailFinderProspectDetail)read-onlyrequired
prospects[].​idstring(uuid)read-onlyrequired
prospects[].​first_namestringread-onlyrequired
prospects[].​last_namestringread-onlyrequired
prospects[].​full_namestringread-onlyrequired
prospects[].​company_namestringread-onlyrequired
prospects[].​company_domainstringread-onlyrequired
prospects[].​found_emailstring or nullread-onlyrequired
prospects[].​email_validitystringread-onlyrequired
prospects[].​statusstringread-onlyrequired
  • pending - Pending
  • processing - Processing
  • complete - Complete
  • failed - Failed
Enum"pending""processing""complete""failed"
prospects[].​error_messagestring or nullread-onlyrequired
job_typestringread-onlyrequired
  • email_finder - Email Finder
  • email_validation - Email Validation
Enum"email_finder""email_validation"
Response
application/json
{
  "id": "dcbcdb01-42a8-4efb-91a7-ce6a9ba01afb",
  "status": "complete",
  "created_at": "2023-01-01T12:00:00Z",
  "updated_at": "2023-01-01T12:05:00Z",
  "progress": 100,
  "error_message": "1 prospect failed.",
  "prospects": [
    { … },
    { … },
    { … }
  ],
  "job_type": "email_finder"
}

Email Verifier

Operations for verifying email addresses

Operations

Account

Account and quota management operations

Operations