Phone

Phone numbers remain one of the most direct and effective communication channels—when they're accurate and properly formatted. Delpha's Phone Validator helps you standardize, verify, and clean your phone data to ensure consistency across systems and better outreach performance.

Each phone entry is evaluated on three key aspects:

• Completeness: Detects whether a phone number is present and properly structured.

• Validity: Checks if the number follows the correct national or international format and isn't blacklisted or clearly invalid.

• Consistency: Compares the original input to its normalized international form.

By using optional context such as a country or country code, the system applies the right validation rules and returns a standardized E.164-compliant number. When no country is provided, Delpha applies smart defaults based on global dialing patterns.

Focused purely on validation and normalization, Phone Validator ensures your phone data stays clean, reliable, and ready for business use.

Submit phone for finding and validation

post

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

Important: For proper normalization and country detection, either:

• Provide a phone number with international code (e.g., "[phone]"), OR
• Provide the phone number along with country or country_code

If none of these conditions are met, the system may not be able to properly detect the country and apply the related normalization.

phonestringRequired

The phone number. Should include international code (e.g., '[phone]') for automatic country detection. If not provided, 'country' or 'country_code' must be specified.

Example: [phone]

countryany ofOptional

The country name of the phone number (e.g., 'France'). Required if phone number does not include international code (+XX).

Example: France

stringOptional

or

nullOptional

country_codeany ofOptional

The 2-letter ISO country code of the phone number.Required if phone number does not include international code (+XX).

Example: FR

stringOptional

or

nullOptional

Responses

202

Job submitted to assess_phone_v16

application/json

Response after submitting a new phone 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_phone_v16

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The status code to return

Example: 202

400

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

HTTPcURLJavaScriptPython

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

{
  "phone": "[phone]",
  "country": "France",
  "country_code": "FR"
}

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

Get phone finder and validator job status

get

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

Example: {"area":"France","carrier":"Orange France","data_type":"phone","normalized_value":"[phone]","phone_type":"MOBILE","scores":{"accuracy":-1,"completeness":1,"consistency":1,"validity":1},"timezone":"Europe/Paris","zone":"FR"}

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

HTTPcURLJavaScriptPython

GET /v1/phone/{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": "phone",
    "normalized_value": "[phone]",
    "phone_type": "MOBILE",
    "carrier": "Orange France",
    "timezone": "Europe/Paris",
    "zone": "FR",
    "area": "France",
    "scores": {
      "validity": 1,
      "completeness": 1,
      "consistency": 1,
      "accuracy": -1
    }
  },
  "process_time": 0.123
}