A simple module to get the Verse of the Day and any verse you would like.
Note I use
pnpm
in these examples.NPM
will also work if you don't have or want to installpnpm
First step is of course installing the module
pnpm install @glowstudent/youversion
const YouVersion = require("@glowstudent/youversion");
Note Version is not yet configurable
const YouVersion = require("@glowstudent/youversion");
(async () => {
console.log(await YouVersion.getVerseOfTheDay());
})();
{
"citation": "Hebrews 11:1 (NIV)",
"passage": "Now faith is confidence in what we hope for and assurance about what we do not see."
}
const YouVersion = require("@glowstudent/youversion");
(async () => {
console.log(await YouVersion.getVerse("John", "3", "16", "KJV"));
})();
{
"citation": "John 3:16 KJV",
"passage": "For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life."
}
Requests return a JSON object and a status code.
Good responses will return a JSON with a citation
and a passage
.
{
"citation": "John 3:16 NLT",
"passage": "For God so loved the world, that he gave his only begotten Son, that whosoever believeth in him should not perish, but have everlasting life."
}
If book
is not specified or cannot be read it will return an error.
{
"code": 400,
"message": "Missing field 'book'"
}
Trying to access a book that does not exist will prompt a similar response but with a different error message
{
"code": 400,
"message": "Could not find book 'Coffee' by name or alias."
}
Books and Aliases
Book | Alias |
---|---|
Genesis | GEN |
Exodus | EXO |
Leviticus | LEV |
Numbers | NUM |
Deuteronomy | DEU |
Joshua | JOS |
Judges | JDG |
Ruth | RUT |
1st Samuel | 1SA |
2nd Samuel | 2SA |
1st Kings | 1KI |
2nd Kings | 2KI |
1st Chronicles | 1CH |
2nd Chronicles | 2CH |
Ezra | EZR |
Nehemiah | NEH |
Esther | EST |
Job | JOB |
Psalms | PSA |
Proverbs | PRO |
Ecclesiastes | ECC |
Song of Songs | SNG |
Isaiah | ISA |
Jeremiah | JER |
Lamentations | LAM |
Ezekiel | EZK |
Daniel | DAN |
Hosea | HOS |
Joel | JOL |
Amos | AMO |
Obadiah | OBA |
Jonah | JON |
Micah | MIC |
Nahum | NAM |
Habakkuk | HAB |
Zephaniah | ZEP |
Haggai | HAG |
Zechariah | ZEC |
Malachi | MAL |
Matthew | MAT |
Mark | MRK |
Luke | LUK |
John | JHN |
Acts | ACT |
Romans | ROM |
1st Corinthians | 1CO |
2nd Corinthians | 2CO |
Galatians | GAL |
Ephesians | EPH |
Philippians | PHP |
Colossians | COL |
1st Thessalonians | 1TH |
2nd Thessalonians | 2TH |
1st Timothy | 1TI |
2nd Timothy | 2TI |
Titus | TIT |
Philemon | PHM |
Hebrews | HEB |
James | JAS |
1st Peter | 1PE |
2nd Peter | 2PE |
1st John | 1JN |
2nd John | 2JN |
3rd John | 3JN |
Jude | JUD |
Revelation | REV |
Versions
Versions | ID |
---|---|
AMP | 1588 |
ICL00D | 1196 |
KJV | 1 |
NIV | 111 |
NLT | 116 |
NR06 | 122 |
SCH2000 | 157 |
VULG | 823 |
THSV11 | 174 |
TNCV | 179 |
THAERV | 203 |
NODTHNT | 1907 |
NTV | 2744 |
ESV | 59 |
SBLG | 156 |
CCB | 36 |
Before creating an issue, please ensure that it hasn't already been reported/suggested.
This project is licensed under the terms of the MIT license.