- 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
Event
An event of an individual represented in the Family Graph API.
Individuals in a family tree have events such as birth, occupation and death. 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 Event
object contains the following fields:
Name | Description | Type | Access Mode |
id |
The event's id |
id |
read |
event_type |
The event's type (see list of possible event types below) |
string |
read, write |
title |
A description of the event type in the current data language |
string |
read |
date |
The date when the event occurred |
EventDate object: gedcom, text, date, structured_date and class_name fields |
read, write |
place |
The place where the event occurred |
string |
read, write |
header |
A header describing the event (for example, the occupation in an OCCU event) |
string |
read, write |
age |
Age of individual when the event occurred |
string |
read |
link |
Link to individual of this event on MyHeritage.com |
string |
read |
data_language |
Language code for the data of the event (ISO-639-1 code) |
string |
read |
individual |
The individual that the event belongs to |
Individual object: id and name fields |
read |
tree |
The family tree of the family the event belongs to |
Tree object: id and name fields |
read |
site |
The family site of the event's tree |
Site object: id and name fields |
read |
event_place |
The event location |
EventPlace object: |
read |
class_name |
The object class name |
string |
read |
Death fields
Fields that are only relevant for individual's death event, where event_type = DEAT
Name | Description | Type | Access Mode |
cause_of_death |
Cause of death of the individual |
string |
read |
Physical description fields
Fields that are only relevant for a description event, where event_type = DESC
Name | Description | Type | Access Mode |
hair_color |
Color of hair of the individual |
string |
read |
eye_color |
Color of eyes of the individual |
string |
read |
height |
Height of the individual |
string |
read |
weight |
Weight of the individual |
string |
read |
description |
Physical description of the individual |
string |
read |
Connections
The Event object contains the following connections:Name | Description | Type | Access Mode |
media |
List of media items of the event, including photos, videos, document and audios |
array of MediaItem objects |
read |
citations |
List of citations of the event |
array of Citation objects |
read |
notes |
List of notes of the event |
array of Note objects |
read |
Event types
Common standard event types:Name | Description |
Accomplishment | Accomplishment |
Ancestral File Number | Ancestral File Number |
Anecdote | Anecdote |
Association | Association |
Award | Award |
CENS | Census |
SLGC | Child Sealing (LDS) |
Church | Church |
Commemoration | Commemoration |
Comment | Comment |
CONL | Confirmation (LDS) |
Crime | Crime |
Custom event | Custom event |
Deed | Deed |
Degree | Degree |
Election | Election |
Employer | Employer |
ENDL | Endowment (LDS) |
Excommunication | Excommunication |
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 |
Hospitalization | Hospitalization |
Illegitimate | Illegitimate |
Illness | Illness |
Membership | Membership |
Miscarriage | Miscarriage |
Mission | Mission |
Move | Move |
Name Change | Name Change |
Passenger List | Passenger List |
Personality and Interests | Personality and Interests |
Politics | Politics |
PROB | Probate |
Rebellion | Rebellion |
RETI | Retirement |
Settlement | Settlement |
Twin | Twin |
WILL | Will |
Will Dated | Will Dated |
Will Proved | Will Proved |
Military Award | Military Award |
Military Discharge | Military Discharge |
Military Enlistment | Military Enlistment |
Military Promotion | Military Promotion |
Military Service | Military Service |
MYHERITAGE:LINEAGE | Lineage |
Circumcision | Circumcision |
MYHERITAGE:PIDYON_HABEN | Pidyon haben |
MYHERITAGE:ZEVED_HABAT | Zeved habat |
BASM | Bat Mitzvah |
BARM | Bar Mitzvah |
ANUL | Annulment |
TITL | Title |
CAST | Caste |
PROP | Property |
IDNO | ID Number |
SSN | Social Security Number |
Misc | Misc |
IMMI | Immigration |
NATU | Naturalization |
EMIG | Emigration |
GRAD | Graduation |
ORDN | Ordination |
FCOM | First Communion |
CONF | Confirmation |
Family Reunion | Family Reunion |
MYHERITAGE:HASSIDUT | Hassidism |
MYHERITAGE:BABY_NAMING | Baby naming |
NAMEDAY | Name day |
Activities | Activities |
BIRT | Birth |
Alternate Birth | Alternate Birth |
Favorite books | Favorite books |
Funeral | Funeral |
BURI | Burial |
Alternate Burial | Alternate Burial |
CREM | Cremation |
CHRA | Adult Christening |
BAPL | Baptism (LDS) |
BAPM | Baptism |
Alternate Baptism | Alternate Baptism |
CHR | Christening |
Alternate Christening | Alternate Christening |
DEAT | Death |
Alternate Death | Alternate Death |
DSCR | Description |
EDUC | Education |
Favorite food | Favorite food |
Idols | Idols |
Hobbies | Hobbies |
Language spoken | Language spoken |
Favorite music | Favorite music |
Favorite movies | Favorite movies |
Namesake | Named after |
NATI | Nationality |
OCCU | Occupation |
Political view | Political view |
Favorite quotes | Favorite quotes |
RELI | Religion |
RESI | Contact Info |
Favorite restaurants | Favorite restaurants |
Sports | Sports |
Favorite TV shows | Favorite TV shows |
Vacation spots | Vacation spots |
NMR | Known Number of Marriages |
NCHI | Known Number of Children |
Examples
Birth event
https://familygraph.myheritage.com/event-144530322-1000002 (open in browser){
"id": "event-144530322-1000002",
"event_type": "BIRT",
"title": "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"
},
"place": "Brookline, Massachusetts",
"link": "https:\/\/www.myheritage.com\/person-1000001_144530322_144530322\/john-fitzgerald-kennedy?show=events",
"data_language": "EN",
"individual": {
"id": "individual-144530322-1000001",
"name": "John Fitzgerald Kennedy"
},
"tree": {
"id": "tree-144530322-1",
"name": "jfk"
},
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"class_name": "Event"
}
Occupation event
https://familygraph.myheritage.com/event-144530322-1000004 (open in browser){
"id": "event-144530322-1000004",
"event_type": "OCCU",
"title": "Occupation",
"date": {
"gedcom": "Between 1953 and 1960",
"text": "Between 1953 and 1960",
"date": "1953",
"structured_date": {
"first_date": {
"year": 1953,
"type": "exact",
"class_name": "SingleDate"
},
"second_date": {
"year": 1960,
"type": "exact",
"class_name": "SingleDate"
},
"type": "between",
"class_name": "StructuredDate"
},
"class_name": "EventDate"
},
"header": "Senator of Massachusetts",
"link": "https:\/\/www.myheritage.com\/person-1000001_144530322_144530322\/john-fitzgerald-kennedy?show=events",
"data_language": "EN",
"individual": {
"id": "individual-144530322-1000001",
"name": "John Fitzgerald Kennedy"
},
"tree": {
"id": "tree-144530322-1",
"name": "jfk"
},
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"class_name": "Event"
}