Book Codes.
Scripture endpoints identify books by their OSIS code — a three-character abbreviation shared across most Bible software, so if you already work with scripture references you very likely have these.
A book code goes straight into the path: /v2/scripture/JHN/3/16 is John 3:16. Codes are case-sensitive and always upper case. Where a different abbreviation is in common use we accept it as an alias when building the index, but the code in the column on the left is what comes back in responses.
| Code | Book | Testament | Chapters | Also accepted | Endpoint |
|---|---|---|---|---|---|
GEN | Genesis | Old Testament | 50 | — | /v2/scripture/GEN |
EXO | Exodus | Old Testament | 40 | — | /v2/scripture/EXO |
LEV | Leviticus | Old Testament | 27 | — | /v2/scripture/LEV |
NUM | Numbers | Old Testament | 36 | — | /v2/scripture/NUM |
DEU | Deuteronomy | Old Testament | 34 | — | /v2/scripture/DEU |
JOS | Joshua | Old Testament | 24 | — | /v2/scripture/JOS |
JDG | Judges | Old Testament | 21 | — | /v2/scripture/JDG |
RUT | Ruth | Old Testament | 4 | — | /v2/scripture/RUT |
1SA | 1 Samuel | Old Testament | 31 | — | /v2/scripture/1SA |
2SA | 2 Samuel | Old Testament | 24 | — | /v2/scripture/2SA |
1KI | 1 Kings | Old Testament | 22 | — | /v2/scripture/1KI |
2KI | 2 Kings | Old Testament | 25 | — | /v2/scripture/2KI |
1CH | 1 Chronicles | Old Testament | 29 | — | /v2/scripture/1CH |
2CH | 2 Chronicles | Old Testament | 36 | — | /v2/scripture/2CH |
EZR | Ezra | Old Testament | 10 | — | /v2/scripture/EZR |
NEH | Nehemiah | Old Testament | 13 | — | /v2/scripture/NEH |
EST | Esther | Old Testament | 10 | — | /v2/scripture/EST |
JOB | Job | Old Testament | 42 | — | /v2/scripture/JOB |
PSA | Psalms | Old Testament | 150 | PSM | /v2/scripture/PSA |
PRO | Proverbs | Old Testament | 31 | — | /v2/scripture/PRO |
ECC | Ecclesiastes | Old Testament | 12 | — | /v2/scripture/ECC |
SNG | Song of Solomon | Old Testament | 8 | SOS, SS | /v2/scripture/SNG |
ISA | Isaiah | Old Testament | 66 | — | /v2/scripture/ISA |
JER | Jeremiah | Old Testament | 52 | — | /v2/scripture/JER |
LAM | Lamentations | Old Testament | 5 | — | /v2/scripture/LAM |
EZK | Ezekiel | Old Testament | 48 | — | /v2/scripture/EZK |
DAN | Daniel | Old Testament | 12 | — | /v2/scripture/DAN |
HOS | Hosea | Old Testament | 14 | — | /v2/scripture/HOS |
JOL | Joel | Old Testament | 3 | JOE | /v2/scripture/JOL |
AMO | Amos | Old Testament | 9 | — | /v2/scripture/AMO |
OBA | Obadiah | Old Testament | 1 | — | /v2/scripture/OBA |
JON | Jonah | Old Testament | 4 | — | /v2/scripture/JON |
MIC | Micah | Old Testament | 7 | — | /v2/scripture/MIC |
NAM | Nahum | Old Testament | 3 | NAH | /v2/scripture/NAM |
HAB | Habakkuk | Old Testament | 3 | — | /v2/scripture/HAB |
ZEP | Zephaniah | Old Testament | 3 | — | /v2/scripture/ZEP |
HAG | Haggai | Old Testament | 2 | — | /v2/scripture/HAG |
ZEC | Zechariah | Old Testament | 14 | — | /v2/scripture/ZEC |
MAL | Malachi | Old Testament | 4 | — | /v2/scripture/MAL |
MAT | Matthew | New Testament | 28 | — | /v2/scripture/MAT |
MRK | Mark | New Testament | 16 | MK | /v2/scripture/MRK |
LUK | Luke | New Testament | 24 | — | /v2/scripture/LUK |
JHN | John | New Testament | 21 | — | /v2/scripture/JHN |
ACT | Acts | New Testament | 28 | — | /v2/scripture/ACT |
ROM | Romans | New Testament | 16 | — | /v2/scripture/ROM |
1CO | 1 Corinthians | New Testament | 16 | — | /v2/scripture/1CO |
2CO | 2 Corinthians | New Testament | 13 | — | /v2/scripture/2CO |
GAL | Galatians | New Testament | 6 | — | /v2/scripture/GAL |
EPH | Ephesians | New Testament | 6 | — | /v2/scripture/EPH |
PHP | Philippians | New Testament | 4 | PHIL | /v2/scripture/PHP |
COL | Colossians | New Testament | 4 | — | /v2/scripture/COL |
1TH | 1 Thessalonians | New Testament | 5 | — | /v2/scripture/1TH |
2TH | 2 Thessalonians | New Testament | 3 | — | /v2/scripture/2TH |
1TI | 1 Timothy | New Testament | 6 | — | /v2/scripture/1TI |
2TI | 2 Timothy | New Testament | 4 | — | /v2/scripture/2TI |
TIT | Titus | New Testament | 3 | — | /v2/scripture/TIT |
PHM | Philemon | New Testament | 1 | — | /v2/scripture/PHM |
HEB | Hebrews | New Testament | 13 | — | /v2/scripture/HEB |
JAS | James | New Testament | 5 | — | /v2/scripture/JAS |
1PE | 1 Peter | New Testament | 5 | — | /v2/scripture/1PE |
2PE | 2 Peter | New Testament | 3 | — | /v2/scripture/2PE |
1JN | 1 John | New Testament | 5 | — | /v2/scripture/1JN |
2JN | 2 John | New Testament | 1 | — | /v2/scripture/2JN |
3JN | 3 John | New Testament | 1 | — | /v2/scripture/3JN |
JUD | Jude | New Testament | 1 | — | /v2/scripture/JUD |
REV | Revelation | New Testament | 22 | — | /v2/scripture/REV |
The same codes are used by the Bible endpoints: /v2/bible/BSB/JHN/3.json is John 3 in the Berean Standard Bible. Note that a few translations in the corpus include deuterocanonical books beyond these sixty-six; /v2/bible/{translation}/books.json is authoritative for what a given translation actually contains.