# 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

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"Email","description":"In today's data-driven landscape, having accurate and complete email data directly impacts your organization's efficiency, deliverability, and outreach success.\nDelpha'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.\n\nDelpha evaluates email data across four critical dimensions:\n- **Completeness:** Uses advanced Email Finder technology to locate and populate missing email addresses.\n- **Validity:** Employs a powerful Email Validator to confirm emails adhere to standard formatting rules and are deliverable.\n- **Accuracy:** Ensures that discovered emails match the intended individuals correctly.\n- **Consistency:** Compares the input value to its normalized version (not cross-source).\n\nAdditionally:\n- **Email Validator classifies emails** as personal or professional, supporting GDPR compliance and improving deliverability.\n- **Email Finder** offers **AI-generated email recommendation** for correcting or completing emails, accompanied by **confidence scores** to guide effective decision-making.\n\nDelpha'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."}],"servers":[{"url":"https://api.delpha.io","description":"Production API server"}],"security":[{"oauth2":["api/access"]}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth2 client credentials flow for API access","flows":{"clientCredentials":{"tokenUrl":"https://secure.delpha.io/oauth2/token","scopes":{"api/access":"Access to the public API"}}}}},"schemas":{"EmailSubmitInput":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"The email address"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name","description":"First name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name","description":"Last name"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website","description":"Website URL"}},"type":"object","title":"EmailSubmitInput","description":"Payload to submit a new email quality job."},"EmailSubmitOutput":{"properties":{"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id","description":"The job ID. Required if status <= 300."},"message":{"type":"string","title":"Message","description":"The message to return"},"status":{"type":"string","enum":["SUCCESS","ERROR"],"title":"Status","description":"The status of the process"},"status_code":{"type":"integer","title":"Status Code","description":"The status code to return"}},"type":"object","required":["message","status","status_code"],"title":"EmailSubmitOutput","description":"Response after submitting a new email quality job."}}},"paths":{"/v1/email":{"post":{"tags":["Email"],"summary":"Submit email for finding and validation","description":"Submit an email address for finding and validation. Returns a job ID for tracking the process.","operationId":"findAndValidateEmail","requestBody":{"description":"\n\n**Validation Rules:**\n\n- **Validation mode:** `email` must be provided\n- **Recommendation mode:** `first_name`, `last_name`, and `website` must all be provided\n- If all fields are provided, both validation and recommendation will be performed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailSubmitInput"}}},"required":true},"responses":{"202":{"description":"Job submitted to assess_email_v16","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailSubmitOutput"}}}},"400":{"description":"Invalid email format or missing required fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailSubmitOutput"}}}},"401":{"description":"Authentication failed - invalid or missing OAuth 2.0 token","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailSubmitOutput"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailSubmitOutput"}}}},"502":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailSubmitOutput"}}}}}}}}}
```

## Get email finder and validator job status

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"Email","description":"In today's data-driven landscape, having accurate and complete email data directly impacts your organization's efficiency, deliverability, and outreach success.\nDelpha'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.\n\nDelpha evaluates email data across four critical dimensions:\n- **Completeness:** Uses advanced Email Finder technology to locate and populate missing email addresses.\n- **Validity:** Employs a powerful Email Validator to confirm emails adhere to standard formatting rules and are deliverable.\n- **Accuracy:** Ensures that discovered emails match the intended individuals correctly.\n- **Consistency:** Compares the input value to its normalized version (not cross-source).\n\nAdditionally:\n- **Email Validator classifies emails** as personal or professional, supporting GDPR compliance and improving deliverability.\n- **Email Finder** offers **AI-generated email recommendation** for correcting or completing emails, accompanied by **confidence scores** to guide effective decision-making.\n\nDelpha'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."}],"servers":[{"url":"https://api.delpha.io","description":"Production API server"}],"security":[{"oauth2":["api/access"]}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth2 client credentials flow for API access","flows":{"clientCredentials":{"tokenUrl":"https://secure.delpha.io/oauth2/token","scopes":{"api/access":"Access to the public API"}}}}},"schemas":{"EmailPullOutput":{"properties":{"message":{"type":"string","title":"Message","description":"A human-readable message describing the current state or outcome of the job."},"status":{"type":"string","enum":["SUCCESS","ERROR"],"title":"Status","description":"The status of the process"},"status_code":{"type":"integer","title":"Status Code","description":"The HTTP status code representing the job's current state."},"result":{"anyOf":[{"$ref":"#/components/schemas/EmailModel"},{"type":"null"}],"description":"The result of the email quality job"},"process_time":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Process Time","description":"The total time taken to process the job, in seconds."}},"type":"object","required":["message","status","status_code"],"title":"EmailPullOutput","description":"Response after retrieving the status and result of an email quality job."},"EmailModel":{"properties":{"label":{"type":"string","enum":["No","OK","OddFormat"],"title":"Label","description":"Label for the email."},"normalized_value":{"type":"string","title":"Normalized Value","description":"Normalized email value."},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"Provider of the email, if any."},"email_domain":{"type":"string","title":"Email Domain","description":"Domain of the email."},"email_domain_qualification":{"$ref":"#/components/schemas/DomainQualification","description":"Qualification of the email domain."},"email_status":{"type":"string","enum":["Invalid","Unknown","Valid"],"title":"Email Status","description":"Status of the email. Possible values: 'Invalid', 'Unknown', 'Valid'."},"suggestions":{"items":{"$ref":"#/components/schemas/EmailSuggestion"},"type":"array","title":"Suggestions","description":"Suggestions for the email."},"website_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website Domain","description":"Website domain associated."},"website_domain_qualification":{"anyOf":[{"$ref":"#/components/schemas/DomainQualification"},{"type":"null"}],"description":"Qualification of the website domain."},"suggestions_from_website":{"items":{"$ref":"#/components/schemas/EmailSuggestion"},"type":"array","title":"Suggestions From Website","description":"Suggestions from the website."},"data_type":{"$ref":"#/components/schemas/DataType","description":"The type of data for this field"},"scores":{"$ref":"#/components/schemas/ScoresModel","description":"Scores for the field"}},"type":"object","required":["label","normalized_value","email_domain","email_domain_qualification","email_status","data_type","scores"],"title":"EmailModel","description":"Model representing the details of an email field."},"DomainQualification":{"type":"string","enum":["nominative@pro","catchall@pro","nominative@perso","catchall@perso","Unknown"],"title":"DomainQualification","description":"Enum representing the possible qualifications for an email or website domain.\n\n- nominative@pro: domain is professional and returns invalid for fake emails\n- catchall@pro: domain is professional and returns valid for fake emails\n- nominative@perso: domain is personal and returns invalid for fake emails\n- catchall@perso: domain is personal and returns valid for fake emails\n- Unknown: grey listed or temporary issue with the server"},"EmailSuggestion":{"properties":{"value":{"type":"string","title":"Value","description":"Suggested email value."},"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"Confidence score for the suggestion."}},"type":"object","required":["value","score"],"title":"EmailSuggestion","description":"Model representing a suggestion for an email."},"DataType":{"type":"string","enum":["email","social_network","name","legal_id","phone","address","website"],"title":"DataType"},"ScoresModel":{"properties":{"accuracy":{"type":"number","maximum":1,"minimum":-1,"title":"Accuracy","description":"Accuracy score","default":-1},"validity":{"type":"integer","maximum":1,"minimum":-1,"title":"Validity","description":"Validity score","default":-1},"completeness":{"type":"number","maximum":1,"minimum":0,"title":"Completeness","description":"Completeness score","default":0},"consistency":{"type":"integer","maximum":1,"minimum":0,"title":"Consistency","description":"Consistency score","default":0}},"type":"object","title":"ScoresModel","description":"Model representing the scores for an email field."}}},"paths":{"/v1/email/{job_id}":{"get":{"tags":["Email"],"summary":"Get email finder and validator job status","description":"Retrieve the result and status of a previously submitted email finder and validator job.","operationId":"getEmailResult","responses":{"200":{"description":"Job succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPullOutput"}}}},"202":{"description":"Job is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPullOutput"}}}},"400":{"description":"Input validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPullOutput"}}}},"401":{"description":"Authentication failed - invalid or missing OAuth 2.0 token","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}}},"500":{"description":"Failed to retrieve job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPullOutput"}}}},"504":{"description":"Job timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailPullOutput"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.delpha.io/delpha-api-and-mcp/api/email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.