Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/alfonsoolavarria/florilegio/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint is the primary data source for Florilegio’s Bible study interface. It operates in two distinct modes controlled by the tipo parameter: modo biblia returns the plain text of all verses in a given chapter from one of the stored Bible versions, while modo estudio returns a word-by-word interlinear analysis — Greek morphology (RMAC codes, Nida numbers, Strong’s references) for New Testament books and Hebrew morphology (OSHB codes, morph codes, Strong’s references) for Old Testament books.

​
Endpoint

GET /api/versiculo/
Rate limit: 200 requests / minute per IP

​
Query Parameters

​
tipo
string
required
Mode selector. Use "estudio" for interlinear word-by-word data or "biblia" for plain verse text of an entire chapter.
​
libro
integer
required
Bible book number, 1–66. Genesis = 1, Psalms = 19, Matthew = 40, Revelation = 66.
​
capitulo
integer
required
Chapter number within the selected book.
​
versiculo
integer
Verse number. Required when tipo=estudio; ignored when tipo=biblia.
​
version
string
default:"rv1960"
Bible version for plain text display. Accepted values: rv1960, nbla, ntv, rvr09. Has no effect in tipo=estudio mode — the interlinear data is sourced from the OGNT (Greek) and OSHB (Hebrew) databases regardless of this parameter, although the texto_rv1960 companion field always returns the RV1960 text for the requested verse.

​
Response: Modo biblia

When tipo=biblia, the endpoint returns all verses of the specified chapter from the chosen version as an ordered array. 
{
  "status": "success",
  "modo": "biblia",
  "data": [
    {"versiculo": 1, "texto": "En el principio creó Dios los cielos y la tierra."},
    {"versiculo": 2, "texto": "Y la tierra estaba desordenada y vacía..."}
  ]
}
​
status
string
Always "success" on a successful response.
​
modo
string
Always "biblia" when tipo=biblia was requested.
​
data
array
Ordered array of verse objects for the requested chapter. Each object contains versiculo (integer) and texto (string).

​
Response: Modo estudio — NT (Griego, libros 40–66)

When tipo=estudio is requested for a New Testament book (libro ≥ 40), the endpoint returns per-word Greek morphological data sourced from the OGNT dataset. 
{
  "status": "success",
  "modo": "estudio",
  "idioma": "griego",
  "texto_rv1960": "En el principio era el Verbo...",
  "data": [
    {
      "idioma": "griego",
      "ognt_sort": "400010010010",
      "espanol": "En",
      "griego": "Ἐν",
      "raiz_griega": "ἐν",
      "rmac": "P",
      "descripcion_rmac": "preposition",
      "low_nida_number": "83.13",
      "strong": "G1722",
      "hebreo": "",
      "raiz_hebrea": "",
      "morph_code": ""
    }
  ]
}
​
idioma
string
Always "griego" for NT books.
​
texto_rv1960
string
The RV1960 text of the requested verse, fetched from VersiculoBiblia. Empty string if no RV1960 record exists.
​
data
array
Ordered array of word objects. Each word corresponds to one entry in PalabraBiblia joined with its TraduccionLiteral and Morfologia relations. Words are ordered by ognt_sort.Key fields per word: ognt_sort (primary key), espanol (Spanish gloss), griego (Greek surface form), raiz_griega (lexical root), rmac (Robinson’s Morphological Analysis Code), descripcion_rmac (human-readable RMAC description), low_nida_number (Louw-Nida semantic domain), strong (Strong’s reference, e.g. "G1722"). The hebreo, raiz_hebrea, and morph_code fields are always empty strings for Greek words.

​
Response: Modo estudio — OT (Hebreo, libros 1–39)

When tipo=estudio is requested for an Old Testament book (libro ≤ 39), the endpoint returns per-word Hebrew morphological data sourced from the OSHB dataset. 
{
  "status": "success",
  "modo": "estudio",
  "idioma": "hebreo",
  "texto_rv1960": "En el principio creó Dios...",
  "data": [
    {
      "idioma": "hebreo",
      "oshb_id": "Gen.1.1.1",
      "espanol": "en el principio",
      "hebreo": "בְּרֵאשִׁ֖ית",
      "raiz_hebrea": "רֵאשִׁית",
      "morph_code": "HR/Ncfsa",
      "descripcion_morfologia": "preposición, sustantivo: femenino, singular, absoluto",
      "strong": "H7225",
      "rmac": "",
      "descripcion_rmac": "",
      "low_nida_number": "",
      "griego": ""
    }
  ]
}
​
idioma
string
Always "hebreo" for OT books.
​
data
array
Ordered array of word objects sourced from PalabraHebreo joined with TraduccionHebreo and MorfologiaHebreo, sorted by orden. Key fields per word: oshb_id (OSHB primary key, e.g. "Gen.1.1.1"), espanol (Spanish gloss), hebreo (Hebrew surface form with vowel points), raiz_hebrea (lexical root), morph_code (raw OSHB morphology code, e.g. "HR/Ncfsa"), descripcion_morfologia (Spanish human-readable description computed by the describir_morfologia_hebrea parser), strong (Strong’s reference, e.g. "H7225"). The rmac, descripcion_rmac, low_nida_number, and griego fields are always empty strings for Hebrew words.

​
Errores comunes

HTTP StatusCondition
400libro or capitulo query parameter is missing
400tipo=estudio requested without a versiculo parameter
500Unhandled internal exception; message contains the exception text
{"status": "error", "message": "Faltan parametros requeridos (libro, capitulo)."}
The language of the interlinear data is determined automatically by book number. Books 1–39 (Old Testament) always return Hebrew morphology from the OSHB dataset; books 40–66 (New Testament) always return Greek morphology from the OGNT dataset. The version query parameter only affects the texto_rv1960 companion field and has no influence on which morphological dataset is used.

Build docs developers (and LLMs) love

Get started for freeTalk to us