Spirit Nation API

Text licenses and attribution

Public-domain editions and licensed editions are labelled separately. Responses containing licensed text include the copyright credit, source URL, license link and a change notice in the translation rights metadata. Retain those notices when reusing the text. Literal Standard Version rendering contributions use CC BY-SA 4.0; the Boyd reading edition uses CC BY 4.0 and a distinct adapted title.

API plans and request limits cover access to the hosted service. They do not narrow the source text license or charge for permission already granted by that license. The original distributor links remain available in each translation profile. Separate images and website materials are not included in the translated-text license.

Use Apocrypha and early writings in your app

Build a reader or reference tool from the editions that actually contain each work. Start with /api/v1/translations, then /api/v1/books?translation=EDITION_SLUG. The book list tells you which books and printed pages or chapters that edition provides. Browse the library to check an edition before you build around it.

For example, the library has 1 Enoch in R. H. Charles's 1913 edition. This request asks for its first available printed page:

curl -H "Authorization: Bearer YOUR_KEY" "https://spiritnation.loganpendragonforge.com/api/v1/text/enoch-charles-1913/1-enoch/188"

The JSON response contains meta, reference_system, translation, book, chapter and data. Read reference_system.chapter_label before calling the number a chapter; this edition uses printed pages. The data array contains the text records for that page. If a book is absent from an edition, choose another edition rather than assuming every work has the same coverage.

Keep the edition's source and rights notices with reused text. Read the licensing notes, check access plans, and use the endpoint guide for response details and limits. API requests need an active key from a plan or an approved exception; browsing the website does not require one.

Endpoints

Approved API keys can request translation metadata, book lists, chapter lists, chapter text, individual verses where supported, verse ranges, search results, and word-study data. Use JSON responses for scripture readers, widgets, reference tools, and study applications.

Use `/api/v1/text/...`, `/api/v1/study/...`, and `/api/v1/morphology/...` for new integrations. The direct `/api/v1/{translation}/...` routes remain active as compatibility aliases.

An OpenAPI-style endpoint catalog is available at `/api/v1/openapi`. Approved keys can check quota and tier status at `/api/v1/key`.

New text, study, and morphology responses include a `meta` envelope with API version, preferred namespaces, and data-policy notes. Generated or rule-aligned morphology is always labeled; only tokens with `verified_by_spirit_nation: true` should be treated as manually reviewed.

Send approved keys as `Authorization: Bearer YOUR_KEY`, `X-Spirit-Nation-Key`, or `?key=YOUR_KEY`.

curl -H "X-Spirit-Nation-Key: YOUR_KEY" \
  "https://spiritnation.loganpendragonforge.com/api/v1/text/kjv/genesis/1/1"

const res = await fetch("https://spiritnation.loganpendragonforge.com/api/v1/study/kjv/john/1/1", {
  headers: { "X-Spirit-Nation-Key": "YOUR_KEY" }
});
const data = await res.json();

$response = file_get_contents("https://spiritnation.loganpendragonforge.com/api/v1/source-coverage", false, stream_context_create([
  "http" => ["header" => "X-Spirit-Nation-Key: YOUR_KEY\r\n"]
]));

const spiritNation = {
  baseUrl: "https://spiritnation.loganpendragonforge.com/api/v1",
  key: "YOUR_KEY",
  async get(path) {
    const res = await fetch(`${this.baseUrl}${path}`, {
      headers: { "X-Spirit-Nation-Key": this.key }
    });
    if (!res.ok) throw await res.json();
    return res.json();
  }
};

const verse = await spiritNation.get("/text/kjv/psalms/23/1");
const study = await spiritNation.get("/study/kjv/genesis/1/1?verified_only=1");

{
  "meta": {
    "api_version": "v1",
    "endpoint": "study.verse",
    "data_policy": {
      "readable_text": "Public-domain and explicitly licensed editions; per-edition rights apply.",
      "generated_morphology": "Generated data is labeled until verified."
    }
  },
  "translation": {"slug": "kjv", "abbreviation": "KJV"},
  "book": {"slug": "genesis", "name": "Genesis"},
  "source_panels": []
}

Latin Vulgate morphology is backed by GreLa v0.7 / latin-lemmatized-texts annotations under CC BY-SA 4.0. Preserve attribution when using source-study data outside Spirit Nation. Syriac/Peshitta morphology combines Apache-2.0 OpenSSI candidates where cleanly mapped with Spirit Nation preliminary morphology for remaining tokens; generated Syriac data remains review-required unless explicitly marked verified.

Your API account

Create an account to subscribe, manage billing, and create project-specific API keys.