JSON Schema

Address

An Address.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
cityThe city.string
countryThe country.string
postalCodeThe postal code.string
stateOrProvinceThe state or province.string
streetThe street.string
street2Additional street information.string
street3Additional street information.string
street4Additional street information.string
street5Additional street information.string
street6Additional street information.string
valueThe value of the property, if it can be expressed as a string.string
extensionElement-object

Agent

An agent, e.g. person, organization, or group. In genealogical research, an agent often takes the role of a contributor.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
homepage-ResourceReference
openid-ResourceReference
person-ResourceReference
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
namesThe list of names for the agent.array ofTextValue
identifiersThe list of identifiers for the agent.array of string
accountsThe accounts that belong to this person or organization.array ofOnlineAccount
emailsThe emails that belong to this person or organization.array ofResourceReference
phonesThe phones that belong to this person or organization.array ofResourceReference
addressesThe addresses that belong to this person or organization.array ofAddress

ArtifactMetadata

FamilySearch-specific metadata about an artifact.

Type: object

NameDescriptionType
filenameThe original filename of the memories item.string
widthThe width of the artifact (presumably an image).
Format: int32
integer
heightThe height of the artifact (presumably an image).
Format: int32
integer
sizeThe size of the artifact.
Format: int64
integer
screeningStateThe screening state of the artifact.string
displayStateThe display state of the artifact.string
editableWhether or not the artifact is editable by the current user.boolean
qualifiersThe qualifiers associated with this artifact.array ofQualifier

Attribution

Attribution for genealogical information. Attribution is used to model who is contributing/modifying information, when they contributed it, and why they are making the contribution/modification.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
contributor-ResourceReference
creator-ResourceReference
modifiedThe modified timestamp for the attributed data.
Format: date-time
string
createdThe created timestamp for the attributed data.
Format: date-time
string
changeMessageThe "change message" for the attributed data provided by the contributor.string
changeMessageResourceA reference to the change message for the attributed data provided by the contributor.string
extensionElement-object

ChildAndParentsRelationship

The FamilySearch-proprietary model for a relationship between a child and a pair of parents.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
extractedWhether this subject has been identified as 'extracted', meaning it captures information extracted from a single source.boolean
mediaReferences to multimedia resources associated with this subject.array ofSourceReference
evidenceReferences to the evidence being referenced for this subject.array ofEvidenceReference
parent1-ResourceReference
parent2-ResourceReference
child-ResourceReference
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote
identifiersThe list of identifiers for the subject.array of string
parent1FactsThe fact conclusions for parent1.array ofFact
parent2FactsThe fact conclusions for parent2.array ofFact

CitationField

Represents a citation field -- its name and value.

Type: object

NameDescriptionType
nameThe citation field's name.string
valueThe citation field's value.string

Collection

A collection of genealogical resources.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of this description of the collection.string
contentDescriptions of the content of this collection.array ofCollectionContent
titleA title for the collection.string
sizeThe size of the collection, in terms of the number of items in this collection.
Format: int32
integer
attribution-Attribution
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
identifiersThe list of identifiers for the source.array of string

CollectionContent

A description of the content of a collection by resource type.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
resourceType-ResourceType
countThe count of the items applicable to this content aspect.
Format: int32
integer
completenessA completeness factor for this content; i.e. what percentage of the total number of items in the collection is included in this content aspect. The completeness factor is a value between 0 and 1.
Format: float
number
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink

Comment

A comment.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
textThe text of the comment.string
contributor-ResourceReference
createdThe date the comment was created.
Format: date-time
string
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink

ConfidenceLevel

The level of confidence the contributor has about the data.

Type: string

Enum Values:
- http://gedcomx.org/High
- http://gedcomx.org/Medium
- http://gedcomx.org/Low


Coverage

A description of the coverage of a resource.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
spatial-PlaceReference
temporal-Date
recordType-RecordType
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink

Date

A concluded genealogical date.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
originalThe original text as supplied by the user.string
formalThe standardized and/or normalized formal value.string
confidence-ConfidenceLevel
extensionElement-object
fields-array ofField
normalized-array ofTextValue

Discussion

A discussion.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
titleThe one-line summary or "subject" of the discussion.string
detailsThe detailed text of the discussion.string
contributor-ResourceReference
createdThe date the discussion was created.
Format: date-time
string
modifiedLast date of any change to comments or discussion details.
Format: date-time
string
numberOfCommentsThe number of comments associated with this discussion.
Format: int32
integer
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
commentsThe comments on this discussion.array ofComment

DisplayProperties

