Get a person's family and line of descent

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.

get/family/{path}

Request

  • Base URL: https://vineverse.bible/api/v1
  • URL: https://vineverse.bible/api/v1/family/{path}
  • Auth: none required

Path parameters

pathstring required

Query parameters

generationsinteger

Above 1, also returns ancestors and descendants generation by generation.

Response

The person and their immediate family.

descendantsobject[]
notestring

Changes

No recorded changes to this operation across all 1 revision of this API.