What is Kabbalah API and how does it work?

Kabbalah API is a REST service that returns Kabbalistic calculations as JSON. POST birth data or text, get back gematria values, Shem HaMephorash angels, Tree of Life charts with Pillar Balance, and Tikkunim soul-corrections. Responses run under 300ms. Tier 2 is the current release - it ships honest doctrinal labels and bug-fixed math.

What's the difference between Hermetic and Jewish Kabbalah?

Jewish Kabbalah (Sefer Yetzirah, Zohar, Lurianic) is a Jewish mystical tradition tied to Hebrew scripture - it uses 7 classical planets and treats the 72 Names as derived from Exodus 14:19-21. Hermetic Qabalah (Golden Dawn, Aleister Crowley) is a Western occult tradition that maps Tarot and modern planets (Uranus, Neptune, Pluto) onto the Tree of Life. The two disagree on planet-sephirah mapping. Kabbalah API tags each response with a tradition field so you don't mix them.

Does the API support all 72 angels of Shem HaMephorash?

Yes - all 72 angels are included. Each has Hebrew name, transliteration, meaning, domain, psalm verse, zodiac degrees, choir and a verified day range. Tier 1 had off-by-N bugs in the angel-day mapping; Tier 2 ships corrected ranges backed by regression tests. Data lives in app/data/kabbalah/angels_72.py.

Which gematria ciphers are supported?

5+ ciphers: Standard (Mispar Hechrachi), Ordinal (Mispar Siduri), Mispar Gadol (uses final-letter values like final Kaph=500), Mispar Katan (reduced to a single digit) and Atbash (letter-reversal cipher). Pass a cipher enum to get one, or request all five in a single call. Tier 2 ships bug fixes for mispar gadol and mispar katan.

What is Pillar Balance?

The 10 sephiroth on the Tree of Life sit on three pillars - Severity (left: Binah, Geburah, Hod), Mercy (right: Chokmah, Chesed, Netzach) and Balance (center: Kether, Tiphareth, Yesod, Malkuth). Pillar Balance scores how a chart distributes across them and returns a percentage per pillar plus a dominant pillar flag. Useful for character analysis and coaching.

How did Tier 2 fix bugs from Tier 1?

Tier 1 had three known issues: gematria values were wrong for mispar gadol and mispar katan, the Shem HaMephorash angel-day mapping was off by 1-5 days for several ranges, and sephirah assignments drifted between endpoints (gematria endpoint and Tree of Life endpoint disagreed on the same planet). Tier 2 ships verified math, a corrected day-range table and consistent sephirah mapping. All three are covered by the public test suite.

How accurate is the gematria calculator?

Gematria uses traditional Hebrew letter values (Aleph=1 through Tav=400) for the Standard cipher, with separate value tables for Ordinal, Mispar Gadol (final-letter forms), Mispar Katan and Atbash. Tier 2 fixed the math for gadol and katan. Values now match those in standard reference works like the Sepher Sephiroth and academic Kabbalah scholarship.

Is this authentic Kabbalah or New Age simplification?

Authentic. Shem HaMephorash data follows the Exodus 14:19-21 derivation. Sephiroth correspondences follow Sefer Yetzirah for the Jewish path and Golden Dawn for the Hermetic path - and the response tells you which one you got. Sources are cited in the docs and in the design spec at docs/superpowers/specs/2026-05-25-kabbalah-tier2-update-design.md.

What traditions does the API support?

Three: Jewish (traditional Kabbalah - 7 classical planets, Sefer Yetzirah / Zohar), Hermetic (Golden Dawn correspondences, includes Uranus, Neptune, Pluto) and Classical (compatibility mode for older client code). Pass a tradition parameter and the planet-sephirah mapping adjusts. The chosen tradition is echoed back on every response.

How do I calculate someone's birth angels?

POST birth date and time to the Shem HaMephorash endpoint. The API returns the primary angel (physical domain, sun-position based), secondary (emotional) and tertiary (intellectual, time-based). Each angel includes Hebrew name, transliteration, meaning, psalm verse, zodiac degrees and the day range it covers. Tier 2 ranges are verified - no more off-by-N errors.

Can I get Tree of Life charts for any birth data?

