{"openapi":"3.1.0","info":{"title":"Sovereign Logos Scripture API","version":"1.0.0","description":"Verbatim public-domain scripture with the Septuagint Old Testament. Anonymous, rate limited per IP. Link the citation url when quoting. MCP endpoint: https://sovereignlogos.com/api/mcp"},"servers":[{"url":"https://sovereignlogos.com/api/v1/scripture"}],"paths":{"/passage":{"get":{"operationId":"getPassage","summary":"One passage, up to 200 verses","parameters":[{"name":"ref","in":"query","required":true,"schema":{"type":"string","maxLength":80},"examples":{"verse":{"value":"John 3:16"},"psalm":{"value":"Psalm 23"},"range":{"value":"Genesis 1:1-2:3"}}},{"name":"translation","in":"query","schema":{"type":"string","enum":["geneva-1560","lxx-brenton","lxx2012","kjv","web","geneva-1599","charles-1917"],"default":"lxx2012"}},{"name":"psalmNumbering","in":"query","description":"mt = Masoretic/KJV Psalm numbers (converted for Septuagint translations); native = the translation's own.","schema":{"type":"string","enum":["mt","native"],"default":"mt"}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","md"],"default":"json"}}],"responses":{"200":{"description":"Passage","content":{"application/json":{"schema":{"type":"object","properties":{"reference":{"type":"string","description":"In the translation's own numbering."},"requested":{"type":"string"},"book":{"type":"string"},"translation":{"type":"object"},"verses":{"type":"array","items":{"type":"object","required":["chapter","verse","text"],"properties":{"chapter":{"type":"integer"},"verse":{"type":"integer"},"text":{"type":"string"}}}},"citation":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"translation":{"type":"string"},"licence":{"type":"string"}}},"notes":{"type":"array","items":{"type":"string"}}}}},"text/markdown":{}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","detail"],"properties":{"error":{"type":"string"},"detail":{"type":"string"},"allowed":{"type":"array","items":{"type":"string"}}}}}}},"404":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","detail"],"properties":{"error":{"type":"string"},"detail":{"type":"string"},"allowed":{"type":"array","items":{"type":"string"}}}}}}}}}},"/compare":{"get":{"operationId":"compareTranslations","summary":"One reference across 2 to 6 translations","parameters":[{"name":"ref","in":"query","required":true,"schema":{"type":"string","maxLength":80},"examples":{"verse":{"value":"John 3:16"},"psalm":{"value":"Psalm 23"},"range":{"value":"Genesis 1:1-2:3"}}},{"name":"translations","in":"query","description":"Comma-separated codes","schema":{"type":"string","default":"lxx2012,kjv"}},{"name":"psalmNumbering","in":"query","description":"mt = Masoretic/KJV Psalm numbers (converted for Septuagint translations); native = the translation's own.","schema":{"type":"string","enum":["mt","native"],"default":"mt"}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","md"],"default":"json"}}],"responses":{"200":{"description":"Comparison","content":{"application/json":{"schema":{"type":"object","properties":{"requested":{"type":"string"},"passages":{"type":"array","items":{"type":"object","properties":{"reference":{"type":"string","description":"In the translation's own numbering."},"requested":{"type":"string"},"book":{"type":"string"},"translation":{"type":"object"},"verses":{"type":"array","items":{"type":"object","required":["chapter","verse","text"],"properties":{"chapter":{"type":"integer"},"verse":{"type":"integer"},"text":{"type":"string"}}}},"citation":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"translation":{"type":"string"},"licence":{"type":"string"}}},"notes":{"type":"array","items":{"type":"string"}}}}},"unavailable":{"type":"array","items":{"type":"object"}},"notes":{"type":"array","items":{"type":"string"}}}}},"text/markdown":{}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","detail"],"properties":{"error":{"type":"string"},"detail":{"type":"string"},"allowed":{"type":"array","items":{"type":"string"}}}}}}},"404":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","detail"],"properties":{"error":{"type":"string"},"detail":{"type":"string"},"allowed":{"type":"array","items":{"type":"string"}}}}}}}}}},"/search":{"get":{"operationId":"searchScripture","summary":"Phrase search in one translation","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":100}},{"name":"translation","in":"query","schema":{"type":"string","enum":["geneva-1560","lxx-brenton","lxx2012","kjv","web","geneva-1599","charles-1917"],"default":"lxx2012"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Hits in canonical order"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","detail"],"properties":{"error":{"type":"string"},"detail":{"type":"string"},"allowed":{"type":"array","items":{"type":"string"}}}}}}}}}},"/translations":{"get":{"operationId":"listTranslations","summary":"Available translations with provenance","responses":{"200":{"description":"Translations"}}}},"/books":{"get":{"operationId":"listBooks","summary":"Books in canonical order","parameters":[{"name":"translation","in":"query","schema":{"type":"string","enum":["geneva-1560","lxx-brenton","lxx2012","kjv","web","geneva-1599","charles-1917"]}}],"responses":{"200":{"description":"Books"},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","detail"],"properties":{"error":{"type":"string"},"detail":{"type":"string"},"allowed":{"type":"array","items":{"type":"string"}}}}}}}}}}}}