Citation

A citation to a source as represented in the Family Graph API.

Information in a family tree can be cited to the source of the information. A family tree contains a list of sources. Each source can be used in citations that reference individuals, families, events and family events.


Fields

The Citation object contains the following fields:

Name Description Type Access Mode

id

The citation's id

id

read

page

The citation's page or url in the source

string

read

confidence

The citation's confidence

  • 0 - unspecified

  • 1 - unreliable evidence or estimated data

  • 2 - questionable reliability of evidence

  • 3 - secondary evidence

  • 4 - direct and primary evidence

int

read

date

The citation's date

EventDate object: gedcom, text, date, structured_date and class_name fields

read

text

The citation's text

string

read

link

Link to the individual or family this citation is referring to on MyHeritage.com

string

read

smart_matching_individual

The smart matching individual (used when the citation was created as a result of confirming a Smart Match)

Individual object: id and name fields

read

data_language

Language code for the data of the citation (ISO-639-1 code)

string

read

source

The source of the citation

Source object: id and name fields

read

item

The item that this citation refers to (individual, family, event or family event)

TreeItem object: id field

read

tree

The family tree that the citation belongs to

Tree object: id and name fields

read

site

The family site of the citation's tree

Site object: id and name fields

read

class_name

The object class name

string

read

Example

https://familygraph.myheritage.com/citation-144530322-1000002 (open in browser)
{
"id": "citation-144530322-1000002",
"page": "1",
"confidence": 4,
"text": "THE ASSASSINATION of John Fitzgerald Kennedy on November 22, 1963, was a cruel and shocking act of violence directed against a man, a family, a nation, and against all mankind. A young and vigorous leader whose years of public and private life stretched before him was the victim of the fourth Presidential assassination in the history of a country dedicated to the concepts of reasoned argument and peaceful political change. This Commission was created on November 29, 1963, in recognition of the right of people everywhere to full and truthful knowledge concerning these events. This report endeavors to fulfill that right and to appraise this tragedy by the light of reason and the standard of fairness. It has been prepared with a deep awareness of the Commission's responsibility to present to the American people an objective report of the facts relating to the assassination.",
"link": "https:\/\/www.myheritage.com\/person-1000001_144530322_144530322\/john-fitzgerald-kennedy?show=events",
"data_language": "EN",
"source": {
"id": "source-144530322-1000002",
"name": "Warren commission report"
},
"item": {
"id": "event-144530322-1000006"
},
"tree": {
"id": "tree-144530322-1",
"name": "jfk"
},
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"class_name": "Citation"
}