Skip to main content

Random Verse

Get a random Bible verse from various translations.

Endpoint

GET /api/bible/random

Query Parameters

translation
string
default:"web"
Bible translation to use. Options: web, kjv, niv, etc.

Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/bible/random?translation=web" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
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);
Python
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())

Response Example

{
  "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

TranslationCode
World English Bibleweb
King James Versionkjv
New International Versionniv
More translations may be available. Check the API response for supported options.