Bible API Docs

Simple usage guide for reading verses in KJV and RVR1960.

1) Get API Key

Create account at portal/register.php, verify your email, then keep your key safe.

Send your key in header: X-API-Key: your_key_here

2) Endpoint Format

Single verse:

GET /api/{version}/{book}/{chapter}/{verse}

Range:

GET /api/{version}/{book}/{chapter}/{start}-{end}

3) Quick Examples

curl -H "X-API-Key: your_key_here" \
https://bible.riosav.com/api/kjv/genesis/1/1

curl -H "X-API-Key: your_key_here" \
https://bible.riosav.com/api/rvr1960/juan/3/16-17

4) Limits

Default accounts: 200 credits/day, 25 requests per 5-minute window, 1 credit per verse.

Unlimited accounts (set by admin): no daily credit cap.

{
  "status": "success",
  "version": "KJV",
  "language": "en",
  "book": "genesis",
  "chapter": 1,
  "verses": [{ "verse": 1, "text": "..." }],
  "credits_used": 1,
  "credits_remaining": 199
}