Caspar Person Search API
/caspar_person_search
The most flexible identity search in the Global Data universe. Caspar accepts any combination of name, address, phone, email, IP address or social profile URL and returns matching person records with their full known contact and address history. Six "smart" options let you widen or narrow the search, including the smart-search mode that treats name and address as one criterion and the other identifiers as independent matchers.
Example Request
POSTRequest Schema
name_combined
name_first
name_middle
name_last
Person name fields. At minimum, name_last (or another search key) has to be supplied.
dob_from
dob_to
DOB range bounds.
secondary_name_first
secondary_name_last
secondary_dob_from
secondary_dob_to
Secondary person search. Finds two people at the same address.
street_address
suburb
state
postcode
full_address
suburb_state_postcode
Address components, a full address, or address line 2.
phone
Phone number.
email
Email address.
ip_address
IPv4 only. IPv6 is not supported.
social_url
Facebook, LinkedIn, Twitter/X, YouTube, Instagram, Indeed, GitHub, Meetup, Quora, Gravatar, Foursquare or Pinterest profile URL.
option_smartname
Matches initials, first-name equivalents (Robert / Bob / Rob) and similar-sounding last names (Smith / Smyth).
option_smartemail
Matches the email username across different domains and TLDs.
option_smartphone
Matches partial phone numbers across area codes and mobile prefixes.
option_smartaddress
Matches similar or misspelled addresses in the selected area or neighbouring suburbs.
option_smartsearch
Changes the search logic to (Name AND Address) OR Phone OR Email OR IP OR Social
option_marketing_opt_in
Include per-contact marketing_opt_in flags on each record.
first_result
max_results
Pagination. max_results is capped at 30.
sort_by
sort_order
Result ordering.
Available Response Data
23 Data PointsFull name (title, first, middle, last) and gender
Date of birth (year only) or year-only DOB range
Deceased flag and deceased date
year
All known phone numbers
All known email addresses
Social media profiles
Associated IP addresses
Cached connectivity check results for phones and emails
empty when no cache exists
Per-contact marketing_opt_in
when opted in
Address: GNAF ID, street, suburb, state, postcode
Tenancy dates
date_start, date_end
Legal parcel ID
ABS meshblock category
Residential, Commercial, Parkland, and so on
Latitude and longitude
Real estate events at the address
sale or rental listings
Judgements at the address
Possible ABN business associations
Address info: property type (e.g. agedcare) and detail
SEIFA demographic indices (IRSAD, IER, IEO) as deciles from 0 to 10
Court record indicator
Y / N
Social record indicator
Y / N
Employment record indicator
Y / N
Data sources contributing to the record
government, proprietary_records, competition
API Data Scale & Coverage tag
Unmatched data depth to power your compliance and verification workflows.
Technical Use Cases tag
Investigations and skip tracing
Trace individuals across name changes, address moves and contact changes using the most permissive identity search on the platform. IP and social profile lookups included.
Service of process and litigation
Locate current and historical addresses for individuals required for service of process, with confidence weighted by data source and match type.
Collections and debt recovery
Find current contact details for debtors with stale contact information, using smart matching across name variants and partial information.
Property and tenant due diligence
Resolve current and past occupants of a property. Useful for body corporates, property managers and investigators.
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
What's the minimum I need to search?
add
What's the minimum I need to search?
At least one of: name_last (or name_combined), phone, email, ip_address, social_url, full_address or street_address. A name-only search needs at least the last name and a partial address (state, suburb, postcode, or a street with locality) to scope the results.
rocket_launch Implementation
What does option_smartsearch change?
add
What does option_smartsearch change?
By default Caspar uses a logical AND across all your inputs. With smart search on, the logic becomes (Name AND Address) OR Phone OR Email OR IP Address OR Social. So a phone-only or email-only match returns a record even when the name and address don’t agree. It’s often how end users intuitively expect search to work.
gavel Compliance
Can I rely on the marketing_opt_in flag for outbound calling?
add
Can I rely on the marketing_opt_in flag for outbound calling?
It tells you per-person, per-contact opt-in status. It does not replace the requirement to run a DNC check on the phone number before calling. Use the DNC API alongside this flag, not as a substitute.
rocket_launch Implementation
Which social networks are supported?
add
Which social networks are supported?
Facebook, LinkedIn, Twitter/X, YouTube, Instagram, Indeed, GitHub, Meetup, Quora, Gravatar, Foursquare and Pinterest. URLs can include or omit the https:// scheme and the www. prefix.
API Testing Sandbox tag
Test the Caspar Person Search 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.
Ready to integrate Caspar Person Search API?
Talk to our team about credentials, sandbox access and the right combination of endpoints for your workflow.