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
Languages
Servers
Mock server
https://docs.evaboot.com/_mock/schema
Production Server
https://api.evaboot.com

Operations for extracting profiles from LinkedIn

Operations

Operations for finding email addresses

Operations

Operations for verifying email addresses

Operations

Request

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

Security
BearerToken
Bodyrequired
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": "[email protected]"
  }'

Responses

Email validation completed successfully

Bodyapplication/json
property name*anyadditional property
Response
application/json
{ "success": true, "job_id": "dcbcdb01-42a8-4efb-91a7-ce6a9ba01afb", "prospect": { "email": "[email protected]", "email_validity": "safe", "status": "complete", "error_message": null } }

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
Bodyrequired
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": "[email protected]"
      },
      {
        "email": "[email protected]"
      },
      {
        "email": "[email protected]"
      }
    ]
  }'

Responses

Job accepted and processing started

Bodyapplication/json
property name*anyadditional property
Response
application/json
{ "success": true, "job_id": "550e8400-e29b-41d4-a716-446655440000", "message": "Email validation job created and processing has begun" }

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

List of email validation jobs

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

Example of a single email validation job in the list response

[ { "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, "prospect_count": "3", "job_type": "email_validation" } ]

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

Example of a completed email validation job with validation results

{ "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 and quota management operations

Operations
Operations