{"info":{"contact":{"name":"Jossi Fresco","url":"https://orcid.org/0009-0000-2026-0836"},"description":"Public read-only API for the Peshitta NT root explorer.\nAll responses include citation metadata. Cite as:\nFresco, J. (2026). Peshitta Constellations. Zenodo.\nhttps://doi.org/10.5281/zenodo.19358529\n","license":{"name":"Apache 2.0","url":"https://www.apache.org/licenses/LICENSE-2.0"},"title":"Peshitta Constellations API","version":"1.3.0","x-doi":"10.5281/zenodo.19358529","x-orcid":"0009-0000-2026-0836"},"openapi":"3.0.3","paths":{"/api/citation":{"get":{"description":"Returns citation metadata and the formatted citation in 5 styles\n(BibTeX, Chicago, MLA, APA, SBL) for a given view.\n","parameters":[{"in":"query","name":"view","required":false,"schema":{"default":"app","enum":["app","root","passage","search"],"type":"string"}},{"description":"Resource label (e.g. \"M-L-K\", \"Matthew 1:1-5\")","in":"query","name":"label","required":false,"schema":{"type":"string"}},{"description":"Canonical URL of the view being cited","in":"query","name":"url","required":false,"schema":{"format":"uri","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"metadata":{"author":"Jossi Fresco","doi":"10.5281/zenodo.19358529","orcid":"0009-0000-2026-0836","version":"1.3.0","year":2026},"styles":{"apa":"Fresco, J. (2026). Peshitta Constellations (Version 1.3.0) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.19358529","bibtex":"@misc{fresco2026peshitta, author = {Fresco, Jossi}, title = {Peshitta Constellations}, year = {2026}, doi = {10.5281/zenodo.19358529}, ...}","chicago":"Fresco, Jossi. 2026. \"Peshitta Constellations.\" Version 1.3.0. https://doi.org/10.5281/zenodo.19358529.","mla":"Fresco, Jossi. \"Peshitta Constellations.\" Version 1.3.0, 2026, doi.org/10.5281/zenodo.19358529.","sbl":"Fresco, Jossi. Peshitta Constellations. Version 1.3.0. 2026. https://doi.org/10.5281/zenodo.19358529."}},"schema":{"properties":{"metadata":{"description":"Author, DOI, ORCID, version, year","type":"object"},"styles":{"description":"Map of style name to formatted string","properties":{"apa":{"type":"string"},"bibtex":{"type":"string"},"chicago":{"type":"string"},"mla":{"type":"string"},"sbl":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Citation payload"},"429":{"description":"Rate limit exceeded"}},"summary":"Citation strings in 5 styles","tags":["Citation"]}},"/api/concordance":{"get":{"description":"Given a Syriac word form and a list of references, returns key-word-in-context\nsnippets (3 words before, 3 after) plus the verse translation.\n","parameters":[{"description":"Syriac word form to highlight","in":"query","name":"form","required":true,"schema":{"example":"\u0721\u0720\u071f\u0710","type":"string"}},{"description":"Comma-separated list of refs (max 30)","in":"query","name":"refs","required":true,"schema":{"example":"Matthew 1:6,Matthew 2:1,Matthew 2:2","type":"string"}},{"in":"query","name":"lang","required":false,"schema":{"default":"en","enum":["en","es","he","ar"],"type":"string"}},{"description":"Translation language for context","in":"query","name":"trans","required":false,"schema":{"enum":["en","es","he","ar","gr"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"contexts":[{"after":"\u0715\u0710\u072c\u071d\u0720\u0715 \u071a\u0719\u071d\u0722 \u0713\u071d\u072a","before":"\u0710\u071d\u071f\u0718 \u0721\u0720\u071f\u0710","ref":"Matthew 2:2","translation":"Where is the king of the Jews who has been born?","word":"\u0715\u071d\u0717\u0718\u0715\u071d\u0710"}]},"schema":{"properties":{"contexts":{"items":{"properties":{"after":{"type":"string"},"before":{"type":"string"},"ref":{"type":"string"},"translation":{"description":"Truncated to 150 chars","type":"string"},"word":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"KWIC contexts"},"400":{"description":"Missing form or refs parameter"},"429":{"description":"Rate limit exceeded"}},"summary":"KWIC concordance for a word form across references","tags":["Concordance"]}},"/api/export/osis":{"get":{"description":"Returns OSIS-formatted XML. With no `book`, exports the full Peshitta NT\ncorpus as a single OSIS document.\n","parameters":[{"description":"If omitted, exports the full corpus","in":"query","name":"book","required":false,"schema":{"example":"Matthew","type":"string"}}],"responses":{"200":{"content":{"application/xml":{"example":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<osis xmlns=\"http://www.bibletechnologies.net/2003/OSIS/namespace\">\n  <osisText osisIDWork=\"Peshitta\" xml:lang=\"syc\">\n    <header>\n      <work osisWork=\"Peshitta\">\n        <title>Peshitta New Testament</title>\n      </work>\n    </header>\n    <div type=\"book\" osisID=\"Matt\">\n      <chapter osisID=\"Matt.1\">\n        <verse osisID=\"Matt.1.1\">\u071f\u072c\u0712\u0710 \u0715\u071d\u0720\u071d\u0715\u0718\u072c\u0717 \u0715\u071d\u072b\u0718\u0725 \u0721\u072b\u071d\u071a\u0710</verse>\n      </chapter>\n    </div>\n  </osisText>\n</osis>\n","schema":{"type":"string"}}},"description":"OSIS 2.1.1 XML"},"400":{"description":"Invalid book parameter"},"429":{"description":"Rate limit exceeded"}},"summary":"Export book or full corpus as OSIS 2.1.1 XML","tags":["Export"]}},"/api/export/text-fabric":{"get":{"description":"Returns a ZIP archive containing a Text-Fabric (TF) dataset for the requested\nbook, or for the full corpus when `all=true`. Suitable for use with the\nText-Fabric Python library (https://annotation.github.io/text-fabric/).\n","parameters":[{"description":"Book name to export (mutually exclusive with `all`)","in":"query","name":"book","required":false,"schema":{"example":"Matthew","type":"string"}},{"description":"When true, exports the full corpus","in":"query","name":"all","required":false,"schema":{"example":true,"type":"boolean"}}],"responses":{"200":{"content":{"application/zip":{"schema":{"format":"binary","type":"string"}}},"description":"Text-Fabric dataset (ZIP)"},"400":{"description":"Must supply either `book` or `all=true`"},"429":{"description":"Rate limit exceeded"}},"summary":"Export book or full corpus as a Text-Fabric dataset","tags":["Export"]}},"/api/export/usfm":{"get":{"description":"Returns the requested book or verse range serialized as USFM 3.0 plain text.\nUseful for import into Paratext, Logos, and other Bible software.\n","parameters":[{"description":"Book name in English (e.g. \"Matthew\")","in":"query","name":"book","required":true,"schema":{"example":"Matthew","type":"string"}},{"description":"If omitted, exports the entire book","in":"query","name":"chapter","required":false,"schema":{"example":1,"type":"integer"}},{"in":"query","name":"start_verse","required":false,"schema":{"example":1,"type":"integer"}},{"in":"query","name":"end_verse","required":false,"schema":{"example":25,"type":"integer"}}],"responses":{"200":{"content":{"text/plain":{"example":"\\id MAT Peshitta NT\n\\h Matthew\n\\toc1 The Gospel According to Matthew\n\\toc2 Matthew\n\\mt1 Matthew\n\\c 1\n\\v 1 \u071f\u072c\u0712\u0710 \u0715\u071d\u0720\u071d\u0715\u0718\u072c\u0717 \u0715\u071d\u072b\u0718\u0725 \u0721\u072b\u071d\u071a\u0710\n","schema":{"type":"string"}}},"description":"USFM 3.0 text"},"400":{"description":"Missing or invalid book parameter"},"404":{"description":"Book/chapter/verse range not found"},"429":{"description":"Rate limit exceeded"}},"summary":"Export verse range as USFM 3.0","tags":["Export"]}},"/api/greek-concordance":{"get":{"description":"Returns the Syriac roots that translate a given Greek word in the Peshitta.\nWith no `q`, returns a browse list of all Greek words in the index.\n","parameters":[{"description":"Greek word; if omitted, returns the full browse list","in":"query","name":"q","required":false,"schema":{"example":"\u03bb\u03cc\u03b3\u03bf\u03c2","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"meaning":"word, reason, discourse","query":"\u03bb\u03cc\u03b3\u03bf\u03c2","roots":[{"gloss":"to speak, utter","key":"M-L-L","occurrences":312,"root_syriac":"\u0721\u0720\u0720","sabor":"speech, utterance"}],"total":2,"transliteration":"logos"},"schema":{"oneOf":[{"description":"Browse mode (no q)","properties":{"browse":{"type":"boolean"},"total":{"type":"integer"},"words":{"items":{"properties":{"meaning":{"type":"string"},"root_count":{"type":"integer"},"transliteration":{"type":"string"},"word":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},{"description":"Search mode","properties":{"meaning":{"type":"string"},"query":{"type":"string"},"roots":{"items":{"properties":{"gloss":{"type":"string"},"key":{"type":"string"},"occurrences":{"type":"integer"},"root_syriac":{"type":"string"},"sabor":{"type":"string"}},"type":"object"},"type":"array"},"total":{"type":"integer"},"transliteration":{"type":"string"}},"type":"object"}]}}},"description":"Greek-to-Syriac mapping or browse list"},"429":{"description":"Rate limit exceeded"}},"summary":"Greek lemma to Syriac roots","tags":["Cognates","Concordance"]}},"/api/passage-constellation":{"get":{"description":"Returns all roots in a passage with their cognates, frequency, word forms,\nand inter-root connections (semantic bridges and sister roots).\n","parameters":[{"description":"Book name in English (e.g. \"Matthew\")","in":"query","name":"book","required":true,"schema":{"example":"Matthew","type":"string"}},{"in":"query","name":"chapter","required":true,"schema":{"example":1,"type":"integer"}},{"in":"query","name":"v_start","required":true,"schema":{"example":1,"type":"integer"}},{"description":"Defaults to v_start (single-verse range)","in":"query","name":"v_end","required":false,"schema":{"example":5,"type":"integer"}},{"in":"query","name":"script","required":false,"schema":{"default":"latin","enum":["latin","hebrew","arabic","syriac"],"type":"string"}},{"in":"query","name":"trans","required":false,"schema":{"enum":["en","es","he","ar","gr"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"connections":[],"reference":"Matthew 1:1-5","roots":[],"total_roots":0,"verses":[]},"schema":{"properties":{"connections":{"items":{"properties":{"concept":{"type":"string"},"source":{"type":"string"},"target":{"type":"string"},"type":{"nullable":true,"type":"string"}},"type":"object"},"type":"array"},"reference":{"type":"string"},"roots":{"items":{"properties":{"arabic":{"items":{"type":"object"},"type":"array"},"bridges":{"items":{"type":"object"},"type":"array"},"frequency":{"type":"integer"},"gloss":{"type":"string"},"hebrew":{"items":{"type":"object"},"type":"array"},"root_syriac":{"type":"string"},"root_translit":{"type":"string"},"word_forms":{"items":{"properties":{"syriac":{"type":"string"},"translit":{"type":"string"},"verse_ref":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"},"total_roots":{"type":"integer"},"verses":{"items":{"properties":{"ref":{"type":"string"},"translation":{"type":"string"},"verse_num":{"type":"integer"},"words":{"items":{"properties":{"root":{"nullable":true,"type":"string"},"root_syriac":{"nullable":true,"type":"string"},"syriac":{"type":"string"},"translit":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"Constellation payload"},"400":{"description":"Missing/invalid book, chapter, or v_start"},"404":{"description":"No verses found for that range"},"429":{"description":"Rate limit exceeded"}},"summary":"Root network for a passage","tags":["Search","Roots"]}},"/api/proximity-search":{"get":{"description":"Searches for two Syriac roots co-occurring within the same verse or\nchapter. Accepts dash-form transliteration or Syriac for each root.\nFalls back through Semitic sound-correspondence variants if a literal\nmatch is not found.\n","parameters":[{"description":"First root (dash form e.g. \"M-L-K\" or Syriac)","in":"query","name":"root1","required":true,"schema":{"example":"M-L-K","type":"string"}},{"description":"Second root (dash form e.g. \"B-R-K\" or Syriac)","in":"query","name":"root2","required":true,"schema":{"example":"B-R-K","type":"string"}},{"description":"Co-occurrence scope","in":"query","name":"scope","required":false,"schema":{"default":"verse","enum":["verse","chapter"],"type":"string"}},{"description":"UI language for glosses","in":"query","name":"lang","required":false,"schema":{"default":"en","enum":["en","es","he","ar"],"type":"string"}},{"description":"Translation language for verse text","in":"query","name":"trans","required":false,"schema":{"enum":["en","es","he","ar","gr"],"type":"string"}},{"description":"Transliteration target script (verse scope only)","in":"query","name":"script","required":false,"schema":{"default":"latin","enum":["latin","hebrew","arabic","syriac"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"count":1,"gloss1":"king, to rule","gloss2":"to bless, kneel","results":[{"forms1":["\u0721\u0720\u071f\u0710"],"forms2":["\u0712\u072a\u071d\u071f\u0718\u0717\u071d"],"ref":"Matthew 25:34","syriac":"\u0717\u071d\u0715\u071d\u0722 \u0722\u0710\u0721\u072a \u0721\u0720\u071f\u0710 \u0720\u0717\u0722\u0718\u0722 \u0715\u0721\u0722 \u071d\u0721\u071d\u0722\u0717 \u072c\u0718 \u0712\u072a\u071d\u071f\u0718\u0717\u071d \u0715\u0710\u0712\u071d","translation":"Then the king will say to those at his right hand: Come, blessed of my Father...","translit":"haydein nemar malka l'hanon dman yamineh tau brikuhi d'abi"}],"root1":"M-L-K","root1_syriac":"\u0721\u0720\u071f","root2":"B-R-K","root2_syriac":"\u0712\u072a\u071f","scope":"verse"},"schema":{"oneOf":[{"description":"Verse scope","properties":{"count":{"type":"integer"},"gloss1":{"type":"string"},"gloss2":{"type":"string"},"results":{"description":"Up to 100 verses where both roots occur","items":{"properties":{"forms1":{"items":{"type":"string"},"type":"array"},"forms2":{"items":{"type":"string"},"type":"array"},"ref":{"type":"string"},"syriac":{"type":"string"},"translation":{"description":"Truncated to 200 chars","type":"string"},"translit":{"type":"string"}},"type":"object"},"type":"array"},"root1":{"description":"Dash-form translit","type":"string"},"root1_syriac":{"type":"string"},"root2":{"description":"Dash-form translit","type":"string"},"root2_syriac":{"type":"string"},"scope":{"enum":["verse"],"type":"string"}},"type":"object"},{"description":"Chapter scope","properties":{"count":{"type":"integer"},"results":{"description":"Up to 50 chapters where both roots occur","items":{"properties":{"ref":{"description":"e.g. 'Matthew 1'","type":"string"},"type":{"enum":["chapter"],"type":"string"}},"type":"object"},"type":"array"},"root1":{"type":"string"},"root2":{"type":"string"},"scope":{"enum":["chapter"],"type":"string"}},"type":"object"}]}}},"description":"Proximity matches (verse or chapter scope)"},"400":{"content":{"application/json":{"example":{"error":"Two roots required"},"schema":{"properties":{"error":{"type":"string"},"results":{"items":{"type":"object"},"type":"array"}},"type":"object"}}},"description":"Missing root1/root2, or root not found"},"429":{"description":"Rate limit exceeded"}},"summary":"Find verses or chapters where two roots co-occur","tags":["Search","Concordance"]}},"/api/reverse-search":{"get":{"description":"Searches glosses, sabor-raiz notes, and cognate meanings (Hebrew, Arabic,\nGreek) for query terms. Returns up to 30 ranked matches.\n","parameters":[{"description":"Search term (min 2 chars)","in":"query","name":"q","required":true,"schema":{"example":"peace","type":"string"}},{"in":"query","name":"lang","required":false,"schema":{"default":"en","enum":["en","es"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"query":"peace","results":[{"gloss":"peace, wholeness","key":"SH-L-M","occurrences":412,"root_syriac":"\u072b\u0720\u0721","sabor":"completion, rest, settlement","score":153}],"total":3},"schema":{"properties":{"query":{"type":"string"},"results":{"items":{"properties":{"gloss":{"type":"string"},"key":{"type":"string"},"occurrences":{"type":"integer"},"root_syriac":{"type":"string"},"sabor":{"type":"string"},"score":{"type":"integer"}},"type":"object"},"type":"array"},"total":{"type":"integer"}},"type":"object"}}},"description":"Ranked root matches"},"429":{"description":"Rate limit exceeded"}},"summary":"Find Syriac roots by English/Spanish meaning","tags":["Search","Cognates"]}},"/api/root-family":{"get":{"description":"Returns the root entry plus Syriac word forms, Hebrew/Arabic cognates,\nGreek parallel, semantic bridges, sister roots, and a paradigmatic citation.\n","parameters":[{"description":"Root in dash form (e.g. \"M-L-K\") or Syriac","in":"query","name":"root","required":true,"schema":{"example":"M-L-K","type":"string"}},{"in":"query","name":"script","required":false,"schema":{"default":"latin","enum":["latin","hebrew","arabic","syriac"],"type":"string"}},{"description":"Translation language for verse text","in":"query","name":"trans","required":false,"schema":{"enum":["en","es","he","ar","gr"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"arabic":[{"meaning":"king","outlier":false,"translit":"malik","word":"\u0645\u0644\u0643"}],"gloss":"king, to rule","greek_parallel":null,"hebrew":[{"meaning":"king","outlier":false,"translit":"melek","word":"\u05de\u05dc\u05da"}],"paradigmatic_form":"\u0721\u0720\u071f\u0710","paradigmatic_form_translit":"malka","paradigmatic_note":"","paradigmatic_ref":"Matthew 2:2","paradigmatic_syriac":"","paradigmatic_translit":"","paradigmatic_verse":"Where is the king of the Jews who has been born?","root":"\u0721\u0720\u071f","root_translit":"M-L-K","sabor_raiz":"sovereignty, counsel","semantic_bridges":[],"sister_roots":[],"syriac_words":[]},"schema":{"properties":{"arabic":{"items":{"properties":{"meaning":{"type":"string"},"outlier":{"type":"boolean"},"translit":{"type":"string"},"word":{"type":"string"}},"type":"object"},"type":"array"},"gloss":{"type":"string"},"greek_parallel":{"nullable":true,"properties":{"aramaic_range":{"type":"string"},"greek_range":{"type":"string"},"lost":{"type":"string"},"meaning":{"type":"string"},"transliteration":{"type":"string"},"word":{"type":"string"}},"type":"object"},"hebrew":{"items":{"properties":{"meaning":{"type":"string"},"outlier":{"type":"boolean"},"translit":{"type":"string"},"word":{"type":"string"}},"type":"object"},"type":"array"},"paradigmatic_form":{"type":"string"},"paradigmatic_form_translit":{"type":"string"},"paradigmatic_note":{"type":"string"},"paradigmatic_ref":{"type":"string"},"paradigmatic_syriac":{"type":"string"},"paradigmatic_translit":{"type":"string"},"paradigmatic_verse":{"type":"string"},"root":{"type":"string"},"root_translit":{"type":"string"},"sabor_raiz":{"type":"string"},"semantic_bridges":{"items":{"properties":{"bridge_concept":{"type":"string"},"outlier_key":{"type":"string"},"relationship":{"type":"string"},"target_root":{"type":"string"}},"type":"object"},"type":"array"},"sister_roots":{"items":{"properties":{"gloss":{"type":"string"},"root_syriac":{"type":"string"},"root_translit":{"type":"string"},"shared":{"type":"integer"}},"type":"object"},"type":"array"},"syriac_words":{"items":{"properties":{"meaning":{"type":"string"},"references":{"items":{"type":"string"},"type":"array"},"translit":{"type":"string"},"word":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"Root family payload"},"400":{"description":"Missing or invalid root parameter"},"429":{"description":"Rate limit exceeded"}},"summary":"Full root family with cognates and bridges","tags":["Roots","Cognates"]}},"/api/roots":{"get":{"description":"Returns roots sorted by frequency (descending), with gloss and form count.","parameters":[{"in":"query","name":"page","required":false,"schema":{"default":1,"example":1,"type":"integer"}},{"description":"Page size (max 100)","in":"query","name":"per_page","required":false,"schema":{"default":50,"example":50,"maximum":100,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"page":1,"per_page":50,"roots":[{"forms":87,"gloss":"to say, speak","occurrences":5312,"root":"\u0710\u0721\u072a","translit":"'-M-R"}],"total":2418,"total_pages":49},"schema":{"properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"roots":{"items":{"properties":{"forms":{"type":"integer"},"gloss":{"type":"string"},"occurrences":{"type":"integer"},"root":{"type":"string"},"translit":{"type":"string"}},"type":"object"},"type":"array"},"total":{"type":"integer"},"total_pages":{"type":"integer"}},"type":"object"}}},"description":"Paginated roots list"},"429":{"description":"Rate limit exceeded"}},"summary":"Paginated list of all roots","tags":["Roots"]}},"/api/suggest":{"get":{"description":"Returns roots whose dash-form transliteration starts with the given prefix.","parameters":[{"description":"Latin-letter prefix (e.g. \"M-L\" or \"MLK\")","in":"query","name":"prefix","required":true,"schema":{"example":"M-L","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":[{"count":487,"root":"\u0721\u0720\u071f","translit":"M-L-K"},{"count":312,"root":"\u0721\u0720\u0720","translit":"M-L-L"}],"schema":{"items":{"properties":{"count":{"description":"Total occurrences in corpus","type":"integer"},"root":{"description":"Syriac form","type":"string"},"translit":{"description":"Dash-form transliteration","type":"string"}},"type":"object"},"type":"array"}}},"description":"Up to 20 matching roots"},"429":{"description":"Rate limit exceeded"}},"summary":"Autocomplete root suggestions","tags":["Search"]}},"/api/text-search":{"get":{"description":"Searches verse translations (or Syriac text) for a substring.\nSupports auto-detection of query script (Syriac, Hebrew, Arabic, Latin).\nResults are paginated.\n","parameters":[{"description":"Search query (min 2 chars)","in":"query","name":"q","required":true,"schema":{"example":"kingdom","type":"string"}},{"description":"Translation lang to search; 'auto' detects from script","in":"query","name":"lang","required":false,"schema":{"default":"en","enum":["auto","en","es","he","ar","syriac"],"type":"string"}},{"in":"query","name":"page","required":false,"schema":{"default":1,"type":"integer"}},{"in":"query","name":"per_page","required":false,"schema":{"default":20,"type":"integer"}},{"in":"query","name":"script","required":false,"schema":{"default":"latin","enum":["latin","hebrew","arabic","syriac"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"page":1,"per_page":20,"query":"kingdom","results":[{"book":"Matthew","chapter":"3","highlight_indices":[],"match_positions":[13],"match_type":"translation","reference":"Matthew 3:2","reference_display":"Matthew 3:2","syriac":"...","translation":"Repent, for the kingdom of heaven is at hand.","verse":"2","words":[],"words_translit":[]}],"search_lang":"en","total":1},"schema":{"properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"query":{"type":"string"},"results":{"items":{"properties":{"book":{"type":"string"},"chapter":{"type":"string"},"highlight_indices":{"items":{"type":"integer"},"type":"array"},"match_positions":{"items":{"type":"integer"},"type":"array"},"match_type":{"type":"string"},"reference":{"type":"string"},"reference_display":{"type":"string"},"syriac":{"type":"string"},"translation":{"type":"string"},"verse":{"type":"string"},"words":{"items":{"type":"string"},"type":"array"},"words_translit":{"items":{"type":"string"},"type":"array"}},"type":"object"},"type":"array"},"search_lang":{"type":"string"},"total":{"type":"integer"}},"type":"object"}}},"description":"Paginated matches with KWIC positions"},"429":{"description":"Rate limit exceeded"}},"summary":"Full-text search across verses","tags":["Search","Read"]}},"/api/verse":{"get":{"description":"Returns Syriac text, transliteration, and translations (en/es/he/ar) for\na single verse reference, plus adjacent verse refs for navigation.\n","parameters":[{"description":"Verse reference, e.g. \"Matthew 1:1\"","in":"query","name":"ref","required":true,"schema":{"example":"Matthew 1:1","type":"string"}},{"description":"Transliteration target script","in":"query","name":"script","required":false,"schema":{"default":"latin","enum":["latin","hebrew","arabic","syriac"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"next_ref":"Matthew 1:2","prev_ref":null,"reference":"Matthew 1:1","reference_display":"Matthew 1:1","script":"latin","syriac":"\u071f\u072c\u0712\u0710 \u0715\u071d\u0720\u071d\u0715\u0718\u072c\u0717 \u0715\u071d\u072b\u0718\u0725 \u0721\u072b\u071d\u071a\u0710","translation_ar":null,"translation_en":"The book of the genealogy of Jesus the Messiah...","translation_es":"El libro de la genealog\u00eda de Yeshua el Mes\u00edas...","translation_he":null,"transliteration":"ktaba dyalidoteh dyeshu' meshikha","words":["\u071f\u072c\u0712\u0710","\u0715\u071d\u0720\u071d\u0715\u0718\u072c\u0717","\u0715\u071d\u072b\u0718\u0725","\u0721\u072b\u071d\u071a\u0710"],"words_translit":["ktaba","dyalidoteh","dyeshu'","meshikha"],"words_translit_academic":["ktaba","dyalidoteh","dyeshu'","meshikha"]},"schema":{"properties":{"next_ref":{"nullable":true,"type":"string"},"prev_ref":{"nullable":true,"type":"string"},"reference":{"type":"string"},"reference_display":{"type":"string"},"script":{"type":"string"},"syriac":{"type":"string"},"translation_ar":{"nullable":true,"type":"string"},"translation_en":{"nullable":true,"type":"string"},"translation_es":{"nullable":true,"type":"string"},"translation_he":{"nullable":true,"type":"string"},"transliteration":{"type":"string"},"words":{"items":{"type":"string"},"type":"array"},"words_translit":{"items":{"type":"string"},"type":"array"},"words_translit_academic":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Verse data"},"400":{"content":{"application/json":{"example":{"error":"Missing ref parameter"},"schema":{"properties":{"error":{"type":"string"}},"type":"object"}}},"description":"Missing ref parameter"},"404":{"content":{"application/json":{"example":{"error":"Verse not found"},"schema":{"properties":{"error":{"type":"string"}},"type":"object"}}},"description":"Verse not found"},"429":{"description":"Rate limit exceeded"}},"summary":"Get a single verse with translations","tags":["Read"]}},"/api/word-root":{"get":{"description":"Given a Syriac word, return its root and all sibling forms with glosses.","parameters":[{"description":"Syriac word form","in":"query","name":"form","required":true,"schema":{"example":"\u0721\u0720\u071f\u0710","type":"string"}},{"in":"query","name":"script","required":false,"schema":{"default":"latin","enum":["latin","hebrew","arabic","syriac"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"degradation":null,"form":"\u0721\u0720\u071f\u0710","gloss":"king, to rule","matches":[{"count":142,"form":"\u0721\u0720\u071f\u0710","gloss":"the king","references":["Matthew 1:6","Matthew 2:1"],"stem":"malk","transliteration":"malka"}],"root":"\u0721\u0720\u071f","root_translit":"M-L-K"},"schema":{"properties":{"degradation":{"nullable":true,"properties":{"aramaic_range":{"type":"string"},"greek_translit":{"type":"string"},"greek_word":{"type":"string"},"lost":{"type":"string"},"meaning":{"type":"string"}},"type":"object"},"form":{"type":"string"},"gloss":{"type":"string"},"matches":{"items":{"properties":{"count":{"type":"integer"},"form":{"type":"string"},"gloss":{"type":"string"},"references":{"items":{"type":"string"},"type":"array"},"stem":{"type":"string"},"transliteration":{"type":"string"}},"type":"object"},"type":"array"},"root":{"type":"string"},"root_translit":{"type":"string"}},"type":"object"}}},"description":"Root info plus matches"},"400":{"description":"Missing form parameter"},"404":{"description":"No root found for that form"},"429":{"description":"Rate limit exceeded"}},"summary":"Look up the root of a word form","tags":["Roots"]}}},"servers":[{"description":"Production","url":"https://peshitta.onrender.com"},{"description":"Local development","url":"http://localhost:5009"}],"tags":[{"description":"Root and text search","name":"Search"},{"description":"Verse retrieval","name":"Read"},{"description":"Root browsing and family data","name":"Roots"},{"description":"Hebrew/Arabic/Greek cognate lookup","name":"Cognates"},{"description":"KWIC and concordance data","name":"Concordance"},{"description":"Citation generation","name":"Citation"},{"description":"Bulk data export (USFM, OSIS, Text-Fabric)","name":"Export"}]}