A set of display properties for the convenience of quick display, such as for a Web-based application. All display properties are provided in the default locale for the current application context and are NOT considered canonical for the purposes of data exchange.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
nameThe displayable name of the person.string
genderThe displayable label for the gender of the person.string
lifespanThe displayable label for the lifespan of the person.string
birthDateThe displayable label for the birth date of the person.string
birthPlaceThe displayable label for the birth place of the person.string
deathDateThe displayable label for the death date of the person.string
deathPlaceThe displayable label for the death place of the person.string
marriageDateThe displayable label for the marriage date of the person.string
marriagePlaceThe displayable label for the marriage place of the person.string
ascendancyNumberThe context-specific ascendancy number for the person in relation to the other persons in the request. The ancestry number is defined using the Ahnentafel numbering system.string
descendancyNumberThe context-specific descendancy number for the person in relation to the other persons in the request. The descendancy number is defined using the d'Aboville numbering system.string
relationshipDescriptionThe context-specific relationship description for the person in relation to the root person in the request.string
roleThe role of this person in the current display context.string
extensionElement-object
familiesAsParentThe family views where this person is a parent.array ofFamilyView
familiesAsChildThe family views where this person is a child.array ofFamilyView

Document

An abstract document that contains derived (conclusionary) text -- for example, a transcription or researcher analysis.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
extractedWhether this document has been identified as "extracted", meaning it captures information extracted from a single source.boolean
type-DocumentType
textTypeThe text type of the document.string
textThe document text.string
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote

DocumentType

DocumentType

Type: string

Enum Values:
- http://gedcomx.org/Abstract
- http://gedcomx.org/Translation
- http://gedcomx.org/Transcription
- http://gedcomx.org/Analysis


Event

A historical event.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
extractedWhether this subject has been identified as 'extracted', meaning it captures information extracted from a single source.boolean
mediaReferences to multimedia resources associated with this subject.array ofSourceReference
evidenceReferences to the evidence being referenced for this subject.array ofEvidenceReference
type-EventType
date-Date
place-PlaceReference
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote
identifiersThe list of identifiers for the subject.array of string
rolesThe roles played in this event.array ofEventRole

EventRole

A role that a specific person plays in an event.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
person-ResourceReference
type-EventRoleType
detailsDetails about the role of the person in the event.string
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote

EventRoleType

EventRoleType

Type: string

Enum Values:
- http://gedcomx.org/Principal
- http://gedcomx.org/Participant
- http://gedcomx.org/Official
- http://gedcomx.org/Witness


EventType

EventType

Type: string

Enum Values:
- http://gedcomx.org/Adoption
- http://gedcomx.org/AdultChristening
- http://gedcomx.org/Annulment
- http://gedcomx.org/Baptism
- http://gedcomx.org/BarMitzvah
- http://gedcomx.org/BatMitzvah
- http://gedcomx.org/Birth
- http://gedcomx.org/Blessing
- http://gedcomx.org/Burial
- http://gedcomx.org/Census
- http://gedcomx.org/Christening
- http://gedcomx.org/Circumcision
- http://gedcomx.org/Confirmation
- http://gedcomx.org/Cremation
- http://gedcomx.org/Death
- http://gedcomx.org/Divorce
- http://gedcomx.org/DivorceFiling
- http://gedcomx.org/Education
- http://gedcomx.org/Engagement
- http://gedcomx.org/Emigration
- http://gedcomx.org/Enslavement
- http://gedcomx.org/Excommunication
- http://gedcomx.org/FirstCommunion
- http://gedcomx.org/Funeral
- http://gedcomx.org/Immigration
- http://gedcomx.org/Inquest
- http://gedcomx.org/LandTransaction
- http://gedcomx.org/Marriage
- http://gedcomx.org/MilitaryAward
- http://gedcomx.org/MilitaryDischarge
- http://gedcomx.org/Mission
- http://gedcomx.org/MoveFrom
- http://gedcomx.org/MoveTo
- http://gedcomx.org/Naturalization
- http://gedcomx.org/Ordination
- http://gedcomx.org/Retirement


EvidenceReference

A reference to a resource that is being used as evidence.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
resourceThe URI to the resource being referenced as evidence.string
resourceIdThe resource id of the resource being referenced. Used as an extension attribute when resolving the resource is inconvenient.string
attribution-Attribution
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink

Fact

A conclusion about a fact applicable to a person or relationship.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
type-FactType
date-Date
place-PlaceReference
valueThe value as supplied by the user.string
primaryIndicator of whether this fact is the "primary" fact of the record from which the subject was extracted. Applicable only to extracted persons/relationships. The meaning of this flag outside the scope of an extracted subject is undefined.boolean
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote
qualifiersThe qualifiers associated with this fact.array ofQualifier
fields-array ofField

FactType

FactType

Type: string

