JSON

Gedcomx (XML)

The GEDCOM X data formats define the serialization formats of the GEDCOM X conceptual model. The canonical documentation is provided by the formal specification documents:

This documentation is provided as a non-normative reference guide.

Namespace:http://gedcomx.org/v1/
URI:http://gedcomx.org/v1/Gedcomx
Extends:HypermediaEnabledData

Attributes

Name Type Description
lang string The 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.
description string A reference to a description of this data set. FTU
profile string A reference to the profile that describes this data set.
Attributes inherited from ExtensibleData
id string A local, context-specific id for the data.

Elements

Name Type Occurs Description
attribution Attribution 0..1 The attribution of this genealogical data.
person Person 0..* The persons included in this genealogical data set.
relationship Relationship 0..* The relationships included in this genealogical data set.
sourceDescription SourceDescription 0..* The descriptions of sources included in this genealogical data set.
agent Agent 0..* The agents included in this genealogical data set.
event Event 0..* The events included in this genealogical data set.
place PlaceDescription 0..* The places included in this genealogical data set.
document Document 0..* The documents included in this genealogical data set.
collection Collection 0..* The collections included in this genealogical data set. FTU
field Field 0..* The extracted fields included in this genealogical data set. Fields that apply to a particular person, relationship or value should be included within that person or value, respectively. Remaining fields that did not have a place within the person or relationship structure can be included here. Also, fields that were extracted but not yet fit into a structure can also be included here. FTU
recordDescriptor RecordDescriptor 0..* The record descriptors included in this genealogical data set. FTU
Elements inherited from HypermediaEnabledData
link Link 0..* The list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.

Example