Yes. POST birth data and get planets mapped to the 10 sephiroth, plus Pillar Balance scoring (percentage per pillar), activated paths based on zodiac placements, and Da'at analysis. Tradition parameter controls which mapping is used. Interpretive text is available in 15+ languages.

What are Kabbalistic planetary hours?

Hebrew days run sunset to sunset, not midnight to midnight. Each hour is ruled by a planet in Chaldean order: Saturn, Jupiter, Mars, Sun, Venus, Mercury, Moon. The API calculates these for any location and date plus suggested activities per hour. Useful for timing rituals, meditations and study sessions.

How much does Kabbalah API cost?

Free tier: 50 requests/month forever. Starter: $11/month for 1,000 requests. Professional: $37/month for 55,000 requests. Business: $99/month for 220,000 requests with all endpoints. Enterprise: $399+/month unlimited with dedicated servers. No credit card to start. Desktop Kabbalah software runs $50-200 with no API.

Is there a free tier to test Kabbalah calculations?

Yes. 50 free requests every month, forever. No credit card to sign up. Test every endpoint: gematria with all 5 ciphers, Shem HaMephorash angels, Tree of Life with Pillar Balance, Tikkunim and planetary hours. Enough to build and demo your app before upgrading.

How do I integrate Kabbalah API with my React app?

Use fetch to POST to the Kabbalah endpoints. For gematria: POST { text, cipher } to /kabbalah/gematria. For Shem HaMephorash angels: POST birth data to /kabbalah/angels. For Tree of Life with Pillar Balance: POST birth data to /kabbalah/tree-of-life. Returns typed JSON. React examples in the docs. Typical integration: about 2 hours.

What programming languages are supported?

Official SDKs for JavaScript/TypeScript, Python, PHP and Ruby. The REST API works with any language that can make HTTP requests. OpenAPI specs ship with the docs for generating clients in other languages. Most developers integrate within 2 hours.

What data format does the API return?

JSON on every endpoint. Gematria returns the calculated value per cipher plus matching words. Shem HaMephorash returns angel objects with Hebrew name, meaning, domain, psalm reference and day range. Tree of Life returns planet placements, sephirah assignments, Pillar Balance percentages and activated paths. Every response carries a tradition tag (hermetic | jewish | classical).

Does the API support Hebrew text input?

Yes. Send Hebrew characters directly in the request body (UTF-8). The gematria endpoint auto-detects Hebrew vs Latin script and applies the right cipher table. Final-letter forms are handled correctly for Mispar Gadol. Full Unicode Hebrew support, including niqqud (which is ignored for the calculation).

How fast is the API response time?

Average response time under 300ms. 99th percentile under 500ms. Gematria calls are fastest (around 100ms). Tree of Life with Pillar Balance and full interpretive text takes longer (around 300ms). All endpoints are optimized for production mobile and web apps. 99.9% uptime SLA.

What apps can I build with Kabbalah API?

Meditation apps with daily Shem HaMephorash angel guidance. Name-analysis tools that run 5+ gematria ciphers in one call. Tree of Life visualization tools with Pillar Balance scoring. Spiritual coaching apps built around Tikkunim. Jewish cultural apps that stay strictly in the Jewish tradition mode. Numerology platforms that combine Hebrew gematria with Western numerology.

Can I use this for a commercial product?

Yes. All paid plans include commercial use rights. Build and sell apps using these calculations - no revenue share, no per-user fee. Business and Enterprise plans add priority support for production traffic. White-label options on Enterprise.

Tier 2 - Now With Honest Doctrinal Labels

Kabbalah API: 72 Angels, Gematria Ciphers & Tree of Life

The only Kabbalah API that separates Hermetic and Jewish traditions instead of mixing them.

Full Shem HaMephorash (all 72 angels), 5+ gematria ciphers, 10 sephiroth with Pillar Balance, and Tikkunim soul-corrections. Tier 2 ships bug fixes for gematria math, angel-day mapping and sephirah assignments.

API Documentation

Shem HaMephorash Angels

Sephiroth (Tree of Life)

Gematria Ciphers

Pillars (Severity/Mercy/Balance)

Honest Hermetic vs Jewish labels

