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