Individual

An individual in a family tree as represented in the Family Graph API.

Individuals in a family tree represent people, who are living or deceased. Individuals have several properties and connections. Individuals are connected to each other through family objects. An individual can be a spouse in some families (or none) and a child in some families (or none).

Privatization

Sometimes, the current user will be able to view information about an individual in a family site where the current user is not a member. For example, when the users are viewing individuals in a tree that was matched to their trees. In this case most of the information about living individuals will be hidden to ensure privacy. The API will only expose the last name of these individuals and all other information will not be returned. For the first name, the API will return the string "Living" (translated to the current language).

Fields

The Individual object contains the following fields:

Name	Description	Type	Access Mode
id	The individual's id	id	read
name	The individual's full name	string	read
is_alive	Indicates whether the individual is alive or deceased	boolean	read, write
first_name	The individual's first (and middle) name	string	read, write
last_name	The individual's last name	string	read, write
formatted_last_name	The individual's formatted last name. This will include maiden/married name according to tree preferences.	string	read, write
former_name	The individual's former name	string	read, write
maiden_name	The individual's maiden name	string	read, write
gender	The individual's gender M - Male F - Female U - Unknown	string	read, write
name_prefix	The individual's name prefix (for example, Dr., Sir, Prince)	string	read, write
name_suffix	The individual's name suffix (for example, Jr., Sr., II)	string	read, write
nickname	The individual's nickname	string	read
religious_name	The individual's relegious name	string	read
married_surname	The individual's last name after marriage	string	read, write
alias_name	The individual's alias	string	read
birth_date	The individual's birth date	EventDate object: gedcom, text, date, structured_date and class_name fields	read, write
birth_place	The individual's birth place	string	read, write
death_date	The individual's death date	EventDate object: gedcom, text, date, structured_date and class_name fields	read, write
relationship	The individual's relationship to the individual associated with the current user	Relationship object: individual, relationship_type, relationship_description and class_name fields	read
emails	List of emails of the individual (returned only if the application was granted the "email" scope and the individual is a part of a site the user is a member of)	array of strings	read
is_privatized	Indicates whether the individual is privatized or not	boolean	read
link	Link to this individual on MyHeritage.com	string	read
link_in_tree	Link to this individual in their tree on MyHeritage.com	string	read
link_in_pedigree_tree	Link to this individual in their pedigree tree on MyHeritage.com	string	read
spouse_in_families	List of families where the individual is a spouse (or parent)	array of Family objects containing the id field	read, write
child_in_families	List of families where the individual is a child	array of ChildInFamily objects containing the child, family, child_type and class_name fields	read, write
smartmatch_count	The number of smart matches for the individual	int	read
data_language	The data language of the returned information (ISO-639-1 code)	string	read
personal_photo	The personal photo (profile photo) of the individual	Photo object: id and name fields	read, write
membership	Membership information of the user associated with the individual	Membership object: site, user, is_manager, last_visit_time, visit_count, individual and class_name fields	read
tree	The family tree the individual is part of	Tree object: id and name fields	read, write
site	The family site of the individual's tree	Site object: id and name fields	read, write
matches_count	List of matches count of the individual. in case matchescountfilter parameter is define, return array of matchescount objects	MatchesCount object: match_type, pending, confirmed, rejected, total, new, ignored_sources, ignored_individuals, aggregated_value_add and class_name fields	read
age_group	The individual's age_group. Possible values are 'A' (for adult) and 'C' (for child).	string	read
age_group_in_years	The individual's age_group in years e.g. 30's, 60's etc.	string	read
personal_photos_link	A link to view all the photos the individual is tagged in	string	read
media_count	The number of media for the individual	int	read
ignore_matches	Indicates whether the individual matches are ignored or not	boolean	read, write
formatted_age	The individual's age with formatting logic	string	read
class_name	The object class name	string	read

Connections

The Individual object contains the following connections:

