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