Email

In today's data-driven landscape, having accurate and complete email data directly impacts your organization's efficiency, deliverability, and outreach success. Delpha's Email Finder and Email Validator solutions ensure your email database remains robust, accurate, and up-to-date by systematically discovering missing emails and verifying email addresses.

Delpha evaluates email data across four critical dimensions:

• Completeness: Uses advanced Email Finder technology to locate and populate missing email addresses.

• Validity: Employs a powerful Email Validator to confirm emails adhere to standard formatting rules and are deliverable.

• Accuracy: Ensures that discovered emails match the intended individuals correctly.

• Consistency: Compares the input value to its normalized version (not cross-source).

Additionally:

• Email Validator classifies emails as personal or professional, supporting GDPR compliance and improving deliverability.

• Email Finder offers AI-generated email recommendation for correcting or completing emails, accompanied by confidence scores to guide effective decision-making.

Delpha's integrated Email Finder and Email Validator provide a comprehensive health check and intelligent enrichment, delivering actionable insights that enhance communication success, regulatory compliance, and overall data integrity.

Submit email for finding and validation

post

Submit an email address for finding and validation. Returns a job ID for tracking the process.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

oauth2

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Body

application/json

Payload to submit a new email quality job.

emailany ofOptional

The email address

Example: [email protected]

stringOptional

or

nullOptional

first_nameany ofOptional

First name

Example: Victor

stringOptional

or

nullOptional

last_nameany ofOptional

Last name

Example: Goubet

stringOptional

or

nullOptional

websiteany ofOptional

Website URL

Example: https://delpha.io/

stringOptional

or

nullOptional

Responses

202

Job submitted to assess_email_v16

application/json

400

Invalid email format or missing required fields

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

402

Payment Required

application/json

500

Internal server error

application/json

502

Service unavailable

application/json

post

/v1/email

HTTPcURLJavaScriptPython

POST /v1/email HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "email": "[email protected]",
  "first_name": "Victor",
  "last_name": "Goubet",
  "website": "https://delpha.io/"
}

{
  "job_id": "21014abc65004d2781d2e0ef4c9fbb46",
  "message": "Job submitted to assess_email_v16",
  "status": "SUCCESS",
  "status_code": 202
}

Get email finder and validator job status

get

Retrieve the result and status of a previously submitted email finder and validator job.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

oauth2

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Path parameters

job_idstringRequired

The unique identifier of the email job

Example: {"summary":"Sample job ID","value":"21014abc65004d2781d2e0ef4c9fbb46"}

Responses

200

Job succeeded.

application/json

Response after retrieving the status and result of an email quality job.

messagestringRequired

A human-readable message describing the current state or outcome of the job.

Example: Job succeeded.

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The HTTP status code representing the job's current state.

Example: 200

resultany ofOptional

The result of the email quality job

Example: {"data_type":"email","email_domain":"orange.fr","email_domain_qualification":"nominative@perso","email_status":"Valid","label":"OK","normalized_value":"[email protected]","provider":"Orange","scores":{"accuracy":0.7116992363593002,"completeness":1,"consistency":0,"validity":1},"suggestions":[{"score":0.7260620227245627,"value":"[email protected]"}],"suggestions_from_website":[{"score":0.7260620227245627,"value":"[email protected]"}],"website_domain":"delpha.io","website_domain_qualification":"nominative@pro"}

or

nullOptional

process_timeany ofOptional

The total time taken to process the job, in seconds.

Example: 0.123

numberOptional

or

nullOptional

202

Job is still running.

application/json

400

Input validation failed.

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

500

Failed to retrieve job.

application/json

504

Job timed out.

application/json

get

/v1/email/{job_id}

HTTPcURLJavaScriptPython

GET /v1/email/{job_id} HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "message": "Job succeeded.",
  "status": "SUCCESS",
  "status_code": 200,
  "result": {
    "label": "OK",
    "normalized_value": "[email protected]",
    "provider": "Orange",
    "email_domain": "orange.fr",
    "email_domain_qualification": "nominative@perso",
    "email_status": "Valid",
    "suggestions": [
      {
        "value": "[email protected]",
        "score": 0.7260620227245627
      }
    ],
    "website_domain": "delpha.io",
    "website_domain_qualification": "nominative@pro",
    "suggestions_from_website": [
      {
        "value": "[email protected]",
        "score": 0.7260620227245627
      }
    ],
    "data_type": "email",
    "scores": {
      "validity": 1,
      "completeness": 1,
      "accuracy": 0.7116992363593002,
      "consistency": 0
    }
  },
  "process_time": 0.123
}