Name	Description	Type	Access Mode
immediate_family	List of first degree relatives of this individual, including parents, spouse(s), children and siblings	array of Relationship objects	read
close_family	List of relatives of this individual. To specify which relatives to return, set the hops parameter to indicate up to which degree of relatives to include in the list. For example hops=4 will include up to 4th degree relatives. Default value is 3	array of Relationship objects	read
events	List of events about of individual, including birth, death and other personal events (but not family events such as marriage, which are included as events of a family object	array of GenealogyEvent objects	read, write
child_in_families_connection	List of families where the individual is a child	array of ChildInFamily objects	read, write
spouse_in_families_connection	List of families where the individual is a spouse (or parent)	array of Family objects	read, write
tags	List of tagged faces of the individual in photos	array of Tag objects	read
media	List of media items of the individual, including photos, videos, document and audios	array of MediaItem objects	read, write
citations	List of citations of the individual	array of Citation objects	read
notes	List of notes of the individual	array of Note objects	read
smartmatches	List of Smart Matches between the individual and individuals in other family trees (ordered by status and then by quality)	array of SmartMatch objects	read
dna_kits	The individual's DNA kits	array of DnaKit objects	read, write
invitations	List of invitations for the individual	array of Invitation objects	read, write

Example

https://familygraph.myheritage.com/individual-144530322-1000001 (open in browser)

{
	"id": "individual-144530322-1000001",
	"name": "John Fitzgerald Kennedy",
	"is_alive": false,
	"first_name": "John Fitzgerald",
	"last_name": "Kennedy",
	"formatted_last_name": "Kennedy",
	"gender": "M",
	"birth_date": {
		"gedcom": "May 29 1917",
		"text": "May 29 1917",
		"date": "1917-05-29",
		"structured_date": {
			"first_date": {
				"day": 29,
				"month": 5,
				"year": 1917,
				"type": "exact",
				"class_name": "SingleDate"
			},
			"type": "exact",
			"class_name": "StructuredDate"
		},
		"class_name": "EventDate"
	},
	"birth_place": "Brookline, Massachusetts",
	"death_date": {
		"gedcom": "Nov 22 1963",
		"text": "Nov 22 1963",
		"date": "1963-11-22",
		"structured_date": {
			"first_date": {
				"day": 22,
				"month": 11,
				"year": 1963,
				"type": "exact",
				"class_name": "SingleDate"
			},
			"type": "exact",
			"class_name": "StructuredDate"
		},
		"class_name": "EventDate"
	},
	"relationship": {
		"individual": {
			"id": "individual-144530322-1000028",
			"name": "Joseph Patrick Kennedy II"
		},
		"relationship_type": "uncle",
		"relationship_description": "Uncle",
		"class_name": "Relationship"
	},
	"is_privatized": false,
	"link": "https:\/\/www.myheritage.com\/person-1000001_144530322_144530322\/john-fitzgerald-kennedy",
	"link_in_tree": "https:\/\/www.myheritage.com\/site-family-tree-144530322\/demo-family-site?rootIndividualID=1000001&familyTreeID=1",
	"link_in_pedigree_tree": "https:\/\/www.myheritage.com\/pedigree-tree-144530322-1000001\/demo-family-site?familyTreeID=1",
	"spouse_in_families": [
		{
			"id": "family-144530322-1000001"
		}
	],
	"child_in_families": [
		{
			"family": {
				"id": "family-144530322-1000002"
			},
			"class_name": "ChildInFamily"
		}
	],
	"smartmatch_count": 0,
	"data_language": "EN",
	"personal_photo": {
		"id": "photo-144530322-2-1000003",
		"name": "John Fitzgerald Kennedy"
	},
	"tree": {
		"id": "tree-144530322-1",
		"name": "jfk"
	},
	"site": {
		"id": "site-144530322",
		"name": "Demo Family Site"
	},
	"age_group": "A",
	"age_group_in_years": "40's",
	"personal_photos_link": "https:\/\/www.myheritage.com\/photo-world\/144530322?tree_id=1&individual_id=1000001",
	"media_count": 101,
	"ignore_matches": false,
	"formatted_age": "Age 46",
	"class_name": "Individual"
}