Tier 2 bug-fixed math

15+ languages

Premium Feature

Kabbalah Numerology is a premium feature available starting from the Ultra plan.

Most APIs conflate Hermetic (Golden Dawn) and traditional Jewish Kabbalah under one fuzzy label
Gematria endpoints ship with cipher bugs - wrong values for mispar gadol, mispar katan and atbash
Shem HaMephorash angel-day mapping is missing, partial or off by 1-5 days
Sephirah assignments are inconsistent across endpoints in the same product
No Pillar Balance analysis (Severity/Mercy/Balance) on the Tree of Life

Solve with

Explicit doctrinal labels - every response tags Hermetic or Jewish so you never mix systems by accident
Bug-fixed gematria: 5+ ciphers (standard, ordinal, mispar gadol, mispar katan, atbash) with verified values
Full 72 Shem HaMephorash angels with correct day/angel correspondences
10 sephiroth with consistent mapping across every endpoint and Pillar Balance scoring
Tikkunim soul-correction mappings derived from sephirah position and gematria

API Performance Metrics

Tier 2 numbers, verified by the test suite

<300ms

Response Time

Gematria Ciphers

Shem HaMephorash Angels

Sephiroth

Tree of Life Pillars

15+

Languages

Complete Kabbalah Toolkit (Tier 2)

Everything a Kabbalist needs, with honest labels and fixed math

Doctrinal Label Transparency

Every response tells you which tradition the data comes from - Hermetic (Golden Dawn / Hermetic Qabalah) or traditional Jewish Kabbalah. No more silent conflation between systems with different planet-sephirah mappings.

tradition enum: hermetic | jewish | classical

72 Angels of Shem HaMephorash

Full Shem HaMephorash dataset. All 72 angels with Hebrew name, transliteration, meaning, domain, psalm verse, day range and zodiac degrees. Correct angel-day mapping - Tier 1 had off-by-N bugs, Tier 2 ships verified ranges.

72 angels, day-range mapping, choir + psalm metadata

Multiple Gematria Ciphers

5+ gematria ciphers, each calculated correctly: Standard (Mispar Hechrachi), Ordinal (Mispar Siduri), Mispar Gadol (final letter values), Mispar Katan (reduced) and Atbash (letter reversal). Pick one or get all five in a single call.

cipher enum: standard | ordinal | gadol | katan | atbash

Tree of Life Pillar Balance

Score how a birth chart distributes across the three pillars of the Tree of Life - Severity (left), Mercy (right) and Balance (center). Returns percentages per pillar plus the dominant pillar for personality and growth analysis.

3 pillars, percentage scoring, dominant pillar flag

Tikkunim (Soul Corrections)

Tikkun mappings derived from birth data, sephirah position and gematria of the Hebrew name. Returns the Tikkun focus, related sephirah, recommended practices and the angel tied to that correction.

Tikkun-sephirah-angel mapping, recommendations payload

Algorithmic Correctness Guarantee

Tier 2 closed the gematria, angel-day and sephirah-assignment bugs from Tier 1. Backed by a public test suite (test_kabbalah_api.py + edge cases). Regression tests run on every release.

Public tests, regression CI, semver for breaking math fixes

Hebrew Letters (22 Paths)

All 22 Hebrew letters with element, planet, zodiac sign and Tarot correspondence. Mother letters (elements), Double letters (planets) and Simple letters (zodiac signs) for path-on-the-Tree analysis.

22 letters, element/planet/zodiac/tarot mapping

Kabbalistic Planetary Hours

Hebrew-style planetary hours from sunset to sunset. Chaldean order ruling planets, suggested activities per hour and tradition tag so you know which system you're applying.

Sunset-based, 24 hours, activity hints

15+ Language Support

All interpretive text available in English, Hebrew, Spanish, German, French, Russian and 10+ more languages. Stored in report_data, not hard-coded - so translations stay in sync across endpoints.

15+ languages, report_data driven

What is Kabbalah API Tier 2? Complete Developer Guide

Honest doctrinal labels, 72 angels, 5+ gematria ciphers and Pillar Balance - all via REST

