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

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

dna_matches

The individual's DNA matches

array of DnaMatch 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,
"class_name": "Individual"
}