Skip to content

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

Email Verifier

Operations for verifying email addresses

Operations

Verify an email

Request

Validate a single email address synchronously. Returns validation results immediately including deliverability status.

Security
BearerToken
Body
required
emailstring(email)<= 255 charactersrequired

Email address to validate

curl -i -X POST \
  https://docs.evaboot.com/_mock/schema/v1/email-validation/single/ \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "john.doe@example.com"
  }'

Responses

Email validation completed successfully

List email validation jobs

Request

List all email validation jobs created by the authenticated user

Security
BearerToken
curl -i -X GET \
  https://docs.evaboot.com/_mock/schema/v1/email-validation/ \
  -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
[
  [
    { … },
    { … }
  ]
]

Create an email validation job

Request

Create a new job to validate the provided email addresses.

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(EmailValidationProspect)required
prospects[].​emailstring or null(email)<= 255 characters
curl -i -X POST \
  https://docs.evaboot.com/_mock/schema/v1/email-validation/ \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "job_name": "Email List Validation",
    "webhook_url": "https://myapp.com/webhook/email-validation",
    "prospects": [
      {
        "email": "john.doe@example.com"
      },
      {
        "email": "jane.smith@techstart.io"
      },
      {
        "email": "contact@company.org"
      }
    ]
  }'

Responses

Job accepted and processing started

Get email validation job results

Request

Retrieve the results of a specific email validation job

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

Responses

Email validation 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(EmailValidationProspectDetail)read-onlyrequired
prospects[].​idstring(uuid)read-onlyrequired
prospects[].​emailstring or null(email)read-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": "550e8400-e29b-41d4-a716-446655440000",
  "status": "complete",
  "created_at": "2023-01-01T12:00:00Z",
  "updated_at": "2023-01-01T12:05:00Z",
  "progress": 100,
  "error_message": null,
  "prospects": [
    { … },
    { … },
    { … }
  ],
  "job_type": "email_validation"
}

Account

Account and quota management operations

Operations