Kabbalah API is a REST service that returns Kabbalistic calculations as JSON. Tier 2, shipped May 2026, does two things Tier 1 didn't: it tags every response with the tradition it belongs to (Hermetic vs traditional Jewish Kabbalah), and it fixes math bugs in gematria ciphers, Shem HaMephorash angel-day mapping and sephirah assignments. You get all 72 angels of Shem HaMephorash with verified day ranges, 5+ gematria ciphers (standard, ordinal, mispar gadol, mispar katan, atbash) calculated correctly, 10 sephiroth on the Tree of Life with consistent planet-to-sephirah mapping, Pillar Balance scoring across Severity / Mercy / Balance, and Tikkunim soul-correction mappings. Responses run under 300ms with interpretations available in 15+ languages. Built for developers who need calculations that match what a serious Kabbalist or scholar would accept.

Hermetic vs Jewish Kabbalah: why the doctrinal label matters

Most Kabbalah products quietly mix two traditions.

Hermetic Qabalah (from the Hermetic Order of the Golden Dawn) maps Tarot trumps and modern planets like Uranus, Neptune and Pluto onto the Tree of Life.

Traditional Jewish Kabbalah (Sefer Yetzirah, Zohar) uses only the seven classical planets and treats the 72 Names as derived from Exodus 14:19-21, not as ceremonial talismans.

The two systems disagree on planet-sephirah mapping, on the role of Da'at, and on whether outer planets belong on the Tree at all.

Tier 2 of Kabbalah API tags every response with a tradition field - hermetic, jewish or classical - so you never mix Golden Dawn correspondences into an app for an Orthodox audience, or vice versa.

tradition enum on every response - no silent conflation

1 min read

The 72 Angels of Shem HaMephorash and day/angel correspondence

Shem HaMephorash is a 72-letter name of God derived from three verses of Exodus (14:19-21).

From it, 72 three-letter angel names are extracted.

Each angel rules a roughly 5-day window of the solar year, so given a birth date you can return the guardian angel for that window.

Tier 1 had off-by-N errors in this mapping.

Tier 2 ships a verified day-range table: send a birth date, get the correct angel with Hebrew name, transliteration, meaning, psalm verse, zodiac degrees and choir.

The data lives in app/data/kabbalah/angels_72.py and is covered by regression tests.

All 72 angels, verified day ranges, full metadata per angel

1 min read

Gematria ciphers: standard, ordinal, mispar gadol, mispar katan, atbash

Gematria assigns numerical values to Hebrew letters.

There isn't one gematria - there are several ciphers, and each can produce a different value for the same word.

Kabbalah API Tier 2 supports 5+ ciphers: Standard (Mispar Hechrachi, the classic Aleph=1, Bet=2...

Tav=400 system); Ordinal (Mispar Siduri, position in the alphabet 1-22); Mispar Gadol, which uses final-letter forms with extended values (final Kaph=500, final Mem=600 and so on); Mispar Katan (reduced, sums down to a single digit); and Atbash (letter reversal cipher used in classical Kabbalistic exegesis).

Tier 1 had wrong values in mispar gadol and katan.

Tier 2 ships verified math.

5+ ciphers, bug-fixed math, choose one or request all

1 min read

Pillar Balance on the Tree of Life: Severity, Mercy, Balance

The 10 sephiroth on the Tree of Life sit on three vertical pillars.

The left pillar (Severity) holds Binah, Geburah and Hod.

The right pillar (Mercy) holds Chokmah, Chesed and Netzach.

The center pillar (Balance) holds Kether, Tiphareth, Yesod and Malkuth.

Pillar Balance scores how a birth chart distributes weight across these three pillars - useful for character analysis, growth work and esoteric coaching.

Tier 2 returns a percentage per pillar plus a dominant_pillar flag.

A chart heavy on Severity reads as disciplined and structured; heavy on Mercy as expansive and generous; heavy on Balance as integrative.

3 pillars, percentage per pillar, dominant pillar flag

1 min read

Tikkunim soul-corrections and how they connect to sephiroth

Tikkun means correction or repair.

In Lurianic Kabbalah, each soul carries a tikkun - work it's here to do.

Kabbalah API derives the Tikkun from birth date and the gematria of the Hebrew name, then maps it to a primary sephirah and to one of the 72 angels.

