FeaturesTemplatesShowcaseTownie
AI
BlogDocsPricing
Log inSign up
project logo
cameronpakbible-sdk
Free Use Bible API TS SDK
Public
Like
bible-sdk
Home
Code
14
dist
2
.gitignore
.npmignore
.vtignore
AGENTS.md
LICENSE
README.md
bible-sdk.ts
deno.json
example.ts
openapi.json
package-lock.json
package.json
tsconfig.json
Branches
1
Pull requests
Remixes
History
Environment variables
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
README.md
Code
/
README.md
Search
…
README.md

Free Use Bible SDK

Add Bible text to your website or web app without having to worry about licensing and legal issues surrounding Bible text.

This is a type-safe Bible SDK to use in your web apps and websites.

Installation

npm install free-use-bible-sdk

Usage

Create val
import { FreeUseBibleSDK } from "free-use-bible-sdk"; const client = new FreeUseBibleSDK({ baseUrl: "https://bible.helloao.org/", }); const chapterResponse = await client.general.getChapterFromTranslation( "BSB", "Romans", 8, ); console.log(chapterResponse);

OpenAPI spec (created based on these docs) + apigen-ts = FreeUseBibleSDK

Bible text comes from the Free Use Bible API, generously provided by AO Lab.

API Overview

The SDK provides access to Bible translations and commentaries through the following methods:

Translations

  • getAvailableTranslations() - Get list of available Bible translations
  • getBooksForTranslation(translation: string) - Get books for a specific translation
  • getChapterFromTranslation(translation: string, book: string, chapter: number) - Get chapter content

Commentaries

  • getAvailableCommentaries() - Get list of available commentaries
  • getBooksForCommentary(commentary: string) - Get books for a commentary
  • getChapterFromCommentary(commentary: string, book: string, chapter: number) - Get commentary chapter
  • getProfilesForCommentary(commentary: string) - Get profiles for a commentary
  • getProfileFromCommentary(commentary: string, profile: string) - Get specific profile content

All methods return typed responses with full TypeScript support.

Let me know how I can make it better.

— Cam

Go to top
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Product
FeaturesPricing
Developers
DocsStatusAPI ExamplesNPM Package Examples
Explore
ShowcaseTemplatesNewest ValsTrending ValsNewsletter
Company
AboutBlogCareersBrandhi@val.town
Terms of usePrivacy policyAbuse contact
© 2025 Val Town, Inc.