Enum Values:
- http://gedcomx.org/Adoption
- http://gedcomx.org/AdultChristening
- http://gedcomx.org/Amnesty
- http://gedcomx.org/Apprenticeship
- http://gedcomx.org/Arrest
- http://gedcomx.org/Award
- http://gedcomx.org/Baptism
- http://gedcomx.org/BarMitzvah
- http://gedcomx.org/BatMitzvah
- http://gedcomx.org/Birth
- http://gedcomx.org/BirthNotice
- http://gedcomx.org/Blessing
- http://gedcomx.org/Branch
- http://gedcomx.org/Burial
- http://gedcomx.org/Caste
- http://gedcomx.org/Census
- http://gedcomx.org/Christening
- http://gedcomx.org/Circumcision
- http://gedcomx.org/Clan
- http://gedcomx.org/Confirmation
- http://gedcomx.org/Court
- http://gedcomx.org/Cremation
- http://gedcomx.org/Death
- http://gedcomx.org/Education
- http://gedcomx.org/EducationEnrollment
- http://gedcomx.org/Emigration
- http://gedcomx.org/Enslavement
- http://gedcomx.org/Ethnicity
- http://gedcomx.org/Excommunication
- http://gedcomx.org/FirstCommunion
- http://gedcomx.org/Funeral
- http://gedcomx.org/GenderChange
- http://gedcomx.org/Graduation
- http://gedcomx.org/Heimat
- http://gedcomx.org/Immigration
- http://gedcomx.org/Imprisonment
- http://gedcomx.org/Inquest
- http://gedcomx.org/LandTransaction
- http://gedcomx.org/Language
- http://gedcomx.org/Living
- http://gedcomx.org/MaritalStatus
- http://gedcomx.org/Medical
- http://gedcomx.org/MilitaryAward
- http://gedcomx.org/MilitaryDischarge
- http://gedcomx.org/MilitaryDraftRegistration
- http://gedcomx.org/MilitaryInduction
- http://gedcomx.org/MilitaryService
- http://gedcomx.org/Mission
- http://gedcomx.org/MoveFrom
- http://gedcomx.org/MoveTo
- http://gedcomx.org/MultipleBirth
- http://gedcomx.org/NationalId
- http://gedcomx.org/Nationality
- http://gedcomx.org/Naturalization
- http://gedcomx.org/NumberOfMarriages
- http://gedcomx.org/Obituary
- http://gedcomx.org/Occupation
- http://gedcomx.org/Ordination
- http://gedcomx.org/Pardon
- http://gedcomx.org/PhysicalDescription
- http://gedcomx.org/Probate
- http://gedcomx.org/Property
- http://gedcomx.org/Race
- http://gedcomx.org/Religion
- http://gedcomx.org/Residence
- http://gedcomx.org/Retirement
- http://gedcomx.org/Stillbirth
- http://gedcomx.org/TaxAssessment
- http://gedcomx.org/Tribe
- http://gedcomx.org/Will
- http://gedcomx.org/Visit
- http://gedcomx.org/Yahrzeit
- http://gedcomx.org/Annulment
- http://gedcomx.org/CommonLawMarriage
- http://gedcomx.org/CivilUnion
- http://gedcomx.org/Divorce
- http://gedcomx.org/DivorceFiling
- http://gedcomx.org/DomesticPartnership
- http://gedcomx.org/Engagement
- http://gedcomx.org/Marriage
- http://gedcomx.org/MarriageBanns
- http://gedcomx.org/MarriageContract
- http://gedcomx.org/MarriageLicense
- http://gedcomx.org/MarriageNotice
- http://gedcomx.org/NumberOfChildren
- http://gedcomx.org/Separation
- http://gedcomx.org/AdoptiveParent
- http://gedcomx.org/BiologicalParent
- http://gedcomx.org/FosterParent
- http://gedcomx.org/GuardianParent
- http://gedcomx.org/StepParent
- http://gedcomx.org/SociologicalParent
- http://gedcomx.org/SurrogateParent


FamilySearchPlatform

The FamilySearch data types define serialization formats that are specific to the FamilySearch developer platform. These data formats are extensions of the GEDCOM X media types and provide concepts and data types that are specific to FamilySearch and therefore haven't been adopted into a formal, more general specification.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of this genealogical data set. See http://www.w3.org/International/articles/language-tags/. Note that some language-enabled elements MAY override the language.string
attribution-Attribution
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
descriptionA reference to a description of this data set.string
personsThe persons included in this genealogical data set.array ofPerson
relationshipsThe relationships included in this genealogical data set.array ofRelationship
sourceDescriptionsThe descriptions of sources included in this genealogical data set.array ofSourceDescription
agentsThe agents included in this genealogical data set.array ofAgent
eventsThe events included in this genealogical data set.array ofEvent
placesThe places included in this genealogical data set.array ofPlaceDescription
documentsThe documents included in this genealogical data set.array ofDocument
collectionsThe collections included in this genealogical data set.array ofCollection
fields-array ofField
recordDescriptorsThe record descriptors included in this genealogical data set.array ofRecordDescriptor
mergeAnalysesThe merge analysis results for this data set.array ofMergeAnalysis
mergesThe merges for this data set.array ofMerge
childAndParentsRelationshipsThe child-and-parents relationships.array ofChildAndParentsRelationship
discussionsThe discussions included in this data set.array ofDiscussion
groupsThe groups included in this data set.array ofGroup
treesThe trees included in this data set.array ofTree
usersThe users included in this data set.array ofUser
featuresThe set of features defined in the platform API.array ofFeature
vocabConceptsThe vocabulary concepts included in this data set.array ofVocabConcept

FamilyView

