YouVersion-API

A simple module to get the Verse of the Day and any verse you would like.

Installation

Note I use pnpm in these examples. NPM will also work if you don't have or want to install pnpm

First step is of course installing the module

pnpm install @glowstudent/youversion

Usage

Import the library

const YouVersion = require("@glowstudent/youversion");

Getting the verse of the day:

Note The default language is English

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."
}

Getting the verse of the day in a different language:

You can specify a single or multiple languages by passing them as a string separated by a comma. The languages must be in the format of the ISO 639-1 code. For example, en for English, es for Spanish, fr for French, and de for German. It will return the first language that is available. If the language is not available it will move on to the next language in the list.

Single language:

const YouVersion = require("@glowstudent/youversion");

(async () => {
  console.log(await YouVersion.getVerseOfTheDay("sk"));
})();

Multiple languages:

const YouVersion = require("@glowstudent/youversion");

(async () => {
  console.log(await YouVersion.getVerseOfTheDay("es, fr, de"));
})();

Getting any verse:

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."
}

---

Responses

Requests return a JSON object and a status code.

Good Respsonses

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."
}

Bad Responses

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

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

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

Links

• GitHub
• npm
• Discord

Contributing

Before creating an issue, please ensure that it hasn't already been reported/suggested.

License

This project is licensed under the terms of the MIT license.