Documentation Index
Fetch the complete documentation index at: https://rocks.docs.rive.wtf/llms.txt
Use this file to discover all available pages before exploring further.
Every API key is tied to one IP. To apply for a key, DM southctrl on Discord.
Use the endpoint path below, replace the required params, and send Authorization: Bearer YOUR_API_KEY.
Quick Start
Pick a translation
Use translation=web, kjv, niv, or another supported translation.
Call the random verse route
Send a request to /api/bible/random.
Use the verse data
Read the reference, verse text, book, chapter, and verse number from the response.
Good for verse-of-the-day commands, bots, and simple scripture apps.
Random Verse
Get a random Bible verse from various translations.
Endpoint
Query Parameters
Bible translation. Options: web, kjv, niv, etc.
Example Request
curl -X GET "https://rocks.rive.wtf/api/bible/random?translation=web" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://rocks.rive.wtf/api/bible/random?translation=kjv', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const data = await response.json();
console.log(data);
import requests
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {'translation': 'kjv'}
response = requests.get(
'https://rocks.rive.wtf/api/bible/random',
headers=headers,
params=params
)
print(response.json())
Example Response
{
"reference": "John 3:16",
"text": "For God so loved the world, that he gave his only begotten Son...",
"translation": "kjv",
"book": "John",
"chapter": 3,
"verse": 16
}
Available Translations
| Translation | Code |
|---|
| World English Bible | web |
| King James Version | kjv |
| New International Version | niv |
More translations may be available. Check the API response for supported options.