A family view, meaning up to two parents and a list of children who have those parents in common. Relationships carry the canonical information for this view, and the relationships must be used to get Facts (lineage types, marriages, etc.) about the relationships covered by a Family. The Family data type provides a convenient way to see the typical family views without having to do the calculations to derive them. There should only be one family for each unique set of parents, and only one for each single-parent family with a particular parent.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
parent1-ResourceReference
parent2-ResourceReference
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
childrenA list of references to the children of this family.array ofResourceReference

Feature

A description of a FamilySearch feature.

Type: object

NameDescriptionType
nameThe name of the feature.string
descriptionA description of the feature.string
enabledTrue if the feature is enabled for the current request: false otherwise.boolean
activationDateThe date that this feature is scheduled to be enabled permanently.
Format: date-time
string

Field

A field of a record.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
type-FieldType
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote
valuesThe set of values for the field.array ofFieldValue

FieldDescriptor

A description of a field in a record.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
originalLabelThe original label for the field, as stated on the original record.string
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
descriptionsLocalized description of this field.array ofTextValue
valuesLocalized display labels for the field values.array ofFieldValueDescriptor

FieldType

FieldType

Type: string

Enum Values:
- http://gedcomx.org/Age
- http://gedcomx.org/Date
- http://gedcomx.org/Place
- http://gedcomx.org/Gender
- http://gedcomx.org/Name
- http://gedcomx.org/Role
- http://gedcomx.org/Years
- http://gedcomx.org/Months
- http://gedcomx.org/Days
- http://gedcomx.org/Hours
- http://gedcomx.org/Minutes
- http://gedcomx.org/Year
- http://gedcomx.org/Month
- http://gedcomx.org/Day
- http://gedcomx.org/Hour
- http://gedcomx.org/Minute
- http://gedcomx.org/Address
- http://gedcomx.org/Cemetery
- http://gedcomx.org/City
- http://gedcomx.org/Church
- http://gedcomx.org/County
- http://gedcomx.org/Country
- http://gedcomx.org/District
- http://gedcomx.org/Hospital
- http://gedcomx.org/Island
- http://gedcomx.org/MilitaryBase
- http://gedcomx.org/Mortuary
- http://gedcomx.org/Parish
- http://gedcomx.org/PlotNumber
- http://gedcomx.org/PostOffice
- http://gedcomx.org/PostalCode
- http://gedcomx.org/Prison
- http://gedcomx.org/Province
- http://gedcomx.org/Section
- http://gedcomx.org/Ship
- http://gedcomx.org/State
- http://gedcomx.org/Territory
- http://gedcomx.org/Town
- http://gedcomx.org/Township
- http://gedcomx.org/Ward
- http://gedcomx.org/Prefix
- http://gedcomx.org/Suffix
- http://gedcomx.org/Given
- http://gedcomx.org/Surname
- http://gedcomx.org/Abusua
- http://gedcomx.org/BatchNumber
- http://gedcomx.org/Caste
- http://gedcomx.org/Clan
- http://gedcomx.org/CommonLawMarriage
- http://gedcomx.org/Education
- http://gedcomx.org/Ethnicity
- http://gedcomx.org/FatherBirthPlace
- http://gedcomx.org/NeverHadChildren
- http://gedcomx.org/NeverMarried
- http://gedcomx.org/NumberOfChildren
- http://gedcomx.org/NumberOfMarriages
- http://gedcomx.org/Household
- http://gedcomx.org/IsHeadOfHousehold
- http://gedcomx.org/MaritalStatus
- http://gedcomx.org/MotherBirthPlace
- http://gedcomx.org/MultipleBirth
- http://gedcomx.org/NameSake
- http://gedcomx.org/NationalId
- http://gedcomx.org/Nationality
- http://gedcomx.org/Occupation
- http://gedcomx.org/PhysicalDescription
- http://gedcomx.org/Property
- http://gedcomx.org/Race
- http://gedcomx.org/Religion
- http://gedcomx.org/RelationshipToHead
- http://gedcomx.org/Stillbirth
- http://gedcomx.org/TitleOfNobility
- http://gedcomx.org/Tribe


FieldValue

An element representing a value in a record field.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
type-FieldValueType
labelIdThe id of the label applicable to this field value.string
textThe text value.string
datatypeThe datatype of the text value of the field.string
resourceURI that resolves to the value of the field.string
status-FieldValueStatusType
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote

FieldValueDescriptor

A way a field is to be displayed to a user.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
labelIdThe id of the label applicable to the field value.string
typeThe type of the field value.string
optionalWhether the treatment of the field value is optional. Used to determine whether it should be displayed even if the value is empty.boolean
displaySortKeyA sort key for sorting this field value relative to other field values according to how they should be displayed for viewing.string
entrySortKeyA sort key for sorting this field value relative to other field values according to how they should be entered for editing.string
entryRequiredWhether some kind of entry is required when entering data for editing.boolean
editableWhether the field value is editable. Some field values might be composed from other field values or otherwise calculated by the system.boolean
parentLabelIdThe id of the label for the "parent" field value. For example, the parent field value of a "given name" field value might be the "name" field value.string
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
labelsThe labels to be used for display purposes.array ofTextValue
entryLabelsThe labels to be used for entry purposes.array ofTextValue

