Person Object

This object represents a single real-world person. It contains a summary of all information we have on that person. We do our best to merge relevant pieces of information and remove duplicates.

Metadata

Attribute

Type

Description

@id

GUID

An identifier of this person in this response. To be used in conjunction with @person_id in the Source object. Only shown if the response includes a single person object.

@inferred

Boolean

Whether this person is made up solely from data inferred by statistical analysis from your search query. You can control inference using the minimum_probability parameter and inference of persons using the infer_persons parameter.

@search_pointer

String

A special string crafted by the API for follow-up searches.

@match

Float

0-1. The level of confidence we have that this is the person you’re looking for.

Data

Member

Type

Description

names

Name[]

Array of names

emails

Email[]

Array of emails

usernames

Username[]

Array of usernames

phones

Phones[]

Array of phones

gender

Gender

A gender object

dob

DOB

A date of birth object

languages

Language[]

Array of languages

origin_countries

OriginCountry[]

Array of origin countries

addresses

Address[]

Array of addresses

jobs

Job[]

Array of jobs

educations

Educations[]

Array of educations

relationships

Relationships[]

Array of relationships

user_ids

UserID[]

Array of user ids

images

Image[]

Array of images

urls

Url[]

Array of urls

Example Person Object

{
  "@id": GUID,
  "@search_pointer": "string",
  "@match": float,
  "names": [],
  "emails": [],
  "usernames": [],
  "phones": [],
  "gender": {},
  "dob": {},
  "languages": [],
  "origin_countries": [],
  "addresses": [],
  "jobs": [],
  "educations": [],
  "relationships": [],
  "user_ids": [],
  "images": [],
  "urls": []
}