Zovo Family Tree

Use this when the user wants a family tree, genealogy chart, pedigree chart, descendant chart, hourglass chart, fan chart or a printable family tree poster or template from relatives they describe. Convert the description into people (id, name, born, died, sex, parents, spouses) and call once. Lays out generations, couples, remarriages, half-siblings, adoption and twins without overlaps; returns a zoomable chart, PDF posters (Letter, A4, A2, 18x24, 24x36 in), SVG and a GEDCOM 5.5.1 file. Does not research ancestors, find records, or import GEDCOM files; do not invent relatives or dates. Not for organisation charts or flowcharts.

{
  "type": "object",
  "properties": {
    "people": {
      "minItems": 1,
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Short unique id used to link relatives, e.g. p1 or jan. If omitted, the name is the id.",
            "type": "string",
            "maxLength": 40
          },
          "name": {
            "type": "string",
            "maxLength": 80,
            "description": "Full name as it should print, e.g. Jan Kowalski, Zofia Nowak, 田中 花子."
          },
          "born": {
            "description": "Birth year or date: 1950, 1950-03-12, 12 March 1950, or an estimate such as c. 1890, 1890s or before 1900. Omit if unknown.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 40
              },
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            ]
          },
          "died": {
            "description": "Death year or date (1990, 1990-07-01); use ? if deceased with unknown date. Omit for living people.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 40
              },
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            ]
          },
          "sex": {
            "description": "male, female or unknown; sets the colour marker and father/mother order. Example: female.",
            "type": "string",
            "maxLength": 12
          },
          "parents": {
            "description": "Ids of up to 2 parents, e.g. [\"p1\",\"p2\"]. Omit if unknown.",
            "maxItems": 6,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 80
            }
          },
          "children": {
            "description": "Optional: ids of this person's children, e.g. [\"p3\",\"p4\"]. Same effect as listing this person in each child's parents.",
            "maxItems": 30,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 80
            }
          },
          "spouses": {
            "description": "Spouses or partners in order, e.g. [{\"id\":\"p2\",\"married\":\"1948\"}] or [\"p2\"]. Listing it on one side is enough; co-parents are linked automatically.",
            "maxItems": 8,
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 80
                },
                {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 80,
                      "description": "Spouse or partner id, e.g. p2."
                    },
                    "married": {
                      "description": "Marriage year or date, e.g. 1948.",
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 40
                        },
                        {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        }
                      ]
                    },
                    "divorced": {
                      "description": "true if the couple divorced, e.g. true.",
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id"
                  ]
                }
              ]
            }
          },
          "adopted": {
            "description": "true if this person was adopted by the listed parents (drawn with a dashed line), e.g. true.",
            "type": "boolean"
          },
          "twin": {
            "description": "true for twins whose full birth dates are unknown; twins with the same full birth date are detected automatically. Example: true.",
            "type": "boolean"
          }
        },
        "required": [
          "name"
        ],
        "additionalProperties": {}
      },
      "description": "Everyone in the tree (1-200 people), each with an id, a name and links to parents/spouses by id."
    },
    "chart": {
      "description": "family = everyone, generations aligned (default); descendants = from one person or couple down; ancestors = pedigree chart from one person back; hourglass = one person's ancestors above and descendants below; fan = half-circle ancestor fan chart. Example: descendants.",
      "type": "string",
      "enum": [
        "family",
        "descendants",
        "ancestors",
        "hourglass",
        "fan"
      ]
    },
    "root": {
      "description": "Id or name of the person the chart starts from (top of a descendants chart, centre of ancestors/fan/hourglass). Example: p1.",
      "type": "string",
      "maxLength": 80
    },
    "generations": {
      "description": "How many generations to draw, counting the root: ancestors/fan 2-6 (default 4 and 5), hourglass ancestors 2-5 (default 3), descendants/family up to 12. Example: 4.",
      "type": "integer",
      "minimum": 2,
      "maximum": 12
    },
    "title": {
      "description": "Poster title, e.g. The Kowalski Family. Default: The <surname> Family.",
      "type": "string",
      "maxLength": 80
    },
    "paper": {
      "description": "PDF size for the main download link: letter, a4, a2, 18x24 or 24x36 (inches). Default: the smallest size where names print at 8 pt or larger. Example: 18x24.",
      "type": "string",
      "enum": [
        "letter",
        "a4",
        "a2",
        "18x24",
        "24x36"
      ]
    }
  },
  "required": [
    "people"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "subtitle": {
      "type": "string"
    },
    "chart": {
      "type": "string"
    },
    "root": {
      "type": [
        "string",
        "null"
      ]
    },
    "people_total": {
      "type": "number"
    },
    "people_shown": {
      "type": "number"
    },
    "generations": {
      "type": "number"
    },
    "duplicates": {
      "type": "number"
    },
    "box_overlaps": {
      "type": "number"
    },
    "compact": {
      "type": "boolean"
    },
    "not_shown": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "print": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "paper": {
            "type": "string"
          },
          "name_pt": {
            "type": "number"
          }
        },
        "required": [
          "paper",
          "name_pt"
        ],
        "additionalProperties": false
      }
    },
    "recommended_paper": {
      "type": "string"
    },
    "downloads": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "download_note": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "title",
    "subtitle",
    "chart",
    "root",
    "people_total",
    "people_shown",
    "generations",
    "duplicates",
    "box_overlaps",
    "compact",
    "not_shown",
    "warnings",
    "print",
    "recommended_paper",
    "downloads",
    "download_note"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use this when the user asks how two people in their family are related (for example second cousin once removed, great-aunt, half-brother, mother-in-law, stepsister) and gives the family links. Pass the same people list as for the family tree and the two people. Computes the exact English kinship term both ways, the closest common ancestors and the generations to them. Does not guess missing links or research genealogy records; DNA matches and percentages are not covered.