The response gives you Tikkun number, focus area, related sephirah, the corresponding angel and a recommendations payload (drawn from report_data, translatable into 15+ languages).

Useful for spiritual coaching apps, character analysis tools and Kabbalah learning platforms.

Tikkun-sephirah-angel triangle, recommendations payload

1 min read

Building Kabbalah apps: integration examples

Common builds: meditation apps that surface the user's daily Shem HaMephorash angel and Tikkun focus.

Name-analysis tools that run a name through 5 gematria ciphers and surface matching values.

Esoteric astrology platforms that render the natal chart on the Tree of Life with Pillar Balance scoring.

Kabbalah learning platforms with interactive 22-path explanations.

Numerology apps that combine Hebrew gematria with Western numerology and Chinese zodiac.

The API returns clean JSON in under 300ms.

SDKs available for JavaScript/TypeScript, Python, PHP and Ruby.

Typical integration: about 2 hours from key to first chart.

2-hour integration, SDKs for JS / Python / PHP / Ruby

1 min read

Use Cases

Spiritual & meditation apps

Daily Shem HaMephorash angel, Tikkun focus, planetary-hour timing

Numerology platforms

5+ gematria ciphers, name analysis, hidden numerical connections

Esoteric astrology software

Tree of Life natal charts, Pillar Balance scoring, sephirah mapping

Kabbalah learning platforms

Interactive Tree of Life, 22 letters, angel reference databases

Spiritual coaching tools

Tikkunim mappings, soul-correction guidance, character analysis

Jewish cultural apps

Hebrew calendar, planetary hours, traditional Jewish-Kabbalah only mode

Technical Specifications

API response time	<300ms average, <500ms p99
Gematria ciphers (enum)	standard \| ordinal \| gadol \| katan \| atbash
Shem HaMephorash angels	Full 72 with verified day-range mapping
72-angel response schema	number, hebrew_name, transliteration, meaning, day_range, psalm, zodiac_degrees, choir
Sephiroth	10 sephiroth + Da'at flag, consistent across endpoints
Pillar Balance (enum)	severity \| mercy \| balance, with percentage per pillar
Hebrew letters	22 letters with element / planet / zodiac / Tarot mapping
Tradition (enum)	hermetic \| jewish \| classical - tagged on every response
Tikkunim	Tikkun number + sephirah + angel + recommendations payload
Supported languages	15+: EN, HE, ES, DE, FR, RU, PT, IT and more
Planetary hours	Kabbalistic (sunset-sunset), Chaldean order
SDK availability	JavaScript, Python, PHP, Ruby
Authentication	API key (header or query parameter)
Uptime SLA	99.9% availability guarantee

Kabbalah API Tier 2 vs alternatives

Feature	Astrology API	Others
72 Shem HaMephorash angels	All 72 with verified day ranges	Partial set or missing day mapping
Gematria ciphers	5+ ciphers, bug-fixed math	1-2 ciphers, known math bugs
Hermetic vs Jewish labeling	Explicit tradition enum on every response	Silently conflate the two
Tree of Life Pillar Balance	3 pillars with percentage scoring	Not offered
Tikkunim mappings	Tikkun-sephirah-angel triangle	Books only
Sephirah assignments	Consistent across all endpoints	Drift between endpoints
API access	REST API + SDKs	Desktop only or none
Languages	15+ including Hebrew	English only
Response time	<300ms	N/A (manual)
Price	From $11/month	Desktop: $50-200

Related APIs

Numerology Core API

Life path and core numbers - pair with gematria

Numerology Name API

Name-based numerology to complement gematria ciphers

Traditional Astrology API

Classical 7-planet system that matches Jewish Kabbalah

Horary API

Traditional question-based astrology

Tarot Tree API

Tarot on the Tree of Life - Hermetic correspondences

Natal Chart API

Birth chart input for Tree of Life mapping

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Premium Feature

Kabbalah Numerology is a premium feature available starting from the Ultra plan.

Kabbalah Numerology: 2 credits per request

See how many requests you get with each plan

Simple, Transparent Pricing

Start free, scale as you grow. No hidden fees, no surprises.

Ultra

$37/month

