Confidence Scores

Person search responses include confidence scores on three levels: the person record itself, each phone number, and each email address. All scores range from 0 to 100 and represent relative confidence — a higher score means stronger evidence of association.

Score Types

Person Match Score

The top-level match_score on a person record indicates how well that record matches your search query. Higher scores reflect stronger matches across name, location, and other query parameters. A companion matched_by array names which of your query inputs contributed to the match.

{
  "id": "P1234567890",
  "name": "John Smith",
  "match_score": 94,
  "matched_by": ["first_name", "last_name", "address"],
  ...
}

Use match_score to rank or filter results when multiple people match your query, and matched_by to understand which inputs were most decisive.

Phone Score

Each phone number includes a score indicating confidence that the number is actively associated with this person.

"phones": [
  { "number": "(212) 555-0198", "type": "mobile", "score": 95 },
  { "number": "(212) 555-0199", "type": "landline", "score": 41 }
]

A higher score means the number is more likely to be current and correctly attributed. A low score may indicate the number is outdated or only loosely associated.

Email Score

Each email address includes a score indicating confidence that the address belongs to this person.

"emails": [
  { "email": "john.smith@example.com", "score": 88 },
  { "email": "jsmith85@gmail.com", "score": 52 }
]

Interpreting Scores

Scores are relative, not absolute thresholds. There is no fixed cutoff for "good" vs "bad" — the right threshold depends on your use case:

Related