# Bible API v1.0.0 A multi-translation Bible verse reference API with support for Czech and other languages. ## Endpoints ### Health Check GET /health - Check if the API is running ### Books GET /api/books - List all Bible books with their abbreviations ### Translations GET /api/translations - List all available Bible translations ### Get Verses GET /api/verse - Get verses by reference Query Parameters: - ref (required) - Bible reference (e.g., "Mt 1,2" or "Ž 23,1") - translation (optional) - Translation ID (default: "cs-csp") - requireExplicitVerses (optional) - If "true", requires explicit verse numbers ### Get Canonical References GET /api/canonical - Get canonical reference strings Query Parameters: - ref (required) - Bible reference (e.g., "Mt 1,2" or "Ž 23,1") - translation (optional) - Translation ID (for verse count in chapters) ## Examples Basic verse lookup: GET /api/verse?ref=Mt 1,2 Verse with specific translation: GET /api/verse?ref=Mt 1,2&translation=cs-csp Verse range: GET /api/verse?ref=Mt 1,2-5 Entire chapter: GET /api/verse?ref=Mt 1 Czech reference with diacritics: GET /api/verse?ref=Ž 23,1 List all books: GET /api/books List available translations: GET /api/translations Get canonical references: GET /api/canonical?ref=Mt 1,2 Get canonical reference range: GET /api/canonical?ref=Mt 1,2-4 ## Reference Format References support multiple formats: - Single verse: Mt 1,2 or Mt 1:2 - Verse range: Mt 1,2-5 - Entire chapter: Mt 1 - Czech book names: Ž 23,1 (Žalmy) - Numbered books: 1Jan 3,16 or 1. Jan 3,16 ## Available Translations ID Name Language -------- ----------------------- ---------- cs-csp Český studijní překlad Czech cs-b21 Bible 21 Czech