For professional astrology applications

Credit math ↓

All premium endpoints
23 house systems
Advanced AI interpretations
Priority support

High Volume Plans

For enterprise-scale applications

Business

$99/month

For high-volume applications

Credit math ↓

ALL endpoints
White-label ready
Custom AI fine-tuning
Phone support

UNLIMITED

Enterprise

$399+per month

Unlimited requests with dedicated infrastructure

Dedicated server infrastructure
Sub-300ms guaranteed
24/7 dedicated support
99.99% uptime SLA

All plans include comprehensive documentation and SDKs

Questions? Talk to our team

Frequently asked questions

Tier 2 answers for developers building Kabbalah apps

Explore related APIs

Kabbalah API pairs well with our numerology, traditional astrology and Tarot endpoints for richer mystical apps.

Numerology Core API Numerology Name API Traditional Astrology API Horary API Tarot Tree API Natal Chart API

Build Kabbalah apps with bug-fixed math

Tier 2 ships honest doctrinal labels, all 72 Shem HaMephorash angels and 5+ gematria ciphers - start free

Start Free View API Documentation

50 free requests/month

99.9% uptime SLA

Tier 2 verified math

No credit card required

Kabbalah API: 72 Angels, Gematria Ciphers & Tree of Life

Most Kabbalah APIs Are Broken or Dishonest

Kabbalah API Tier 2 Fixes All Of It

API Performance Metrics

Complete Kabbalah Toolkit (Tier 2)

Doctrinal Label Transparency

72 Angels of Shem HaMephorash

Multiple Gematria Ciphers

Tree of Life Pillar Balance

Tikkunim (Soul Corrections)

Algorithmic Correctness Guarantee

Hebrew Letters (22 Paths)

Kabbalistic Planetary Hours

15+ Language Support

What is Kabbalah API Tier 2? Complete Developer Guide

Hermetic vs Jewish Kabbalah: why the doctrinal label matters

The 72 Angels of Shem HaMephorash and day/angel correspondence

Gematria ciphers: standard, ordinal, mispar gadol, mispar katan, atbash

Pillar Balance on the Tree of Life: Severity, Mercy, Balance

Tikkunim soul-corrections and how they connect to sephiroth

Building Kabbalah apps: integration examples

Use Cases

Spiritual & meditation apps

Numerology platforms

Esoteric astrology software

Kabbalah learning platforms

Spiritual coaching tools

Jewish cultural apps

Technical Specifications

Kabbalah API Tier 2 vs alternatives

Related APIs

Numerology Core API

Numerology Name API

Traditional Astrology API

Horary API

Tarot Tree API

Natal Chart API

References & Standards

Kabbalah Numerology: 2 credits per request

Simple, Transparent Pricing

Ultra

High Volume Plans

Business

Enterprise

Frequently asked questions

What is Kabbalah API and how does it work?

What's the difference between Hermetic and Jewish Kabbalah?

Does the API support all 72 angels of Shem HaMephorash?

Which gematria ciphers are supported?

What is Pillar Balance?

What are Tikkunim?

How did Tier 2 fix bugs from Tier 1?

How accurate is the gematria calculator?

Is this authentic Kabbalah or New Age simplification?

What traditions does the API support?

How do I calculate someone's birth angels?

Can I get Tree of Life charts for any birth data?

What are Kabbalistic planetary hours?

How much does Kabbalah API cost?

Is there a free tier to test Kabbalah calculations?

How do I integrate Kabbalah API with my React app?

What programming languages are supported?

What data format does the API return?

Does the API support Hebrew text input?

How fast is the API response time?

What apps can I build with Kabbalah API?

Can I use this for a commercial product?

Explore related APIs

Build Kabbalah apps with bug-fixed math

Most Kabbalah APIs Are Broken or Dishonest

Kabbalah API Tier 2 Fixes All Of It

API Performance Metrics

Complete Kabbalah Toolkit (Tier 2)

Doctrinal Label Transparency

72 Angels of Shem HaMephorash

Multiple Gematria Ciphers

Tree of Life Pillar Balance

Tikkunim (Soul Corrections)

Algorithmic Correctness Guarantee

Hebrew Letters (22 Paths)