People
List People
Section titled “List People”GET /v1/peopleParameters
Section titled “Parameters”| Param | Type | Default | Description |
|---|---|---|---|
q | string | — | Filter by name (substring match) |
gender | string | — | Filter by gender (Male or Female) |
limit | integer | 50 | Results per page (max 200) |
offset | integer | 0 | Pagination offset |
Example
Section titled “Example”curl "https://api.gnosistools.com/v1/people?q=abraham&limit=5" \ -H "X-API-Key: gn_your_key_here"{ "data": [ { "slug": "abraham", "name": "Abraham", "gender": "Male", "birth_year_display": "1998 BC", "verse_count": 290 } ], "meta": { "total": 1, "limit": 5, "offset": 0 }}Get Person
Section titled “Get Person”GET /v1/people/{slug}Example
Section titled “Example”curl https://api.gnosistools.com/v1/people/abraham \ -H "X-API-Key: gn_your_key_here"Response Fields
Section titled “Response Fields”| Field | Type | Description |
|---|---|---|
slug | string | Unique identifier |
uuid | string | Deterministic UUID v5 |
name | string | Display name |
gender | string | Male or Female |
birth_year | integer | Astronomical year (negative = BC) |
death_year | integer | Astronomical year |
birth_year_display | string | Human-readable (e.g., “1998 BC”) |
death_year_display | string | Human-readable |
birth_place | string | Place slug |
death_place | string | Place slug |
father | string | Person slug |
mother | string | Person slug |
siblings | string[] | Person slugs |
children | string[] | Person slugs |
partners | string[] | Person slugs |
verse_count | integer | Number of verse references |
verses | string[] | OSIS references (e.g., Gen.11.26) |
first_mention | string | First verse reference |
name_meaning | string | Etymology of the name |
people_groups | string[] | Group slugs |