Caspar Person Search API

POST
/caspar_person_search
LIVE

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.

calendar_today Request a Demo Contact Sales

Example Request

POST
request.json
key Auth: BearerAuth 
{
  "name_first": "MARY",
  "name_last": "JONES",
  "full_address": "35 YARALLA ST CONCORD WEST NSW 2138",
  "option_smartsearch": true,
  "option_marketing_opt_in": true,
  "max_results": 10
}

Request Schema

name_combined name_first name_middle name_last
Conditional
string

Person name fields. At minimum, name_last (or another search key) has to be supplied.

dob_from dob_to
Optional
date

DOB range bounds.

secondary_name_first secondary_name_last secondary_dob_from secondary_dob_to
Required
string

Secondary person search. Finds two people at the same address.

street_address suburb state postcode full_address suburb_state_postcode
Conditional
string

Address components, a full address, or address line 2.

phone
Conditional
string · 0NSN or E.164 format

Phone number.

email
Conditional
string

Email address.

ip_address
Optional
string · IPv4

IPv4 only. IPv6 is not supported.

social_url
Optional
boolean · URL

Facebook, LinkedIn, Twitter/X, YouTube, Instagram, Indeed, GitHub, Meetup, Quora, Gravatar, Foursquare or Pinterest profile URL.

option_smartname
Optional
boolean

Matches initials, first-name equivalents (Robert / Bob / Rob) and similar-sounding last names (Smith / Smyth).

option_smartemail
Optional
boolean

Matches the email username across different domains and TLDs.

option_smartphone
Optional
boolean

Matches partial phone numbers across area codes and mobile prefixes.

option_smartaddress
Optional
boolean

Matches similar or misspelled addresses in the selected area or neighbouring suburbs.

option_smartsearch
Optional
boolean

Changes the search logic to (Name AND Address) OR Phone OR Email OR IP OR Social

option_marketing_opt_in
Optional
boolean

Include per-contact marketing_opt_in flags on each record.

first_result max_results
Optional
integer

Pagination. max_results is capped at 30.

sort_by sort_order
Optional
enum

Result ordering.

Available Response Data

23 Data Points
01
person

Full name (title, first, middle, last) and gender

02
schedule

Date of birth (year only) or year-only DOB range

03
schedule

Deceased flag and deceased date

year

04
alternate_email

All known phone numbers

05
location_on

All known email addresses

06
data_object

Social media profiles

07
location_on

Associated IP addresses

08
monitor_heart

Cached connectivity check results for phones and emails

empty when no cache exists

09
alternate_email

Per-contact marketing_opt_in

when opted in

10
monitor_heart

Address: GNAF ID, street, suburb, state, postcode

11
schedule

Tenancy dates

date_start, date_end

12
fingerprint

Legal parcel ID

13
data_object

ABS meshblock category

Residential, Commercial, Parkland, and so on

14
data_object

Latitude and longitude

15
monitor_heart

Real estate events at the address

sale or rental listings

16
location_on

Judgements at the address

17
data_object

Possible ABN business associations

18
location_on

Address info: property type (e.g. agedcare) and detail

19
data_object

SEIFA demographic indices (IRSAD, IER, IEO) as deciles from 0 to 10

20
data_object

Court record indicator

Y / N

21
data_object

Social record indicator

Y / N

22
data_object

Employment record indicator

Y / N

23
database

Data sources contributing to the record

government, proprietary_records, competition

lock Full API documentation provided after vetting from our compliance team.
By The Numbers

API Data Scale & Coverage tag

Unmatched data depth to power your compliance and verification workflows.

50M+
Phone & Email Records
40M+
Adverse Court Records
2BN+
Australian Universe Records
18M+
Real Estate Records
7M+
Deceased Records
980M+
Social Media & Employment Records
Practical Applications

Technical Use Cases tag

manage_search

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.

gavel

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.

payments

Collections and debt recovery

Find current contact details for debtors with stale contact information, using smart matching across name variants and partial information.

home

Property and tenant due diligence

Resolve current and past occupants of a property. Useful for body corporates, property managers and investigators.

Trust & Assurance

Compliance & Security tag

Enterprise-grade infrastructure audited against the standards your regulators require.

verified_user
ISO 27001 Certified
enhanced_encryption
AES-256 Encryption
public
Australian Data Sovereignty
Integration & Support

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

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

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

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

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.

Try it Live

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 Access

Access to live sandbox environments requires manual approval from our compliance team.

(03) 9948 4089
Request a Demo
BACK TO TOP