- 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
FamilyEvent
An event of a family represented in the Family Graph API.
Families in a family tree have events such marriage and divorce. Each event includes a type and can also specify a date when the event occurred, a place where it occurred and other properties.
Fields
The FamilyEvent
object contains the following fields:
Name | Description | Type | Access Mode |
id |
The family event's id |
id |
read |
event_type |
The family event's type (see list of possible family event types below) |
string |
read, write |
title |
A description of the family event type in the current data language |
string |
read |
date |
The date when the family event occurred |
EventDate object: gedcom, text, date, structured_date and class_name fields |
read, write |
place |
The place where the family event occurred |
string |
read, write |
header |
A header describing the family event |
string |
read, write |
age_husband |
Age of the husband in the family when the event occurred |
string |
read |
age_wife |
Age of the wife in the family when the event occurred |
string |
read |
link |
Link to family of this event on MyHeritage.com |
string |
read |
data_language |
Language code for the data of the family event (ISO-639-1 code) |
string |
read |
family |
The family the event belongs to |
Family object: id field |
read |
tree |
The family tree of the family the family event belongs to |
Tree object: id and name fields |
read |
site |
The family site of the family event's tree |
Site object: id and name fields |
read |
class_name |
The object class name |
string |
read |
Connections
The FamilyEvent object contains the following connections:Name | Description | Type | Access Mode |
media |
List of media items of the family event, including photos, videos, document and audios |
array of MediaItem objects |
read |
citations |
List of citations of the family event |
array of Citation objects |
read |
notes |
List of notes of the family event |
array of Note objects |
read |
Family event types
Common standard family event types:Name | Description |
MYHERITAGE:REL_OTHER | Other |
MYHERITAGE:REL_UNKNOWN | Unknown |
MYHERITAGE:REL_FRIENDS | Friends |
MYHERITAGE:REL_PARTNERS | Partner |
Partners | Partners |
ENGA | Engagement |
MARR | Marriage |
Marriage | Marriage |
MARL | Civil Marriage |
MARC | Marriage contract |
MARB | Marriage Bann |
Alternate Marriage Info | Alternate Marriage Info |
MARS | Marriage Settlement |
Death of Spouse | Widowed |
Separation | Separation |
ANUL | Annulment |
DIV | Divorce |
DIVF | Divorce filed |
Anecdote | Anecdote |
Comment | Comment |
Fact 1 | Fact 1 |
Fact 2 | Fact 2 |
Fact 3 | Fact 3 |
Fact 4 | Fact 4 |
Fact 5 | Fact 5 |
Fact 6 | Fact 6 |
Fact 7 | Fact 7 |
Fact 8 | Fact 8 |
Fact 9 | Fact 9 |
Family Address | Family Address |
Misc | Misc |
NCHI | Known Number of Children |
Example
Marriage event
https://familygraph.myheritage.com/familyevent-144530322-1000001 (open in browser){
"id": "familyevent-144530322-1000001",
"event_type": "MARR",
"title": "Marriage",
"date": {
"gedcom": "Sep 12 1953",
"text": "Sep 12 1953",
"date": "1953-09-12",
"structured_date": {
"first_date": {
"day": 12,
"month": 9,
"year": 1953,
"type": "exact",
"class_name": "SingleDate"
},
"type": "exact",
"class_name": "StructuredDate"
},
"class_name": "EventDate"
},
"place": "Newport, Rhode Island",
"age_husband": "36",
"age_wife": "24",
"link": "https:\/\/www.myheritage.com\/family-1_1000001_144530322_144530322\/kennedy-john-fitzgerald-kennedy-jacqueline-lee-kennedy-onassis-born-bouvier",
"data_language": "EN",
"family": {
"id": "family-144530322-1000001"
},
"tree": {
"id": "tree-144530322-1",
"name": "jfk"
},
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"class_name": "FamilyEvent"
}