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