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"
}