--- title: "Get a person's family and line of descent" method: GET path: "/family/{path}" --- # Get a person's family and line of descent `GET /family/{path}` ## Request - Base URL: `https://vineverse.bible/api/v1` - URL: `https://vineverse.bible/api/v1/family/{path}` - Auth: none required Parents, children, siblings and spouses for any person, and with `generations` above 1 the line of descent — ancestors and descendants gathered one generation at a time. This is the endpoint for a genealogy, lineage or ancestry question: "who were Boaz's ancestors", "trace David's line", "who did Ruth marry". Use this rather than reading relations off /entity. The corpus contains no `child-of` edge at all — parentage is recorded only on the parent's document — so a person's own `parent-of` relations are their CHILDREN, and reading them as parents inverts the family tree. This endpoint does the inversion. Called family rather than genealogy because it returns kinship as well as descent, and because two other things here own that word. The 680 `ancestor-of` edges assert descent across an unknown number of generations, so they cannot be composed into a generation-by-generation tree and are excluded from this one — read them off /entity if you want them. And the genealogy PASSAGES — Genesis 5 and 10, Ruth 4, Matthew 1, Luke 3 — are indexed as a theme at /entity/themes/genealogy. ## Path parameters - `path` string, required ## Query parameters - `generations` integer ## Response `200` The person and their immediate family. - Family - `person` NodeSummary, required - `id` string, required: Site route, e.g. "/people/moses". Strip the leading slash to use it as a path. - `title` string, required - `type` 'Person' | 'Place' | 'Theme' | 'Lexeme' | 'Commandment' | 'Event' | 'Epoch' | 'Book' | 'Chapter' | 'Source' | 'Dataset' | 'Relation Vocabulary', required: Which collection the document belongs to. - `description` string - `degree` integer, required: Number of graph edges touching this document. - `lat` number: Places only. - `lon` number: Places only. - `strongs` string: Lexemes only, e.g. "H430". - `osis` string: Scripture documents and commandments only. - `shareAlike` boolean: Present, and always true, only on CC BY-SA 4.0 documents. A listing has one licence block for many documents and cannot say which are viral, so it says it here instead. Filtering on the "/sa/" id prefix is NOT equivalent — it misses /sources/theographic. - `parents` NodeSummary[], required - `id` string, required: Site route, e.g. "/people/moses". Strip the leading slash to use it as a path. - `title` string, required - `type` 'Person' | 'Place' | 'Theme' | 'Lexeme' | 'Commandment' | 'Event' | 'Epoch' | 'Book' | 'Chapter' | 'Source' | 'Dataset' | 'Relation Vocabulary', required: Which collection the document belongs to. - `description` string - `degree` integer, required: Number of graph edges touching this document. - `lat` number: Places only. - `lon` number: Places only. - `strongs` string: Lexemes only, e.g. "H430". - `osis` string: Scripture documents and commandments only. - `shareAlike` boolean: Present, and always true, only on CC BY-SA 4.0 documents. A listing has one licence block for many documents and cannot say which are viral, so it says it here instead. Filtering on the "/sa/" id prefix is NOT equivalent — it misses /sources/theographic. - `children` NodeSummary[], required - `id` string, required: Site route, e.g. "/people/moses". Strip the leading slash to use it as a path. - `title` string, required - `type` 'Person' | 'Place' | 'Theme' | 'Lexeme' | 'Commandment' | 'Event' | 'Epoch' | 'Book' | 'Chapter' | 'Source' | 'Dataset' | 'Relation Vocabulary', required: Which collection the document belongs to. - `description` string - `degree` integer, required: Number of graph edges touching this document. - `lat` number: Places only. - `lon` number: Places only. - `strongs` string: Lexemes only, e.g. "H430". - `osis` string: Scripture documents and commandments only. - `shareAlike` boolean: Present, and always true, only on CC BY-SA 4.0 documents. A listing has one licence block for many documents and cannot say which are viral, so it says it here instead. Filtering on the "/sa/" id prefix is NOT equivalent — it misses /sources/theographic. - `siblings` NodeSummary[], required - `id` string, required: Site route, e.g. "/people/moses". Strip the leading slash to use it as a path. - `title` string, required - `type` 'Person' | 'Place' | 'Theme' | 'Lexeme' | 'Commandment' | 'Event' | 'Epoch' | 'Book' | 'Chapter' | 'Source' | 'Dataset' | 'Relation Vocabulary', required: Which collection the document belongs to. - `description` string - `degree` integer, required: Number of graph edges touching this document. - `lat` number: Places only. - `lon` number: Places only. - `strongs` string: Lexemes only, e.g. "H430". - `osis` string: Scripture documents and commandments only. - `shareAlike` boolean: Present, and always true, only on CC BY-SA 4.0 documents. A listing has one licence block for many documents and cannot say which are viral, so it says it here instead. Filtering on the "/sa/" id prefix is NOT equivalent — it misses /sources/theographic. - `spouses` NodeSummary[], required - `id` string, required: Site route, e.g. "/people/moses". Strip the leading slash to use it as a path. - `title` string, required - `type` 'Person' | 'Place' | 'Theme' | 'Lexeme' | 'Commandment' | 'Event' | 'Epoch' | 'Book' | 'Chapter' | 'Source' | 'Dataset' | 'Relation Vocabulary', required: Which collection the document belongs to. - `description` string - `degree` integer, required: Number of graph edges touching this document. - `lat` number: Places only. - `lon` number: Places only. - `strongs` string: Lexemes only, e.g. "H430". - `osis` string: Scripture documents and commandments only. - `shareAlike` boolean: Present, and always true, only on CC BY-SA 4.0 documents. A listing has one licence block for many documents and cannot say which are viral, so it says it here instead. Filtering on the "/sa/" id prefix is NOT equivalent — it misses /sources/theographic. - `ancestors` object[]: Only when generations > 1. One entry per generation above. - `generation` integer - `people` NodeSummary[] - `id` string, required: Site route, e.g. "/people/moses". Strip the leading slash to use it as a path. - `title` string, required - `type` 'Person' | 'Place' | 'Theme' | 'Lexeme' | 'Commandment' | 'Event' | 'Epoch' | 'Book' | 'Chapter' | 'Source' | 'Dataset' | 'Relation Vocabulary', required: Which collection the document belongs to. - `description` string - `degree` integer, required: Number of graph edges touching this document. - `lat` number: Places only. - `lon` number: Places only. - `strongs` string: Lexemes only, e.g. "H430". - `osis` string: Scripture documents and commandments only. - `shareAlike` boolean: Present, and always true, only on CC BY-SA 4.0 documents. A listing has one licence block for many documents and cannot say which are viral, so it says it here instead. Filtering on the "/sa/" id prefix is NOT equivalent — it misses /sources/theographic. - `descendants` object[] - `note` string - `licence` Licence: Carried on every response. The obligation is inherited by anyone who redistributes the data, not discharged by us. `document` is the licence of the specific document fetched, which is CC-BY-SA-4.0 for anything under sa/ and is the value to honour over the blanket statement. - `text` string - `data` string - `document` string: SPDX-style id for this document, e.g. "CC-BY-4.0". - `shareAlike` string - `reason` string - `attribution` string, uri ## Other responses - `400`: The reference or parameter could not be parsed. - `404`: No such document. - `429`: Too many requests. Carries Retry-After. See the rate limit note in `info`. --- [API](https://skmtc.dev/vineverse/apis/vineverse-api.md) · [All operations](https://skmtc.dev/vineverse/apis/vineverse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vineverse/apis/vineverse-api/revisions/39d053a686bb?raw)