<?xml version="1.0" encoding="UTF-8"?>
<Gedcomx xmlns="http://gedcomx.org/v1/" id="..." xml:lang="..." description="..." profile="...">
  <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
  <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
    <!--...-->
  </link>
  <!--...more "link" elements...-->
  <attribution id="...">
    <contributor resourceId="..." resource="..." />
    <modified>...</modified>
    <changeMessage>...</changeMessage>
  </attribution>
  <person id="..." confidence="..." sortKey="..." xml:lang="..." extracted="..." principal="..." private="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <attribution id="..." />
    <source id="..." description="..." />
    <source description="...">
      <!--...-->
    </source>
    <!--...more "source" elements...-->
    <analysis resourceId="..." resource="..." />
    <note id="..." xml:lang="..." />
    <note xml:lang="...">
      <!--...-->
    </note>
    <!--...more "note" elements...-->
    <evidence id="..." resourceId="..." resource="..." />
    <evidence resourceId="..." resource="...">
      <!--...-->
    </evidence>
    <!--...more "evidence" elements...-->
    <media id="..." description="..." />
    <media description="...">
      <!--...-->
    </media>
    <!--...more "media" elements...-->
    <identifier type="...">...</identifier>
    <identifier type="...">...</identifier>
    <!--...more "identifier" elements...-->
    <living>...</living>
    <gender id="..." confidence="..." sortKey="..." xml:lang="..." type="..." />
    <name id="..." confidence="..." sortKey="..." xml:lang="..." type="..." />
    <name type="...">
      <!--...-->
    </name>
    <!--...more "name" elements...-->
    <fact id="..." confidence="..." sortKey="..." xml:lang="..." primary="..." type="..." />
    <fact primary="..." type="...">
      <!--...-->
    </fact>
    <!--...more "fact" elements...-->
    <field id="..." type="..." />
    <field type="...">
      <!--...-->
    </field>
    <!--...more "field" elements...-->
    <display id="..." />
  </person>
  <person principal="..." private="...">
    <!--...-->
  </person>
  <!--...more "person" elements...-->
  <relationship id="..." confidence="..." sortKey="..." xml:lang="..." extracted="..." type="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <attribution id="..." />
    <source id="..." description="..." />
    <source description="...">
      <!--...-->
    </source>
    <!--...more "source" elements...-->
    <analysis resourceId="..." resource="..." />
    <note id="..." xml:lang="..." />
    <note xml:lang="...">
      <!--...-->
    </note>
    <!--...more "note" elements...-->
    <evidence id="..." resourceId="..." resource="..." />
    <evidence resourceId="..." resource="...">
      <!--...-->
    </evidence>
    <!--...more "evidence" elements...-->
    <media id="..." description="..." />
    <media description="...">
      <!--...-->
    </media>
    <!--...more "media" elements...-->
    <identifier type="...">...</identifier>
    <identifier type="...">...</identifier>
    <!--...more "identifier" elements...-->
    <person1 resourceId="..." resource="..." />
    <person2 resourceId="..." resource="..." />
    <fact id="..." confidence="..." sortKey="..." xml:lang="..." primary="..." type="..." />
    <fact primary="..." type="...">
      <!--...-->
    </fact>
    <!--...more "fact" elements...-->
    <field id="..." type="..." />
    <field type="...">
      <!--...-->
    </field>
    <!--...more "field" elements...-->
  </relationship>
  <relationship type="...">
    <!--...-->
  </relationship>
  <!--...more "relationship" elements...-->
  <sourceDescription id="..." about="..." xml:lang="..." mediaType="..." version="..." sortKey="..." resourceType="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <citation id="..." xml:lang="..." />
    <citation xml:lang="...">
      <!--...-->
    </citation>
    <!--...more "citation" elements...-->
    <mediator resourceId="..." resource="..." />
    <source id="..." description="..." />
    <source description="...">
      <!--...-->
    </source>
    <!--...more "source" elements...-->
    <analysis resourceId="..." resource="..." />
    <componentOf id="..." description="..." />
    <title xml:lang="...">...</title>
    <title xml:lang="...">...</title>
    <!--...more "title" elements...-->
    <titleLabel xml:lang="...">...</titleLabel>
    <note id="..." xml:lang="..." />
    <note xml:lang="...">
      <!--...-->
    </note>
    <!--...more "note" elements...-->
    <attribution id="..." />
    <description xml:lang="...">...</description>
    <description xml:lang="...">...</description>
    <!--...more "description" elements...-->
    <identifier type="...">...</identifier>
    <identifier type="...">...</identifier>
    <!--...more "identifier" elements...-->
    <created>...</created>
    <modified>...</modified>
    <coverage id="..." />
    <coverage>
      <!--...-->
    </coverage>
    <!--...more "coverage" elements...-->
    <rights>...</rights>
    <rights>...</rights>
    <!--...more "rights" elements...-->
    <field id="..." type="..." />
    <field type="...">
      <!--...-->
    </field>
    <!--...more "field" elements...-->
    <repository resourceId="..." resource="..." />
    <descriptor resourceId="..." resource="..." />
    <replacedBy>...</replacedBy>
    <replaces>...</replaces>
    <replaces>...</replaces>
    <!--...more "replaces" elements...-->
    <status>...</status>
    <status>...</status>
    <!--...more "status" elements...-->
  </sourceDescription>
  <sourceDescription about="..." xml:lang="..." mediaType="..." version="..." sortKey="..." resourceType="...">
    <!--...-->
  </sourceDescription>
  <!--...more "sourceDescription" elements...-->
  <agent id="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <account id="..." />
    <account>
      <!--...-->
    </account>
    <!--...more "account" elements...-->
    <address id="..." />
    <address>
      <!--...-->
    </address>
    <!--...more "address" elements...-->
    <email resourceId="..." resource="..." />
    <email resourceId="..." resource="...">
      <!--...-->
    </email>
    <!--...more "email" elements...-->
    <homepage resourceId="..." resource="..." />
    <identifier type="...">...</identifier>
    <identifier type="...">...</identifier>
    <!--...more "identifier" elements...-->
    <name xml:lang="...">...</name>
    <name xml:lang="...">...</name>
    <!--...more "name" elements...-->
    <openid resourceId="..." resource="..." />
    <phone resourceId="..." resource="..." />
    <phone resourceId="..." resource="...">
      <!--...-->
    </phone>
    <!--...more "phone" elements...-->
  </agent>
  <agent>
    <!--...-->
  </agent>
  <!--...more "agent" elements...-->
  <event id="..." confidence="..." sortKey="..." xml:lang="..." extracted="..." type="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <attribution id="..." />
    <source id="..." description="..." />
    <source description="...">
      <!--...-->
    </source>
    <!--...more "source" elements...-->
    <analysis resourceId="..." resource="..." />
    <note id="..." xml:lang="..." />
    <note xml:lang="...">
      <!--...-->
    </note>
    <!--...more "note" elements...-->
    <evidence id="..." resourceId="..." resource="..." />
    <evidence resourceId="..." resource="...">
      <!--...-->
    </evidence>
    <!--...more "evidence" elements...-->
    <media id="..." description="..." />
    <media description="...">
      <!--...-->
    </media>
    <!--...more "media" elements...-->
    <identifier type="...">...</identifier>
    <identifier type="...">...</identifier>
    <!--...more "identifier" elements...-->
    <date id="..." />
    <place id="..." description="..." />
    <role id="..." confidence="..." sortKey="..." xml:lang="..." type="..." />
    <role type="...">
      <!--...-->
    </role>
    <!--...more "role" elements...-->
  </event>
  <event type="...">
    <!--...-->
  </event>
  <!--...more "event" elements...-->
  <place id="..." confidence="..." sortKey="..." xml:lang="..." extracted="..." type="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <attribution id="..." />
    <source id="..." description="..." />
    <source description="...">
      <!--...-->
    </source>
    <!--...more "source" elements...-->
    <analysis resourceId="..." resource="..." />
    <note id="..." xml:lang="..." />
    <note xml:lang="...">
      <!--...-->
    </note>
    <!--...more "note" elements...-->
    <evidence id="..." resourceId="..." resource="..." />
    <evidence resourceId="..." resource="...">
      <!--...-->
    </evidence>
    <!--...more "evidence" elements...-->
    <media id="..." description="..." />
    <media description="...">
      <!--...-->
    </media>
    <!--...more "media" elements...-->
    <identifier type="...">...</identifier>
    <identifier type="...">...</identifier>
    <!--...more "identifier" elements...-->
    <name xml:lang="...">...</name>
    <name xml:lang="...">...</name>
    <!--...more "name" elements...-->
    <temporalDescription id="..." />
    <latitude>...</latitude>
    <longitude>...</longitude>
    <spatialDescription resourceId="..." resource="..." />
    <place resourceId="..." resource="..." />
    <jurisdiction resourceId="..." resource="..." />
    <display id="..." />
  </place>
  <place type="...">
    <!--...-->
  </place>
  <!--...more "place" elements...-->
  <document id="..." confidence="..." sortKey="..." xml:lang="..." textType="..." extracted="..." type="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <attribution id="..." />
    <source id="..." description="..." />
    <source description="...">
      <!--...-->
    </source>
    <!--...more "source" elements...-->
    <analysis resourceId="..." resource="..." />
    <note id="..." xml:lang="..." />
    <note xml:lang="...">
      <!--...-->
    </note>
    <!--...more "note" elements...-->
    <text>...</text>
  </document>
  <document textType="..." extracted="..." type="...">
    <!--...-->
  </document>
  <!--...more "document" elements...-->
  <collection id="..." xml:lang="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <identifier type="...">...</identifier>
    <identifier type="...">...</identifier>
    <!--...more "identifier" elements...-->
    <title>...</title>
    <size>...</size>
    <content id="..." />
    <content>
      <!--...-->
    </content>
    <!--...more "content" elements...-->
    <attribution id="..." />
  </collection>
  <collection xml:lang="...">
    <!--...-->
  </collection>
  <!--...more "collection" elements...-->
  <field id="..." type="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <value id="..." confidence="..." sortKey="..." xml:lang="..." resource="..." datatype="..." type="..." labelId="..." />
    <value resource="..." datatype="..." type="..." labelId="...">
      <!--...-->
    </value>
    <!--...more "value" elements...-->
  </field>
  <field type="...">
    <!--...-->
  </field>
  <!--...more "field" elements...-->
  <recordDescriptor id="..." xml:lang="...">
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="..." />
    <link template="..." allow="..." count="..." accept="..." type="..." hreflang="..." title="..." results="..." rel="..." offset="..." href="...">
      <!--...-->
    </link>
    <!--...more "link" elements...-->
    <field id="..." />
    <field>
      <!--...-->
    </field>
    <!--...more "field" elements...-->
  </recordDescriptor>
  <recordDescriptor xml:lang="...">
    <!--...-->
  </recordDescriptor>
  <!--...more "recordDescriptor" elements...-->
</Gedcomx>