# Name

Names are at the heart of every contact record—yet they're often incomplete, misspelled, or reversed. Delpha's **Name Validator** helps you detect, normalize, and correct person names to ensure consistent, high-quality identity data across your systems.

Each input is evaluated through several smart checks:

* **Completeness:** Measures whether both *first name* and *last name* are present, returning individual scores for each.
* **Validity:** Confirms if the given names exist in trusted linguistic databases.
* **Consistency:** Compares the original input to its normalized form (capitalization, spacing, hyphenation, etc.).
* **Misspelled:** Detects potential typos and suggests the closest valid alternatives.
* **Reversed:** Identifies when *first name* and *last name* appear swapped based on statistical likelihoods.

The API returns a **normalized version** of the name, along with these detailed quality indicators. When needed, it also proposes gentle corrections—like fixing a misspelling or switching first and last names—always preserving the user's intended identity.

With **Name Validator**, your contact data stays clean, standardized, and ready for reliable engagement.

## Submit name for finding and validation

> Submit an name 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":"Name","description":"Names are at the heart of every contact record—yet they're often incomplete, misspelled, or reversed.\nDelpha's **Name Validator** helps you detect, normalize, and correct person names to ensure consistent, high-quality identity data across your systems.\n\nEach input is evaluated through several smart checks:\n- **Completeness:** Measures whether both *first name* and *last name* are present, returning individual scores for each.\n- **Validity:** Confirms if the given names exist in trusted linguistic databases.\n- **Consistency:** Compares the original input to its normalized form (capitalization, spacing, hyphenation, etc.).\n- **Misspelled:** Detects potential typos and suggests the closest valid alternatives.\n- **Reversed:** Identifies when *first name* and *last name* appear swapped based on statistical likelihoods.\n\nThe API returns a **normalized version** of the name, along with these detailed quality indicators. When needed, it also proposes gentle corrections—like fixing a misspelling or switching first and last names—always preserving the user's intended identity.\n\nWith **Name Validator**, your contact data stays clean, standardized, and ready for reliable engagement."}],"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":{"NameSubmitInput":{"properties":{"first_name":{"type":"string","title":"First Name","description":"The first name of the entity"},"last_name":{"type":"string","title":"Last Name","description":"The last name of the entity"}},"type":"object","required":["first_name","last_name"],"title":"NameSubmitInput","description":"Payload to submit a new name quality job."},"NameSubmitOutput":{"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":"NameSubmitOutput","description":"Response after submitting a new name quality job."}}},"paths":{"/v1/name":{"post":{"tags":["Name"],"summary":"Submit name for finding and validation","description":"Submit an name for finding and validation. Returns a job ID for tracking the process.","operationId":"findAndValidateName","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameSubmitInput"}}},"required":true},"responses":{"202":{"description":"Job submitted to assess_name_v16","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameSubmitOutput"}}}},"400":{"description":"Invalid name format or missing required fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameSubmitOutput"}}}},"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/NameSubmitOutput"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameSubmitOutput"}}}},"502":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameSubmitOutput"}}}}}}}}}
```

## Get name finder and validator job status

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"Name","description":"Names are at the heart of every contact record—yet they're often incomplete, misspelled, or reversed.\nDelpha's **Name Validator** helps you detect, normalize, and correct person names to ensure consistent, high-quality identity data across your systems.\n\nEach input is evaluated through several smart checks:\n- **Completeness:** Measures whether both *first name* and *last name* are present, returning individual scores for each.\n- **Validity:** Confirms if the given names exist in trusted linguistic databases.\n- **Consistency:** Compares the original input to its normalized form (capitalization, spacing, hyphenation, etc.).\n- **Misspelled:** Detects potential typos and suggests the closest valid alternatives.\n- **Reversed:** Identifies when *first name* and *last name* appear swapped based on statistical likelihoods.\n\nThe API returns a **normalized version** of the name, along with these detailed quality indicators. When needed, it also proposes gentle corrections—like fixing a misspelling or switching first and last names—always preserving the user's intended identity.\n\nWith **Name Validator**, your contact data stays clean, standardized, and ready for reliable engagement."}],"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":{"NamePullOutput":{"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/NameModel"},{"type":"null"}],"description":"The result of the name 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":"NamePullOutput","description":"Response after retrieving the status and result of an name quality job."},"NameModel":{"properties":{"data_type":{"$ref":"#/components/schemas/DataType","description":"The type of data for this field"},"normalized_value":{"$ref":"#/components/schemas/NormalizedNameModel","description":"Normalized name value."},"label":{"type":"string","enum":["No","OK","Misspelled","Reversed"],"title":"Label","description":"Label for the name."},"scores":{"$ref":"#/components/schemas/NameScoresModel","description":"Scores for the field"},"suggestions":{"$ref":"#/components/schemas/NameRecommendation","description":"Recommendations for the name."}},"type":"object","required":["data_type","normalized_value","label","scores","suggestions"],"title":"NameModel","description":"Model representing the details of an name field."},"DataType":{"type":"string","enum":["email","social_network","name","legal_id","phone","address","website"],"title":"DataType"},"NormalizedNameModel":{"properties":{"first_name":{"type":"string","title":"First Name","description":"The first name of the entity"},"last_name":{"type":"string","title":"Last Name","description":"The last name of the entity"}},"type":"object","required":["first_name","last_name"],"title":"NormalizedNameModel","description":"Model representing the normalized name."},"NameScoresModel":{"properties":{"accuracy":{"type":"number","title":"Accuracy","description":"The accuracy of the name"},"reversed":{"type":"number","title":"Reversed","description":"The reversed of the name"},"misspelled":{"$ref":"#/components/schemas/DoubleScoresModel","description":"The misspelled of the names"},"consistency":{"$ref":"#/components/schemas/DoubleScoresModel","description":"The consistency of the names"},"validity":{"$ref":"#/components/schemas/DoubleScoresModel","description":"The validity of the names"},"completeness":{"$ref":"#/components/schemas/DoubleScoresModel","description":"The completeness of the names"}},"type":"object","required":["accuracy","reversed","misspelled","consistency","validity","completeness"],"title":"NameScoresModel","description":"Model representing the scores of an name."},"DoubleScoresModel":{"properties":{"first_name":{"type":"number","title":"First Name","description":"The scores of the first name"},"last_name":{"type":"number","title":"Last Name","description":"The scores of the last name"}},"type":"object","required":["first_name","last_name"],"title":"DoubleScoresModel","description":"Model representing the scores of an double name."},"NameRecommendation":{"properties":{"first_name":{"items":{"$ref":"#/components/schemas/SingleNameRecommendation"},"type":"array","title":"First Name","description":"The first name of the entity"},"last_name":{"items":{"$ref":"#/components/schemas/SingleNameRecommendation"},"type":"array","title":"Last Name","description":"The last name of the entity"}},"type":"object","required":["first_name","last_name"],"title":"NameRecommendation","description":"Model representing a recommendation for an name."},"SingleNameRecommendation":{"properties":{"value":{"type":"string","title":"Value","description":"The value of the name"},"score":{"type":"number","maximum":1,"minimum":0,"title":"Score","description":"The score of the name"}},"type":"object","required":["value","score"],"title":"SingleNameRecommendation","description":"Model representing a recommendation for a single name."}}},"paths":{"/v1/name/{job_id}":{"get":{"tags":["Name"],"summary":"Get name finder and validator job status","description":"Retrieve the result and status of a previously submitted name finder and validator job.","operationId":"getNameResult","responses":{"200":{"description":"Job succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamePullOutput"}}}},"202":{"description":"Job is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamePullOutput"}}}},"400":{"description":"Input validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamePullOutput"}}}},"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/NamePullOutput"}}}},"504":{"description":"Job timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamePullOutput"}}}}}}}}}
```


---

# 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/name.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.