FieldValueStatusType

FieldValueStatusType

Type: string

Enum Values:
- http://gedcomx.org/Blank
- http://gedcomx.org/Unreadable


FieldValueType

FieldValueType

Type: string

Enum Values:
- http://gedcomx.org/Original
- http://gedcomx.org/Interpreted


Gedcomx

The GEDCOM X data formats define the serialization formats of the GEDCOM X conceptual model.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of this genealogical data set. See http://www.w3.org/International/articles/language-tags/. Note that some language-enabled elements MAY override the language.string
attribution-Attribution
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
descriptionA reference to a description of this data set.string
personsThe persons included in this genealogical data set.array ofPerson
relationshipsThe relationships included in this genealogical data set.array ofRelationship
sourceDescriptionsThe descriptions of sources included in this genealogical data set.array ofSourceDescription
agentsThe agents included in this genealogical data set.array ofAgent
eventsThe events included in this genealogical data set.array ofEvent
placesThe places included in this genealogical data set.array ofPlaceDescription
documentsThe documents included in this genealogical data set.array ofDocument
collectionsThe collections included in this genealogical data set.array ofCollection
fields-array ofField
recordDescriptorsThe record descriptors included in this genealogical data set.array ofRecordDescriptor

Gender

A gender conclusion.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
type-GenderType
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote
fields-array ofField

GenderType

GenderType

Type: string

Enum Values:
- http://gedcomx.org/Male
- http://gedcomx.org/Female
- http://gedcomx.org/Unknown


Group

The Group

Type: object

NameDescriptionType
idThe group id.string
nameThe group name.string
descriptionThe group description.string
codeOfConductThe group code of conduct.string
treeIdsThe ids of the trees associated with the group.array of string
membersThe members of the group.array ofGroupMember

GroupMember

A Member of a Group

Type: object

NameDescriptionType
groupIdThe id of the group.string
cisIdThe cisId of the group member.string
contactNameThe contact name of the group member.string
statusThe status of the group member.string

InputStreamResource

Type: object

NameDescriptionType
description-string
open-boolean
inputStream-object
file-
Format: binary
string
readable-boolean
url-
Format: url
string
uri-
Format: uri
string
filename-string
contentAsByteArray-
Format: byte
string

Link

A link.

Type: object

NameDescriptionType
hrefThe target URI of the link.string
templateA URI template per RFC 6570, used to link to a range of URIs, such as for the purpose of linking to a query.string
typeMetadata about the available media type(s) of the resource being linked to. The value of the "type" attribute is as defined by the HTTP specification, RFC 2616, Section 3.7. Note that this attribute can be considered an "Update Control (CU)" per Amundsen, M. (2011). Hypermedia APIs with HTML5 and Node. O'Reilly.string
acceptMetadata about the available media type(s) of the resource being linked to update (i.e. change the state of) the resource being linked to. The value of the "accept" attribute is as defined by the HTTP specification, RFC 2616, Section 3.7. Note that this attribute can be considered an "Read Control (CR)" per Amundsen, M. (2011). Hypermedia APIs with HTML5 and Node. O'Reilly.string
allowMetadata about the allowable methods that can be used to transition to the resource being linked. The value of the "allow" attribute is as defined by the HTTP specification, RFC 2616, Section 14.7. Note that this attribute can be considered an "Method Control (CM)" per Amundsen, M. (2011). Hypermedia APIs with HTML5 and Node. O'Reilly.string
hreflangThe language of the resource being linked to. Note that this attribute can be considered an "Update Control (CU)" per Amundsen, M. (2011). Hypermedia APIs with HTML5 and Node. O'Reilly.string
titleHuman-readable information about the link.string
countThe number of elements in the page, if this link refers to a page of resources.
Format: int32
integer
offsetThe index of the offset of the page, if this link refers to a page of resources.
Format: int32
integer
resultsThe total number of results in the page to which this links, if this link refers to a page of resources.
Format: int32
integer

MediaType

Type: object

NameDescriptionType
type-string
subtype-string
parameters-object
qualityValue-
Format: double
number
wildcardSubtype-boolean
subtypeSuffix-string
charset-object
concrete-boolean
wildcardType-boolean

MemoriesArtifactItem

Type: object

NameDescriptionType
artifact-object
description-SourceDescription
personas-array ofMemoriesPersona
metadata-ArtifactMetadata

MemoriesPersona

Type: object

NameDescriptionType
tags-array ofMemoriesTag
person-Person

MemoriesTag

Type: object

NameDescriptionType
id-string
title-string
x-
Format: float
number
y-
Format: float
number
width-
Format: float
number
height-
Format: float
number

Merge

A merge.

Type: object

