Caspar Person Autotrace API
/caspar_person_autotrace
Where Caspar Person Search returns matches against your criteria, Autotrace orchestrates dozens or hundreds of internal searches to assemble a ranked list of likely matches. Each one is scored by how well it lines up with the identifiers you supplied. Optionally include possible relatives in the results. Suited to collections, investigations and skip-tracing where the goal is "find this person, and tell me how confident you are".
Example Request
POSTRequest Schema
name_combined
name_first
name_middle
name_last
Name fields. name_last is the minimum requirement.
dob
Date of birth.
phone1
phone2
phone3
phone4
Up to four known phone numbers.
email1
email2
email3
email4
Up to four known email addresses.
Address components
Address scoping for distance-based scoring.
option_relatives
Include possible relatives. Records that don't match the full name but have an association.
first_result
max_results
Pagination.
sort_by
sort_order
Default is score DESC, which is the most useful ordering for autotrace.
Available Response Data
4 Data PointsAll fields returned by Caspar Person Search
identity, contacts, address, demographic, indicators
score: a unitless integer ranking. Higher is better.
match_type: primary (direct match) or relative
possible relative
Scoring factors in the distance between the supplied address and the matched address
API Data Scale & Coverage tag
Unmatched data depth to power your compliance and verification workflows.
Technical Use Cases tag
Automated skip tracing
Replace manual investigation with an automated trace that returns ranked candidates. Collectors and investigators can triage by score instead of hand-searching.
Beneficiary and next-of-kin discovery
With option_relatives: true, surface possible relatives of a target person. Useful for estate administration, unclaimed money work and family reconnection cases.
Confidence-graded identity resolution
When you've got a stale contact record, autotrace returns several candidates with confidence scores. Your workflow can route high-confidence single matches one way and ambiguous ones to a human review queue.
Compliance & Security tag
Enterprise-grade infrastructure audited against the standards your regulators require.
Common Questions tag
Everything you need to know about implementation details and compliance infrastructure.
rocket_launch Implementation
How long does an autotrace take?
add
How long does an autotrace take?
A single trace can run tens to hundreds of internal searches behind the scenes to gather and rank results. It may take several seconds. Plan your timeouts accordingly, especially if you’re running multiple autotraces in sequence.
rocket_launch Implementation
What does the score actually mean?
add
What does the score actually mean?
It’s a unitless integer. Higher means better match. The score factors in several parameters, including the distance between the supplied address and the matched address. If you don’t supply an address, the score may not be meaningful. There’s no fixed minimum threshold, so interpret scores in the context of your own use case.
rocket_launch Implementation
Primary vs relative — what's the difference?
add
Primary vs relative — what's the difference?
primary is a direct match against the criteria you supplied. relative (only returned when option_relatives: true) means the record has an association with the searched person but doesn’t match the full name. Think partner, parent, child or other connection.
API Testing Sandbox tag
Test the Caspar Person Autotrace API directly in your browser with live mock data and see instant results.
rocket_launch Request Sandbox AccessAccess to live sandbox environments requires manual approval from our compliance team.