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

post

Submit an name 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 name quality job.

first_namestringRequired

The first name of the entity

Example: Victor

last_namestringRequired

The last name of the entity

Example: Goubet

Responses

202

Job submitted to assess_name_v16

application/json

Response after submitting a new name quality job.

job_idany ofOptional

The job ID. Required if status <= 300.

Example: 21014abc65004d2781d2e0ef4c9fbb46

stringOptional

or

nullOptional

messagestringRequired

The message to return

Example: Job submitted to assess_name_v16

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The status code to return

Example: 202

400

Invalid name 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/name

HTTPcURLJavaScriptPython

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

{
  "first_name": "Victor",
  "last_name": "Goubet"
}

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

Get name finder and validator job status

get

Retrieve the result and status of a previously submitted name 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 name job

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

Responses

200

Job succeeded.

application/json

202

Job is still running.

application/json

Response after retrieving the status and result of an name 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 name quality job

Example: {"data_type":"name","label":"OK","normalized_value":{"first_name":"Victor","last_name":"Goubet"},"scores":{"accuracy":0,"completeness":{"first_name":1,"last_name":1},"consistency":{"first_name":1,"last_name":0},"misspelled":{"first_name":0,"last_name":1},"reversed":0.192,"validity":{"first_name":1,"last_name":1}},"suggestions":{"first_name":[{"score":1,"value":"Victor"}],"last_name":[{"score":0.91,"value":"GOBET"},{"score":0.73,"value":"GABET"}]}}

or

nullOptional

process_timeany ofOptional

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

Example: 0.123

numberOptional

or

nullOptional

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/name/{job_id}

HTTPcURLJavaScriptPython

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

{
  "message": "Job succeeded.",
  "status": "SUCCESS",
  "status_code": 200,
  "result": {
    "data_type": "name",
    "normalized_value": {
      "first_name": "Victor",
      "last_name": "Goubet"
    },
    "label": "OK",
    "scores": {
      "accuracy": 0,
      "reversed": 0.192,
      "misspelled": {
        "first_name": 0,
        "last_name": 1
      },
      "consistency": {
        "first_name": 1,
        "last_name": 0
      },
      "validity": {
        "first_name": 1,
        "last_name": 1
      },
      "completeness": {
        "first_name": 1,
        "last_name": 1
      }
    },
    "suggestions": {
      "first_name": [
        {
          "value": "Victor",
          "score": 1
        }
      ],
      "last_name": [
        {
          "value": "GOBET",
          "score": 0.91
        },
        {
          "value": "GABET",
          "score": 0.73
        }
      ]
    }
  },
  "process_time": 0.123
}