Open REST API

Runyankole
Bible API

Free, public access to the Baibuli Erikwera 1964 — 66 books, 31,106 verses in Runyankore-Rukiga.

Free to use No auth required 31,106 verses CORS enabled

Base URL https://runyankole-bible-api.vercel.app

Endpoints

GET

/api/books List all 66 books

Returns all books in canonical order with their IDs and Runyankole names.

Example response

{
  "count": 66,
  "books": [
    { "id": 10, "short_name": "Kut", "long_name": "Okutandika" }
  ]
}

Try it

GET

/api/verse?book=10&chapter=1&verse=1 Fetch a single verse

Parameter	Type	Required	Description
book	integer	required	Book ID — get IDs from /api/books
chapter	integer	required	Chapter number
verse	integer	required	Verse number

Try it

GET

/api/chapter?book=10&chapter=1 Fetch all verses in a chapter

Parameter	Type	Required	Description
book	integer	required	Book ID
chapter	integer	required	Chapter number

Try it

GET

/api/search?q=Ruhanga Search verses by keyword

Parameter	Type	Required	Description
q	string	required	Search term in Runyankole (min 2 chars)
limit	integer	optional	Results per page, max 100 (default: 20)
offset	integer	optional	Pagination offset (default: 0)

Try it

GET

/api/random Get a random verse

Parameter	Type	Required	Description
book	integer	optional	Limit random to a specific book

Try it

Book IDs follow the standard numeric scheme — Genesis is 10, Revelation is 730. Use /api/books to get the full list.

All responses are JSON. CORS is enabled — call this API from any browser, app, or server.