NameDescriptionType
resourcesToDeleteList of resources to remove from the survivor person.array ofResourceReference
resourcesToCopyList of resources to copy from the duplicate person to survivor person.array ofResourceReference

MergeAnalysis

A merge analysis.

Type: object

NameDescriptionType
survivorResourcesList of survivor resources.array ofResourceReference
duplicateResourcesList of duplicate resources.array ofResourceReference
conflictingResourcesList of resources that are in conflict.array ofMergeConflict
survivor-ResourceReference
duplicate-ResourceReference

MergeConflict

A merge conflict.

Type: object

NameDescriptionType
survivorResource-ResourceReference
duplicateResource-ResourceReference

Name

A name conclusion.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
type-NameType
date-Date
preferredWhether the conclusion is preferred above other conclusions of the same type. Useful, for example, for display purposes.boolean
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote
nameFormsAlternate forms of the name, such as the romanized form of a non-latin name.array ofNameForm

NameForm

A form of a name.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
fullTextThe full text of the name form.string
extensionElement-object
partsThe different parts of the name form.array ofNamePart
fields-array ofField

NamePart

A part of a name.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
type-NamePartType
valueThe value of the name part.string
extensionElement-object
qualifiersThe qualifiers associated with this name part.array ofQualifier
fields-array ofField

NamePartType

NamePartType

Type: string

Enum Values:
- http://gedcomx.org/Prefix
- http://gedcomx.org/Suffix
- http://gedcomx.org/Given
- http://gedcomx.org/Surname


NameType

NameType

Type: string

Enum Values:
- http://gedcomx.org/BirthName
- http://gedcomx.org/DeathName
- http://gedcomx.org/MarriedName
- http://gedcomx.org/AlsoKnownAs
- http://gedcomx.org/Nickname
- http://gedcomx.org/AdoptiveName
- http://gedcomx.org/FormalName
- http://gedcomx.org/ReligiousName


Note

A note about a genealogical resource (e.g. conclusion or source).

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the note. See http://www.w3.org/International/articles/language-tags/string
subjectThe subject of the note. This is a short title describing the contents of the note text.string
textThe text of the note.string
attribution-Attribution
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink

OnlineAccount

An online account for a web application.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
serviceHomepage-ResourceReference
accountNameThe name associated the holder of this account with the account.string
extensionElement-object

Person

A person.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
extractedWhether this subject has been identified as 'extracted', meaning it captures information extracted from a single source.boolean
mediaReferences to multimedia resources associated with this subject.array ofSourceReference
evidenceReferences to the evidence being referenced for this subject.array ofEvidenceReference
livingLiving status of the person as treated by the system. The value of this property is intended to be based on a system-specific calculation and therefore has limited portability. Conclusions about the living status of a person can be modeled with a fact.boolean
principalIndicator of whether this person is the 'principal' person extracted from the record. Applicable only to extracted persons. The meaning of this flag outside the scope of an extracted person is undefined.boolean
gender-Gender
private-boolean
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote
identifiersThe list of identifiers for the subject.array of string
namesThe name conclusions for the person.array ofName
factsThe fact conclusions for the person.array ofFact
fields-array ofField
display-DisplayProperties

PlaceAttribute

Type: object

NameDescriptionType
attributeId-string
typeName-string
typeId-string
descriptionId-string
value-string
year-
Format: int32
integer
locale-string

PlaceDescription

A PlaceDescription is used to describe the details of a place in terms of its name and possibly its type, time period, and/or a geospatial description -- a description of a place as a snapshot in time.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
extractedWhether this subject has been identified as 'extracted', meaning it captures information extracted from a single source.boolean
mediaReferences to multimedia resources associated with this subject.array ofSourceReference
evidenceReferences to the evidence being referenced for this subject.array ofEvidenceReference
typeAn implementation-specific uniform resource identifier (URI) used to identify the type of a place (e.g., address, city, county, province, state, country, etc.).string
temporalDescription-Date
latitudeDegrees north or south of the Equator (0.0 degrees). Values range from −90.0 degrees (south) to 90.0 degrees (north).
Format: double
number
longitudeAngular distance in degrees, relative to the Prime Meridian. Values range from −180.0 degrees (west of the Meridian) to 180.0 degrees (east of the Meridian).
Format: double
number
place-ResourceReference
spatialDescription-ResourceReference
jurisdiction-ResourceReference
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote
identifiersThe list of identifiers for the subject.array of string
namesAn ordered list of standardized (or normalized), fully-qualified (in terms of what is known of the applicable jurisdictional hierarchy) names for this place that are applicable to this description of this place. The list MUST include at least one value. It is RECOMMENDED that instances include a single name and any equivalents from other cultural contexts; name variants should more typically be described in separate PlaceDescription instances. The list is assumed to be given in order of preference, with the most preferred value in the first position in the list.array ofTextValue
display-PlaceDisplayProperties

PlaceDisplayProperties

A set of display properties for places for the convenience of quick display, such as for a Web-based application. All display properties are provided in the default locale for the current application context and are NOT considered canonical for the purposes of data exchange.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
nameThe displayable name of the place.string
fullNameThe displayable full name of the place.string
typeThe displayable type of the place.string
extensionElement-object

