Bible Master Api Service

Bible Master Api Service is an API designed for retrieving various passages, verses, chapters, and books from the Bible. Built with FastAPI, it offers endpoints for listing all books in the Bible, retrieving chapters by book name, getting verses by book and chapter, searching verses, and even getting random verses either from specific books or from any book in the Bible.

Features

• List All Books: Retrieve a list of all unique book names in the Bible.
• Get Chapters By Book: Given a book name, fetch a list of all chapters in that book.
• Get Verses By Book And Chapter: Access verses from a specific chapter in a given book.
• Search Verses: Search the Bible for verses containing specific text.
• Get Random Verse: Grab a random verse from the Bible.
• Get Random Verse From Specific Books: Obtain a random verse from a list of specified books.
• Health Check Endpoint: Check the health of the API.

Endpoints

List All Books

• GET /books

Get Chapters By Book

• GET /books/{book_name}/chapters

Get Verses By Book And Chapter

• GET /books/{book_name}/chapters/{chapter_no}/verses

Search Verses

• GET /search/

Get Random Verse From Books

• POST /verse/random

  • Body: {"book_names": ["Genesis", "Exodus"]}

Get Random Verse

• GET /verse/randomall

Health Check

• GET /healthcheck

Responses and Error Handling

Success responses will return a varying JSON structure depending on the endpoint. In case of errors, such as when specified books, chapters, or verses cannot be found, or if input validations fail, the API responds with a standardized HTTPValidationError response detailing the issues encountered.

Example Usage

Request

GET /books/{book_name}/chapters/{chapter_no}/verses

Response

[
  {
    "verse": "1",
    "text": "In the beginning, God created the heavens and the earth."
  },
  ...
]