Skip to main content
POST
/
utility
/
validate
Validate person or company data
curl --request POST \
  --url https://api.example.com/utility/validate \
  --header 'API-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "john.doe@example.com",
  "phone": "+15551234567",
  "first_name": "John",
  "last_name": "Doe",
  "domain": "google.com",
  "company": "Google LLC"
}
'
{
  "valid": true,
  "errors": [],
  "warnings": [
    {
      "field": "phone",
      "value": "+15551234567",
      "warning": "Phone number uses reserved 555 prefix",
      "suggestion": null
    }
  ],
  "suggestions": [
    {
      "field": "company",
      "cleaned": {
        "name": "google",
        "type": "name"
      }
    }
  ]
}

How It Works

Pass any combination of person or company fields and receive errors, warnings, and cleaning suggestions. Use this before enrichment or search to catch formatting issues and improve match rates.

Supported Fields

Person Fields

email, phone, first_name, last_name, full_name, birth_date, social_url, school, address, state, country

Company Fields

company, domain, ticker_symbol, linkedin_company_url

Response

The response includes three sections:
SectionDescription
errorsFields with invalid format that will likely fail matching
warningsFields with potential issues that may reduce match quality
suggestionsCleaned versions of fields that could improve matching

Authorizations

API-Key
string
header
required

Body

application/json

Request model for data validation.

email
string | null
phone
string | null
first_name
string | null
last_name
string | null
full_name
string | null
social_url
string | null
address
string | null
state
string | null
country
string | null
company
string | null
school
string | null
birth_date
string | null
domain
string | null
ticker_symbol
string | null
linkedin_company_url
string | null

Response

Success - validation completed

Response model for data validation.

valid
boolean
required

Whether all data is valid

errors
ValidationError · object[]

List of validation errors

warnings
ValidationWarning · object[]

List of validation warnings

suggestions
ValidationSuggestion · object[]

List of cleaning suggestions