PlaceReference

A reference to genealogical place.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
originalThe original value as supplied by the user.string
confidence-ConfidenceLevel
extensionElement-object
descriptionA reference to a description of the place being referenced.string
fields-array ofField
normalized-array ofTextValue

Qualifier

A data qualifier. Qualifiers are used to "qualify" certain data elements to provide additional context, information, or details.

Type: object

NameDescriptionType
valueThe value of the qualifier. Some qualifiers may not have values, indicating that the qualifier is to be treated more like a "tag".string
nameThe name of the qualifier. The name should be an element of a constrained vocabulary and is used to determine meaning of the qualifier.string

RecordDescriptor

A descriptor for a common set of records.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of this record description.string
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
fieldsDescriptors of the fields that are applicable to this record.array ofFieldDescriptor

RecordType

RecordType

Type: string

Enum Values:
- http://gedcomx.org/Admission
- http://gedcomx.org/Adoption
- http://gedcomx.org/Affidavit
- http://gedcomx.org/Application
- http://gedcomx.org/Arrival
- http://gedcomx.org/Bank
- http://gedcomx.org/Baptism
- http://gedcomx.org/Birth
- http://gedcomx.org/Burial
- http://gedcomx.org/Business
- http://gedcomx.org/Cemetery
- http://gedcomx.org/Census
- http://gedcomx.org/Christening
- http://gedcomx.org/CompiledGenealogy
- http://gedcomx.org/Confirmation
- http://gedcomx.org/Correspondence
- http://gedcomx.org/Death
- http://gedcomx.org/Departure
- http://gedcomx.org/Divorce
- http://gedcomx.org/Duplicate
- http://gedcomx.org/Draft
- http://gedcomx.org/Estate
- http://gedcomx.org/Index
- http://gedcomx.org/IntendedMarriage
- http://gedcomx.org/Land
- http://gedcomx.org/Legal
- http://gedcomx.org/Marriage
- http://gedcomx.org/MarriageAffidavit
- http://gedcomx.org/MarriageAmendment
- http://gedcomx.org/MarriageBanns
- http://gedcomx.org/MarriageConsent
- http://gedcomx.org/MarriageDuplicate
- http://gedcomx.org/MarriageLicense
- http://gedcomx.org/MarriageReturns
- http://gedcomx.org/Membership
- http://gedcomx.org/Migration
- http://gedcomx.org/Military
- http://gedcomx.org/Naturalization
- http://gedcomx.org/Newspaper
- http://gedcomx.org/Obituary
- http://gedcomx.org/Passenger
- http://gedcomx.org/Pension
- http://gedcomx.org/Probate
- http://gedcomx.org/RelatedDocument
- http://gedcomx.org/ReligiousCreeds
- http://gedcomx.org/Residence
- http://gedcomx.org/Roll
- http://gedcomx.org/Tax
- http://gedcomx.org/Vital
- http://gedcomx.org/VoterRegistration
- http://gedcomx.org/Will


Relationship

A relationship between two or more persons.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the conclusion. See http://www.w3.org/International/articles/language-tags/string
confidence-ConfidenceLevel
attribution-Attribution
analysis-ResourceReference
sortKeyA sort key in relation to other facts for display purposes.string
extractedWhether this subject has been identified as 'extracted', meaning it captures information extracted from a single source.boolean
mediaReferences to multimedia resources associated with this subject.array ofSourceReference
evidenceReferences to the evidence being referenced for this subject.array ofEvidenceReference
type-RelationshipType
person1-ResourceReference
person2-ResourceReference
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
sourcesThe source references for a conclusion.array ofSourceReference
notesNotes about a person.array ofNote
identifiersThe list of identifiers for the subject.array of string
factsThe fact conclusions for the relationship.array ofFact
fields-array ofField

RelationshipType

RelationshipType

Type: string

Enum Values:
- http://gedcomx.org/AncestorDescendant
- http://gedcomx.org/Couple
- http://gedcomx.org/EnslavedBy
- http://gedcomx.org/Godparent
- http://gedcomx.org/ParentChild


ResourceReference

A generic reference to a resource.

Type: object

NameDescriptionType
resourceThe URI to the resource. For more information, see Architecture of the World Wide Web, Volume One, Section 2string
resourceIdThe resource id of the resource being referenced. Used as an extension attribute when resolving the resource is inconvenient.string

ResourceType

ResourceType

Type: string

Enum Values:
- http://gedcomx.org/Record
- http://gedcomx.org/Collection
- http://gedcomx.org/DigitalArtifact
- http://gedcomx.org/PhysicalArtifact
- http://gedcomx.org/Person


SourceCitation

Represents a source citation.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of the citation. See http://www.w3.org/International/articles/language-tags/string
valueA rendering (as a string) of a source citation. This rendering should be the most complete rendering available.string
citationTemplate-ResourceReference
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
fieldsThe list of citation fields.array ofCitationField

