{"id":29721954,"url":"https://github.com/glowstudent777/youversion-api","last_synced_at":"2025-07-24T16:26:27.930Z","repository":{"id":130957699,"uuid":"611006331","full_name":"Glowstudent777/YouVersion-API","owner":"Glowstudent777","description":"Express Rest API for getting verses and such from YouVersion.","archived":false,"fork":false,"pushed_at":"2025-06-04T03:15:11.000Z","size":221,"stargazers_count":72,"open_issues_count":3,"forks_count":16,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-07-19T05:37:58.459Z","etag":null,"topics":["api","bible","bible-api","expressjs","rest-api","youversion"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Glowstudent777.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"Glowstudent","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-03-07T23:07:24.000Z","updated_at":"2025-07-19T00:54:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"d1ef621c-a479-417d-87f2-3bf81e72f459","html_url":"https://github.com/Glowstudent777/YouVersion-API","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Glowstudent777/YouVersion-API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Glowstudent777%2FYouVersion-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Glowstudent777%2FYouVersion-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Glowstudent777%2FYouVersion-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Glowstudent777%2FYouVersion-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Glowstudent777","download_url":"https://codeload.github.com/Glowstudent777/YouVersion-API/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Glowstudent777%2FYouVersion-API/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266871223,"owners_count":23998257,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","bible","bible-api","expressjs","rest-api","youversion"],"created_at":"2025-07-24T16:26:22.172Z","updated_at":"2025-07-24T16:26:27.917Z","avatar_url":"https://github.com/Glowstudent777.png","language":"TypeScript","funding_links":["https://ko-fi.com/Glowstudent"],"categories":[],"sub_categories":[],"readme":"# YouVersion-API\n\nExpress Rest API for getting verses and such from YouVersion.\n\n# Cloning\n\nBecause this project uses submodules, you'll need to clone it with the `--recurse` flag.\n\n```bash\ngit clone --recurse https://github.com/Glowstudent777/YouVersion-API.git \u0026\u0026 cd YouVersion-API\n```\n\n# Building and Running\n\n\u003e **Note**\n\u003e I use `pnpm` in these examples. `NPM` will also work if you don't have or want to install `pnpm`\n\n```bash\npnpm i \u0026\u0026 pnpm run build\n```\n\n## Running\n\nAnd to run use\n\n```bash\npnpm run start\n```\n\n# Making Requests\n\n| Query   | Default | Required | Example     |\n| ------- | ------- | -------- | ----------- |\n| book    | None    | true     | John or JHN |\n| chapter | 1       | false    | 7 or 10     |\n| verses  | 1       | false    | 1-3 or 7-10 |\n| version | NIV     | false    | KJV or NLT  |\n\n## Examples\n\nGets `John 1:1 NIV`\n\n```\nhttps://serverAddress.com/api/v1/verse?book=John\n```\n\n\u003cbr\u003e\n\nGets `John 3:16 NLT`\n\n```\nhttps://serverAddress.com/api/v1/verse?book=John\u0026chapter=3\u0026verses=16\u0026version=NLT\n```\n\n---\n\n## Responses\n\nRequests return a JSON object and a status code.\n\n### Good Responses\n\nA good API call responds with a `200 OK` and the requested verse(s).\n\n```json\n{\n  \"citation\": \"John 3:16 NLT\",\n  \"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.\"\n}\n```\n\n\u003cbr\u003e\n\nChecking the API status is pretty simple, just make a request to the following route and if everything is fine it'll respond with a `200 OK` and no JSON object.\n\n```\nhttps://serverAddress.com/api/v1/status\n```\n\n### Bad Responses\n\nIf no book is specified in the query, it will prompt a `400 Bad Response` and an error message\n\n```json\n{\n  \"code\": 400,\n  \"message\": \"Missing field 'book'\"\n}\n```\n\n\u003cbr\u003e\n\nTrying to access a book that does not exist will prompt a similar `400 Bad Response` but with a different error message\n\n```json\n{\n  \"code\": 400,\n  \"message\": \"Could not find book 'Coffee' by name or alias.\"\n}\n```\n\n# Options and Queries\n\n\u003cdetails\u003e\n\u003csummary\u003eBooks and Aliases\u003c/summary\u003e\n\n| Book              | Alias |\n| ----------------- | ----- |\n| Genesis           | GEN   |\n| Exodus            | EXO   |\n| Leviticus         | LEV   |\n| Numbers           | NUM   |\n| Deuteronomy       | DEU   |\n| Joshua            | JOS   |\n| Judges            | JDG   |\n| Ruth              | RUT   |\n| 1st Samuel        | 1SA   |\n| 2nd Samuel        | 2SA   |\n| 1st Kings         | 1KI   |\n| 2nd Kings         | 2KI   |\n| 1st Chronicles    | 1CH   |\n| 2nd Chronicles    | 2CH   |\n| Ezra              | EZR   |\n| Nehemiah          | NEH   |\n| Esther            | EST   |\n| Job               | JOB   |\n| Psalms            | PSA   |\n| Proverbs          | PRO   |\n| Ecclesiastes      | ECC   |\n| Song of Songs     | SNG   |\n| Isaiah            | ISA   |\n| Jeremiah          | JER   |\n| Lamentations      | LAM   |\n| Ezekiel           | EZK   |\n| Daniel            | DAN   |\n| Hosea             | HOS   |\n| Joel              | JOL   |\n| Amos              | AMO   |\n| Obadiah           | OBA   |\n| Jonah             | JON   |\n| Micah             | MIC   |\n| Nahum             | NAM   |\n| Habakkuk          | HAB   |\n| Zephaniah         | ZEP   |\n| Haggai            | HAG   |\n| Zechariah         | ZEC   |\n| Malachi           | MAL   |\n| Matthew           | MAT   |\n| Mark              | MRK   |\n| Luke              | LUK   |\n| John              | JHN   |\n| Acts              | ACT   |\n| Romans            | ROM   |\n| 1st Corinthians   | 1CO   |\n| 2nd Corinthians   | 2CO   |\n| Galatians         | GAL   |\n| Ephesians         | EPH   |\n| Philippians       | PHP   |\n| Colossians        | COL   |\n| 1st Thessalonians | 1TH   |\n| 2nd Thessalonians | 2TH   |\n| 1st Timothy       | 1TI   |\n| 2nd Timothy       | 2TI   |\n| Titus             | TIT   |\n| Philemon          | PHM   |\n| Hebrews           | HEB   |\n| James             | JAS   |\n| 1st Peter         | 1PE   |\n| 2nd Peter         | 2PE   |\n| 1st John          | 1JN   |\n| 2nd John          | 2JN   |\n| 3rd John          | 3JN   |\n| Jude              | JUD   |\n| Revelation        | REV   |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eVersions\u003c/summary\u003e\n\n| Versions | ID   |\n| -------- | ---- |\n| AMP      | 1588 |\n| ICL00D   | 1196 |\n| KJV      | 1    |\n| NIV      | 111  |\n| NLT      | 116  |\n| NR06     | 122  |\n| VULG     | 823  |\n\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglowstudent777%2Fyouversion-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglowstudent777%2Fyouversion-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglowstudent777%2Fyouversion-api/lists"}