{"openapi":"3.1.0","info":{"title":"Quranic Data API","description":"Fast in-memory access to the Quranic corpus: text (Uthmani / simple), surah metadata, similar verses, translations, tajweed annotations, and asbab al-nuzul.","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["meta"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/surahs":{"get":{"tags":["text"],"summary":"List all 114 surahs with metadata","operationId":"list_surahs_surahs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SurahMeta"},"type":"array","title":"Response List Surahs Surahs Get"}}}}}}},"/surah/{sid}/meta":{"get":{"tags":["text"],"summary":"Surah metadata only","operationId":"surah_meta_surah__sid__meta_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SurahMeta"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/surah/{sid}":{"get":{"tags":["text"],"summary":"Full surah text","operationId":"surah_surah__sid__get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"script","in":"query","required":false,"schema":{"type":"string","pattern":"^(uthmani|simple|hemmat)$","default":"uthmani","title":"Script"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Surah"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}":{"get":{"tags":["text"],"summary":"Single ayah","operationId":"ayah_ayah__sid___aid__get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}},{"name":"script","in":"query","required":false,"schema":{"type":"string","pattern":"^(uthmani|simple|hemmat)$","default":"uthmani","title":"Script"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ayah"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}/window":{"get":{"tags":["text"],"summary":"Ayah with N words/ayahs of context on each side","operationId":"window_ayah__sid___aid__window_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}},{"name":"before","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":0,"title":"Before"}},{"name":"after","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":0,"title":"After"}},{"name":"unit","in":"query","required":false,"schema":{"type":"string","pattern":"^(words|ayahs)$","default":"words","title":"Unit"}},{"name":"cross_surah","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Cross Surah"}},{"name":"script","in":"query","required":false,"schema":{"type":"string","pattern":"^(uthmani|simple|hemmat)$","default":"uthmani","title":"Script"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WindowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/surah/{sid}/annotated":{"get":{"tags":["annotations"],"summary":"Canonical text + structured annotation layers for every ayah in a surah","operationId":"surah_annotated_surah__sid__annotated_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"edition","in":"query","required":false,"schema":{"type":"string","pattern":"^(uthmani|hemmat)$","default":"uthmani","title":"Edition"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnotatedSurah"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}/annotated":{"get":{"tags":["annotations"],"summary":"Canonical text + structured annotation layers for one ayah","operationId":"ayah_annotated_ayah__sid___aid__annotated_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}},{"name":"edition","in":"query","required":false,"schema":{"type":"string","pattern":"^(uthmani|hemmat)$","default":"uthmani","title":"Edition"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnotatedAyah"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}/similar":{"get":{"tags":["similar"],"summary":"Verses similar to a given ayah, with similarity scores","operationId":"similar_ayah__sid___aid__similar_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":10,"title":"Limit"}},{"name":"with_context","in":"query","required":false,"schema":{"type":"boolean","description":"Include surah name + ±context ayahs","default":false,"title":"With Context"},"description":"Include surah name + ±context ayahs"},{"name":"context_size","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":0,"default":2,"title":"Context Size"}},{"name":"script","in":"query","required":false,"schema":{"type":"string","pattern":"^(uthmani|simple|hemmat)$","default":"uthmani","title":"Script"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimilarResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/surah/{sid}/translation":{"get":{"tags":["translations"],"summary":"All ayah translations for a single translator in a surah","operationId":"surah_translation_surah__sid__translation_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"translator","in":"query","required":true,"schema":{"type":"string","description":"Translator id from /translators","title":"Translator"},"description":"Translator id from /translators"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SurahTranslationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/translators":{"get":{"tags":["translations"],"summary":"List available translators","operationId":"translators_translators_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Translator"},"type":"array","title":"Response Translators Translators Get"}}}}}}},"/ayah/{sid}/{aid}/translation":{"get":{"tags":["translations"],"summary":"Single translation for an ayah","operationId":"translation_ayah__sid___aid__translation_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}},{"name":"translator","in":"query","required":false,"schema":{"type":"string","description":"Translator id from /translators","default":"en.sahih","title":"Translator"},"description":"Translator id from /translators"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Translation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}/translations":{"get":{"tags":["translations"],"summary":"Multiple translations for one ayah","operationId":"translations_ayah__sid___aid__translations_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}},{"name":"translators","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated translator ids","title":"Translators"},"description":"Comma-separated translator ids"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationsBatch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/surah/{sid}/tajweed":{"get":{"tags":["tajweed"],"summary":"Tajweed-annotated HTML for every ayah in a surah","operationId":"surah_tajweed_surah__sid__tajweed_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SurahTajweedItem"},"title":"Response Surah Tajweed Surah  Sid  Tajweed Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}/tajweed":{"get":{"tags":["tajweed"],"summary":"Tajweed-annotated text for an ayah","operationId":"tajweed_ayah__sid___aid__tajweed_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(html|spans|both)$","default":"both","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TajweedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}/syntax.svg":{"get":{"tags":["syntax"],"summary":"Pre-rendered dependency-tree SVG (MASAQ output_v2). Labels are in Arabic.","operationId":"ayah_syntax_svg_ayah__sid___aid__syntax_svg_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}},{"name":"strip_font","in":"query","required":false,"schema":{"type":"boolean","description":"Drop the embedded Kitab @font-face block (use for export tools that fail on the embedded font)","default":false,"title":"Strip Font"},"description":"Drop the embedded Kitab @font-face block (use for export tools that fail on the embedded font)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}/syntax":{"get":{"tags":["syntax"],"summary":"I'rab / syntactic analysis per word-segment with localized tag descriptions","operationId":"ayah_syntax_ayah__sid___aid__syntax_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyntaxResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}/asbab":{"get":{"tags":["asbab"],"summary":"Asbab al-Nuzul (occasions of revelation) for an ayah","operationId":"asbab_ayah__sid___aid__asbab_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AsbabResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ayah/{sid}/{aid}/commentary":{"get":{"tags":["commentary"],"summary":"Commentaries (tafaseer) for an ayah, paginated and filterable","operationId":"list_commentary_ayah__sid___aid__commentary_get","parameters":[{"name":"sid","in":"path","required":true,"schema":{"type":"integer","title":"Sid"}},{"name":"aid","in":"path","required":true,"schema":{"type":"integer","title":"Aid"}},{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(fa|ar|en)$"},{"type":"null"}],"title":"Lang"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":30,"title":"Page Size"}},{"name":"sect","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sect"}},{"name":"century","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Century"}},{"name":"book","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Book"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lexicons":{"get":{"tags":["lexicon"],"summary":"List configured lexicons","operationId":"list_lexicons_lexicons_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/LexiconMeta"},"type":"array","title":"Response List Lexicons Lexicons Get"}}}}}}},"/lexicons/roots":{"get":{"tags":["lexicon"],"summary":"Distinct normalized roots, with alias variants and lexicon counts","operationId":"list_all_roots_lexicons_roots_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"only_non_empty","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Only Non Empty"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":150,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lexicons/{code}/roots":{"get":{"tags":["lexicon"],"summary":"Roots within one lexicon (paginated)","operationId":"list_roots_lexicons__code__roots_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":100,"title":"Page Size"}},{"name":"only_non_empty","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Only Non Empty"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lexicons/{code}/root/{root}":{"get":{"tags":["lexicon"],"summary":"Full entry for one (lexicon, root)","operationId":"get_entry_lexicons__code__root__root__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}},{"name":"root","in":"path","required":true,"schema":{"type":"string","title":"Root"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LexiconEntry"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lexicons/root/{root}":{"get":{"tags":["lexicon"],"summary":"Entries from EVERY lexicon for one root (alias-merged)","description":"Accept any orthographic variant; returns entries from every variant the\nDB knows about so a user typing ولي gets the same view as one typing ولى.","operationId":"get_root_across_lexicons_root__root__get","parameters":[{"name":"root","in":"path","required":true,"schema":{"type":"string","title":"Root"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/lexicons/search":{"get":{"tags":["lexicon"],"summary":"Search roots whose key or body contains q","operationId":"search_lexicons_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Q"}},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AnnotatedAyah":{"properties":{"surah":{"type":"integer","title":"Surah"},"ayah":{"type":"integer","title":"Ayah"},"verse_key":{"type":"string","title":"Verse Key"},"text":{"type":"string","title":"Text"},"tajweed":{"items":{"$ref":"#/components/schemas/TajweedSpan"},"type":"array","title":"Tajweed"},"words":{"items":{"$ref":"#/components/schemas/WordMorph"},"type":"array","title":"Words","default":[]},"ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page"}},"type":"object","required":["surah","ayah","verse_key","text","tajweed"],"title":"AnnotatedAyah"},"AnnotatedSurah":{"properties":{"meta":{"$ref":"#/components/schemas/SurahMeta"},"ayahs":{"items":{"$ref":"#/components/schemas/AnnotatedAyah"},"type":"array","title":"Ayahs"},"edition":{"type":"string","title":"Edition","default":"uthmani"}},"type":"object","required":["meta","ayahs"],"title":"AnnotatedSurah"},"AsbabOccasion":{"properties":{"surah":{"type":"integer","title":"Surah"},"ayahs":{"items":{"type":"integer"},"type":"array","title":"Ayahs","description":"Ayahs covered by this occasion"},"text":{"type":"string","title":"Text"}},"type":"object","required":["surah","ayahs","text"],"title":"AsbabOccasion"},"AsbabResponse":{"properties":{"verse_key":{"type":"string","title":"Verse Key"},"occasions":{"items":{"$ref":"#/components/schemas/AsbabOccasion"},"type":"array","title":"Occasions"}},"type":"object","required":["verse_key","occasions"],"title":"AsbabResponse"},"Ayah":{"properties":{"surah":{"type":"integer","title":"Surah"},"ayah":{"type":"integer","title":"Ayah"},"verse_key":{"type":"string","title":"Verse Key","description":"Format 'S:A'"},"text":{"type":"string","title":"Text"},"script":{"type":"string","enum":["uthmani","simple","hemmat"],"title":"Script"},"ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref","description":"Edition-specific full reference, e.g. '[حمد1] ص1' for Hemmat"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","description":"Edition-specific page number (numeric, for programmatic use)"}},"type":"object","required":["surah","ayah","verse_key","text","script"],"title":"Ayah"},"CommentaryItem":{"properties":{"id":{"type":"integer","title":"Id"},"book":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Book"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"sect":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sect"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"century":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Century"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"brief":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brief"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code"}},"type":"object","required":["id"],"title":"CommentaryItem"},"CommentaryResponse":{"properties":{"verse_key":{"type":"string","title":"Verse Key"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"items":{"items":{"$ref":"#/components/schemas/CommentaryItem"},"type":"array","title":"Items"}},"type":"object","required":["verse_key","total","page","page_size","items"],"title":"CommentaryResponse"},"CoreMeaning":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id"},"ar_def":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ar Def"},"fa_def":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fa Def"},"en_def":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"En Def"},"syntax_point":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Syntax Point"},"examples":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Examples"}},"type":"object","title":"CoreMeaning"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LexiconEntry":{"properties":{"lexicon":{"$ref":"#/components/schemas/LexiconMeta"},"root":{"type":"string","title":"Root"},"has_content":{"type":"boolean","title":"Has Content"},"core_meanings":{"items":{"$ref":"#/components/schemas/CoreMeaning"},"type":"array","title":"Core Meanings","default":[]},"derivatives":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Derivatives","default":[]},"raw":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw"}},"type":"object","required":["lexicon","root","has_content"],"title":"LexiconEntry"},"LexiconMeta":{"properties":{"code":{"type":"string","title":"Code"},"title_ar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Ar"},"title_fa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Fa"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"century_ah":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Century Ah"},"n_entries":{"type":"integer","title":"N Entries"}},"type":"object","required":["code","n_entries"],"title":"LexiconMeta"},"SimilarContextAyah":{"properties":{"ayah":{"type":"integer","title":"Ayah"},"text":{"type":"string","title":"Text"},"focal":{"type":"boolean","title":"Focal","default":false}},"type":"object","required":["ayah","text"],"title":"SimilarContextAyah"},"SimilarResponse":{"properties":{"verse_key":{"type":"string","title":"Verse Key"},"similar":{"items":{"$ref":"#/components/schemas/SimilarVerse"},"type":"array","title":"Similar"}},"type":"object","required":["verse_key","similar"],"title":"SimilarResponse"},"SimilarVerse":{"properties":{"verse_key":{"type":"string","title":"Verse Key"},"surah":{"type":"integer","title":"Surah"},"ayah":{"type":"integer","title":"Ayah"},"score":{"type":"number","title":"Score"},"surah_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Surah Name"},"context":{"anyOf":[{"items":{"$ref":"#/components/schemas/SimilarContextAyah"},"type":"array"},{"type":"null"}],"title":"Context"}},"type":"object","required":["verse_key","surah","ayah","score"],"title":"SimilarVerse"},"Surah":{"properties":{"meta":{"$ref":"#/components/schemas/SurahMeta"},"ayahs":{"items":{"$ref":"#/components/schemas/Ayah"},"type":"array","title":"Ayahs"}},"type":"object","required":["meta","ayahs"],"title":"Surah"},"SurahMeta":{"properties":{"id":{"type":"integer","title":"Id","description":"Surah number, 1..114"},"arabic_name":{"type":"string","title":"Arabic Name"},"transliteration":{"type":"string","title":"Transliteration"},"revelation_place":{"type":"string","enum":["meccan","medinan"],"title":"Revelation Place"},"revelation_order":{"type":"integer","title":"Revelation Order","description":"Chronological revelation order, 1..114"},"ayah_count":{"type":"integer","title":"Ayah Count"}},"type":"object","required":["id","arabic_name","transliteration","revelation_place","revelation_order","ayah_count"],"title":"SurahMeta"},"SurahTajweedItem":{"properties":{"verse_key":{"type":"string","title":"Verse Key"},"ayah":{"type":"integer","title":"Ayah"},"text_html":{"type":"string","title":"Text Html"}},"type":"object","required":["verse_key","ayah","text_html"],"title":"SurahTajweedItem"},"SurahTranslationItem":{"properties":{"ayah":{"type":"integer","title":"Ayah"},"text":{"type":"string","title":"Text"}},"type":"object","required":["ayah","text"],"title":"SurahTranslationItem"},"SurahTranslationResponse":{"properties":{"surah":{"type":"integer","title":"Surah"},"translator":{"type":"string","title":"Translator"},"items":{"items":{"$ref":"#/components/schemas/SurahTranslationItem"},"type":"array","title":"Items"}},"type":"object","required":["surah","translator","items"],"title":"SurahTranslationResponse"},"SyntaxResponse":{"properties":{"verse_key":{"type":"string","title":"Verse Key"},"segments":{"items":{"$ref":"#/components/schemas/SyntaxSegment"},"type":"array","title":"Segments"},"rows":{"items":{"$ref":"#/components/schemas/SyntaxRow"},"type":"array","title":"Rows","default":[]}},"type":"object","required":["verse_key","segments"],"title":"SyntaxResponse"},"SyntaxRow":{"properties":{"word_indices":{"items":{"type":"integer"},"type":"array","title":"Word Indices"},"height":{"type":"number","title":"Height","default":0.0}},"type":"object","required":["word_indices"],"title":"SyntaxRow"},"SyntaxSegment":{"properties":{"word_no":{"type":"integer","title":"Word No"},"segment_no":{"type":"integer","title":"Segment No"},"word":{"type":"string","title":"Word","default":""},"segment":{"type":"string","title":"Segment","default":""},"morph_tag":{"type":"string","title":"Morph Tag","default":""},"phrase":{"type":"string","title":"Phrase","default":""},"syntactic_role":{"type":"string","title":"Syntactic Role","default":""},"syntactic_role_desc":{"additionalProperties":true,"type":"object","title":"Syntactic Role Desc","default":{}},"phrasal_function":{"type":"string","title":"Phrasal Function","default":""},"phrasal_function_desc":{"additionalProperties":true,"type":"object","title":"Phrasal Function Desc","default":{}},"case_mood":{"type":"string","title":"Case Mood","default":""},"case_mood_desc":{"additionalProperties":true,"type":"object","title":"Case Mood Desc","default":{}},"gloss":{"type":"string","title":"Gloss","default":""}},"type":"object","required":["word_no","segment_no"],"title":"SyntaxSegment"},"TajweedResponse":{"properties":{"verse_key":{"type":"string","title":"Verse Key"},"text_html":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Html"},"text_plain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text Plain"},"spans":{"anyOf":[{"items":{"$ref":"#/components/schemas/TajweedSpan"},"type":"array"},{"type":"null"}],"title":"Spans"}},"type":"object","required":["verse_key"],"title":"TajweedResponse"},"TajweedSpan":{"properties":{"start":{"type":"integer","title":"Start","description":"Char offset in the plain (untagged) text"},"end":{"type":"integer","title":"End"},"rule":{"type":"string","title":"Rule"},"surface":{"type":"string","title":"Surface"}},"type":"object","required":["start","end","rule","surface"],"title":"TajweedSpan"},"Translation":{"properties":{"verse_key":{"type":"string","title":"Verse Key"},"translator":{"type":"string","title":"Translator"},"text":{"type":"string","title":"Text"}},"type":"object","required":["verse_key","translator","text"],"title":"Translation"},"TranslationsBatch":{"properties":{"verse_key":{"type":"string","title":"Verse Key"},"translations":{"items":{"$ref":"#/components/schemas/Translation"},"type":"array","title":"Translations"}},"type":"object","required":["verse_key","translations"],"title":"TranslationsBatch"},"Translator":{"properties":{"id":{"type":"string","title":"Id","description":"e.g. 'en.sahih'"},"language":{"type":"string","title":"Language","description":"ISO-ish prefix from filename: en, ar, id, ..."},"name":{"type":"string","title":"Name","description":"Translator/source short name from filename"}},"type":"object","required":["id","language","name"],"title":"Translator"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WindowResponse":{"properties":{"focal":{"$ref":"#/components/schemas/Ayah"},"before":{"items":{"$ref":"#/components/schemas/WordRef"},"type":"array","title":"Before"},"after":{"items":{"$ref":"#/components/schemas/WordRef"},"type":"array","title":"After"},"truncated_before":{"type":"boolean","title":"Truncated Before","description":"True if surah boundary was hit before reaching N"},"truncated_after":{"type":"boolean","title":"Truncated After"},"unit":{"type":"string","enum":["words","ayahs"],"title":"Unit"},"cross_surah":{"type":"boolean","title":"Cross Surah"}},"type":"object","required":["focal","before","after","truncated_before","truncated_after","unit","cross_surah"],"title":"WindowResponse"},"WordMorph":{"properties":{"index":{"type":"integer","title":"Index"},"root":{"type":"string","title":"Root","default":""},"lemma":{"type":"string","title":"Lemma","default":""},"pos":{"type":"string","title":"Pos","default":""}},"type":"object","required":["index"],"title":"WordMorph"},"WordRef":{"properties":{"surah":{"type":"integer","title":"Surah"},"ayah":{"type":"integer","title":"Ayah"},"position":{"type":"integer","title":"Position","description":"1-indexed word position in the ayah"},"text":{"type":"string","title":"Text"}},"type":"object","required":["surah","ayah","position","text"],"title":"WordRef"}}}}