SourceDescription

Represents a description of a source.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
langThe language of this genealogical data set. See http://www.w3.org/International/articles/language-tags/. Note that some language-enabled elements MAY override the language.string
mediaTypeHint about the media (MIME) type of the resource being described.string
aboutThe URI (if applicable) of the actual source.string
mediator-ResourceReference
publisher-ResourceReference
analysis-ResourceReference
componentOf-SourceReference
titleLabel-TextValue
attribution-Attribution
resourceType-ResourceType
sortKey-string
created-
Format: date-time
string
modified-
Format: date-time
string
coverage-array ofCoverage
repository-ResourceReference
replacedBy-string
versionGets the version of this resourcestring
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
citationsThe bibliographic citation for this source.array ofSourceCitation
authorsThe authors for this source.array of string
sourcesReferences to any sources to which this source is related (usually applicable to sources that are derived from or contained in another source).array ofSourceReference
titlesA list of titles for this source.array ofTextValue
notesNotes about a source.array ofNote
rightsThe rights for this source.array of string
descriptionsA list of descriptions for this source.array ofTextValue
identifiersThe list of identifiers for the agent.array of string
fields-array ofField
descriptor-ResourceReference
replaces-array of string
statusesThe status of this source description.array of string

SourceReference

An attributable reference to a description of a source.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
attribution-Attribution
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink
descriptionA reference to a description of the source being referenced.string
descriptionIdId of the source being referenced.string
qualifiersThe qualifiers associated with this source reference.array ofQualifier

TextValue

An element representing a text value that may be in a specific language.

Type: object

NameDescriptionType
langThe language of the text value. See http://www.w3.org/International/articles/language-tags/string
valueThe text value.string

Tree

A tree.

Type: object

NameDescriptionType
idThe tree id.string
groupIdsThe ids of the groups this tree belongs to.array of string
nameThe tree name.string
descriptionThe tree description.string
startingPersonIdThe tree starting person id.string
hiddenThe hidden state of the tree.boolean
collectionIdThe id of the collection the tree belongs to.string
ownerAccessThe owner third party access state of the tree.
Enum values: AnyApps, CompanyApps, None, OTHER
string
groupAccessThe group third party access state of the tree.
Enum values: AnyApps, CompanyApps, None, OTHER
string
private-boolean

User

Family Tree User Service User

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
contactNameThe contact name of the user.string
helperAccessPinThe helper access pin of the user.string
fullNameThe full name of the user.string
givenNameThe given name of the user.string
familyNameThe family name of the user.string
emailThe email of the user.string
alternateEmailThe alternate email of the user.string
countryThe country of the user.string
genderThe gender of the user.string
birthDateThe birth date of the user.string
phoneNumberThe phone number of the user.string
mobilePhoneNumberThe mobile phone number of the user.string
mailingAddressThe mailing address of the user.string
preferredLanguageThe preferred language of the user.string
displayNameThe display name of the user.string
personIdThe person id of the user.string
treeUserIdThe tree user id of the user.string
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink

VocabConcept

A vocabulary concept.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
descriptionThe vocabulary concept description.string
noteThe vocabulary concept note.string
gedcomxUriThe Gedcomx URI associated with the concept.string
vocabTermsThe terms associated with the concept.array ofVocabTerm
attributesThe attributes associated with the concept.array ofVocabConceptAttribute
definitionsThe definitions associated with the concept.array ofTextValue
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink

VocabConceptAttribute

A vocabulary concept attribute.

Type: object

NameDescriptionType
idThe vocabulary concept attribute id.string
nameThe vocabulary concept attribute name.string
valueThe vocabulary concept attribute value.string

VocabConcepts

A list of vocabulary concepts.

Type: object

NameDescriptionType
vocabConceptsThe list of vocabulary concepts.array ofVocabConcept

VocabElement

Representation of a vocabulary element

Type: object

NameDescriptionType
idThe id of the element.string
uriThe URI of the element.string
subclassThe subclass of the element.string
typeThe type of the element.string
labelsThe labels of the element.array ofTextValue
descriptionsThe descriptions of the element.array ofTextValue
sublistThe sublist of the element.string
position-
Format: int32
integer
sortName-string

VocabElementList

Representation of a list of VocabElement objects

Type: object

NameDescriptionType
titleThe title of the list of elements.string
descriptionThe description of the list of elements.string
uriThe URI of the list of elements.string
idThe id of the list of elements.string
elementsThe list of elements.array ofVocabElement

VocabTerm

A vocabulary term.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
typeUriThe vocabulary term type.string
sublistUriThe URI of the sublist this vocabulary term is associated with.string
sublistPositionThe position of this vocabulary term within it's associated sublist.
Format: int32
integer
valuesThe values of the vocabulary term.array ofTextValue
vocabConceptUri-string
vocabConcept-string
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink

VocabTranslation

A vocabulary translation.

Type: object

NameDescriptionType
idA local, context-specific id for the data.string
text-string
lang-string
extensionElement-object
linksThe list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.array ofLink