Passages

Get Bible passages by reference. This is the most commonly used endpoint.

Get a Passage

Retrieve verses using a natural language reference.

GET /v1/passage

Query Parameters

Parameter	Type	Required	Description
ref	string	Yes	Bible reference (e.g., "John 3:16", "Psalm 23")
version	string	No	Version ID (defaults to "rvr60")

Reference Formats

The API accepts various reference formats:

Format	Example
Single verse	John 3:16
Verse range	Romans 8:28-30
Entire chapter	Psalm 23
Chapter range	Genesis 1-2
Spanish names	Juan 3:16, Salmo 23

Response

{
  "success": true,
  "data": {
    "reference": "Juan 3:16",
    "version": {
      "id": "rvr60",
      "name": "Reina-Valera 1960",
      "abbreviation": "RVR60"
    },
    "book": {
      "name": "Juan",
      "number": 43,
      "abbreviation": "JN"
    },
    "chapter": 3,
    "verse": 16,
    "text": "Porque de tal manera amó Dios al mundo, que ha dado a su Hijo unigénito, para que todo aquel que en él cree, no se pierda, mas tenga vida eterna."
  }
}

Examples

Single Verse

curl "https://api.apibiblia.com/v1/passage?ref=John%203:16&version=rvr60" \
  -H "X-API-Key: YOUR_API_KEY"

Verse Range

curl "https://api.apibiblia.com/v1/passage?ref=Romans%208:28-30" \
  -H "X-API-Key: YOUR_API_KEY"

Response for ranges includes an array of verses:

{
  "success": true,
  "data": {
    "reference": "Romanos 8:28-30",
    "verses": [
      { "verse": 28, "text": "Y sabemos que a los que aman a Dios..." },
      { "verse": 29, "text": "Porque a los que antes conoció..." },
      { "verse": 30, "text": "Y a los que predestinó..." }
    ]
  }
}

Entire Chapter

curl "https://api.apibiblia.com/v1/passage?ref=Psalm%2023" \
  -H "X-API-Key: YOUR_API_KEY"

Tips

URL Encoding

Remember to URL-encode spaces and special characters in references:

• John 3:16 → John%203:16
• 1 Juan 1:9 → 1%20Juan%201:9

Spanish vs English Names

Both Spanish and English book names work:

• John 3:16 = Juan 3:16
• Psalm 23 = Salmo 23