THE PUBLIC VEYMONT API
Build on a stable reference.
Read-only Scripture and research endpoints, with permanent identifiers and traceable source metadata.
| Endpoint / live example | Response |
|---|---|
/api/v1/morphology?reference=John%203%3A16 | Source-language words, lemma indices, raw morphology and source boundaries. |
/api/v1/morphology?lemma=G25 | Paginated contextual source occurrences of a lemma. |
/api/v1/atlas?q=Jerusalem | Ancient place records with competing identifications and source scores. |
/api/v1/entities?q=Hezekiah | Attributed person, event and group records; ambiguous names retain separate identities. |
/api/v1/library?q=Spurgeon | Complete historical work catalogue and individual rights records. |
/api/v1/library-citations/KJV.43.003.016 | Detected bibliography and paragraph links for a verse. |
/api/v1/facsimiles | Historical scan collections, OCR provenance and digital image locators. |
/api/v1/audio?q=John | Original recording metadata and chapter associations. |
/api/v1 | Corpus manifest, book metadata, speakers, and endpoint catalogue. |
/api/v1/verses/KJV.43.003.016 | John 3:16 with a permanent identifier, text, reference, and URL. |
/api/v1/search?q=grace%20NEAR%2F5%20faith | Boolean, phrase, and proximity search. |
/api/v1/concordance?q=char | English forms, occurrence counts, and first/last occurrences. |
/api/v1/cross-references/KJV.43.003.016 | Attributed archival passage connections and source vote counts. |
/api/v1/graph/KJV.43.003.016 | Passage-to-resource and course relationships, and approved papers. |
/api/v1/resources?kind=person | Published resource metadata; filter by kind or q. |
/api/v1/resources/person%3Anicodemus | One published resource, including classified claims and sources. |
/api/v1/lexicon/G26 | A sourced historical lexical entry. |
/api/v1/lexicon?q=faith&language=greek | Search the historical dictionaries. Add names=1 for name candidates. |
/api/v1/journal | Published paper metadata only. |
/api/v1/errata | Permanent public corrections. |
/api/v1/citations?id=KJV.43.003.016&format=bibtex | Download a citation. Formats: chicago, turabian, mla, bibtex, ris, text. |
Stable verse identifiers
KJV.43.003.016 = John 3:16
The reference transcription’s book order and verse numbering are fixed. A later textual correction must preserve verse identity and record its provenance. The corpus manifest includes per-chapter counts and a SHA-256 fingerprint.
Queries and pagination
List endpoints accept offset and limit; the maximum page size is 100. Search additionally accepts testament=ot|nt|all, from=genesis, to=revelation, speaker=Jesus|Nicodemus, and order=first|last. Speaker coverage is explicitly limited to the returned annotations.
const url = new URL("https://veymont.io/api/v1/search");
url.searchParams.set("q", "grace NEAR/5 faith");
url.searchParams.set("testament", "nt");
const response = await fetch(url);
if (!response.ok) throw new Error(`Search failed: ${response.status}`);
const result = await response.json();
console.log(result.total, result.occurrences, result.items);Errors use HTTP status codes with an error message. Use modest request rates, retain source attribution, and avoid repeated full-corpus scans. The public API does not accept writes or expose private account data.
Citable pages and archival editions
Verse pages have fixed URLs. Resource claims, source pages, transcript segments, and paper paragraphs have stable anchors. Citation exports include the reference title, source identity, URL, and an access date. Chicago and Turabian exports provide a bibliography-style starting point; a student must still follow the exact requirements of their institution and add the relevant locator.
Published resource snapshots can be selected with ?revision=. Approved paper snapshots use the same form. Journal issue and paper downloads preserve the approved text in a standalone printable HTML edition, which can also be saved as PDF from the print dialogue.
Coverage, classification, and rights terms govern each dataset. The API does not supply a new licence for an underlying work. Book text and scan OCR endpoints can return HTTP 451 when the trusted request territory is outside their recorded scope. No user header or query parameter can select a country. Library, atlas, entity, audio and facsimile citation IDs use their namespace followed by a colon; for example facsimile:kjv-1611 with anchor=leaf-0078.