- Family Graph API
- Objects
- AggregateValueAdd
- Album
- Audio
- BuyNowData
- ChildInFamily
- Citation
- ColorizationData
- Comment
- Config
- ConfirmationStatus
- Counter
- Device
- DiscoveryBase
- DnaAncestorName
- DnaEnums
- DnaEthnicity
- DnaEthnicityReport
- DnaKit
- DnaKitFile
- DnaMatch
- DnaMatchCommonAncestor
- DnaMatchNote
- DnaMatchRelationship
- DnaOrderItemShippingDetails
- Document
- Enums
- EthnicityInLocation
- Event
- EventDate
- EventPlace
- ExportGEDCOM
- ExportGEDCOMStatus
- Family
- FamilyEvent
- GenealogyEvent
- GoalActivity
- Image
- Individual
- Installation
- Invitation
- MatchesCount
- MatchingRequest
- MediaItem
- Membership
- Navigation
- NavigationItem
- NavigationItemBadge
- NewPhotoInfo
- Note
- Notification
- NotificationHistory
- OrderItemCoupon
- OrderItemShippingDetails
- Page
- PersonalPhotosDiscovery
- Phones
- Photo
- PhotoVersion
- Range
- RecordColorizationData
- RecordIndividual
- RecordMatchesCount
- Relationship
- ResiEvent
- ShippingOption
- SingleDate
- Site
- SmartMatch
- Source
- StructuredDate
- StructuredPlace
- SubTree
- SuggestedRelative
- System
- Tag
- ThreadsCount
- Tree
- TreeItem
- User
- UserMenu
- ValueAddData
- ValueAddElement
- ValueAddFactor
- Video
- WorldEthnicities
- SDKs
- PHP SDK
- iOS SDK
- Android SDK
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
|
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 |
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"
}