FeaturesTemplatesShowcaseTownie
AI
BlogDocsPricing
Log inSign up
project logo
cameronpakbible-sdk
Free Use Bible API TS SDK
Public
Like
bible-sdk
Home
Code
13
dist
2
.gitignore
.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
9/11/2025
Viewing readonly version of main branch: v45
View latest version
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
FeaturesCLIAI agentsCode intelligenceSlack integrationsGTMPricing
Developers
DocsStatusAPI ExamplesNPM Package Examples
Explore
ShowcaseTemplatesNewest ValsTrending ValsNewsletter
Company
AboutBlogCareersBrandhi@val.town
Terms of usePrivacy policyAbuse contact
© 2025 Val Town, Inc.