---
title: "Relation vocabulary and canon table"
method: GET
path: "/vocabulary"
---

# Relation vocabulary and canon table

`GET /vocabulary`

## Request

- Base URL: `https://vineverse.bible/api/v1`
- URL: `https://vineverse.bible/api/v1/vocabulary`
- Auth: none required

The closed predicate set every typed edge is drawn from — what `develops`, `narrated-in`, `involves`, `stated-in` and `named-by` mean, their inverses, the types they connect and how many edges use each. Also the 66-book canon table with OSIS ids, slugs and chapter counts, which is how you learn that Song of Songs is "Song" before building a reference.

## Response `200`

Predicates and the canon table.

- Vocabulary
  - `predicates` object[]
    - `id` string
    - `heading` string
    - `inverse` string
    - `symmetric` boolean
    - `domain` string
    - `range` string
    - `edges` integer: How many edges in the bundle use it.
  - `undeclared` object[]: Predicates present in the data but absent from the published vocabulary.
  - `note` string
  - `books` object[]
    - `osisId` string
    - `name` string
    - `slug` string
    - `testament` 'OT' | 'NT'
    - `order` integer
    - `chapters` integer
    - `path` 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

- `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)