{
  "type": "object",
  "properties": {
    "people": {
      "minItems": 1,
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Short unique id used to link relatives, e.g. p1 or jan. If omitted, the name is the id.",
            "type": "string",
            "maxLength": 40
          },
          "name": {
            "type": "string",
            "maxLength": 80,
            "description": "Full name as it should print, e.g. Jan Kowalski, Zofia Nowak, 田中 花子."
          },
          "born": {
            "description": "Birth year or date: 1950, 1950-03-12, 12 March 1950, or an estimate such as c. 1890, 1890s or before 1900. Omit if unknown.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 40
              },
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            ]
          },
          "died": {
            "description": "Death year or date (1990, 1990-07-01); use ? if deceased with unknown date. Omit for living people.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 40
              },
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            ]
          },
          "sex": {
            "description": "male, female or unknown; sets the colour marker and father/mother order. Example: female.",
            "type": "string",
            "maxLength": 12
          },
          "parents": {
            "description": "Ids of up to 2 parents, e.g. [\"p1\",\"p2\"]. Omit if unknown.",
            "maxItems": 6,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 80
            }
          },
          "children": {
            "description": "Optional: ids of this person's children, e.g. [\"p3\",\"p4\"]. Same effect as listing this person in each child's parents.",
            "maxItems": 30,
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 80
            }
          },
          "spouses": {
            "description": "Spouses or partners in order, e.g. [{\"id\":\"p2\",\"married\":\"1948\"}] or [\"p2\"]. Listing it on one side is enough; co-parents are linked automatically.",
            "maxItems": 8,
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 80
                },
                {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 80,
                      "description": "Spouse or partner id, e.g. p2."
                    },
                    "married": {
                      "description": "Marriage year or date, e.g. 1948.",
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 40
                        },
                        {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        }
                      ]
                    },
                    "divorced": {
                      "description": "true if the couple divorced, e.g. true.",
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id"
                  ]
                }
              ]
            }
          },
          "adopted": {
            "description": "true if this person was adopted by the listed parents (drawn with a dashed line), e.g. true.",
            "type": "boolean"
          },
          "twin": {
            "description": "true for twins whose full birth dates are unknown; twins with the same full birth date are detected automatically. Example: true.",
            "type": "boolean"
          }
        },
        "required": [
          "name"
        ],
        "additionalProperties": {}
      },
      "description": "Everyone in the tree (1-200 people), each with an id, a name and links to parents/spouses by id."
    },
    "person_a": {
      "type": "string",
      "maxLength": 80,
      "description": "Id or name of the first person (the one asking), e.g. p7."
    },
    "person_b": {
      "type": "string",
      "maxLength": 80,
      "description": "Id or name of the relative to describe, e.g. p3."
    }
  },
  "required": [
    "people",
    "person_a",
    "person_b"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "person_a": {
      "type": "string"
    },
    "person_b": {
      "type": "string"
    },
    "relationship": {
      "type": "string"
    },
    "reverse": {
      "type": "string"
    },
    "kind": {
      "type": "string"
    },
    "explanation": {
      "type": "string"
    },
    "common_ancestors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "generations_from_a": {
      "type": [
        "number",
        "null"
      ]
    },
    "generations_from_b": {
      "type": [
        "number",
        "null"
      ]
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "person_a",
    "person_b",
    "relationship",
    "reverse",
    "kind",
    "explanation",
    "common_ancestors",
    "generations_from_a",
    "generations_from_b",
    "warnings"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}