Skip to content

Gematria

The Gematria endpoint converts any text into four numerological systems: 1. Ordinal – A=1, B=2, ..., Z=26 2. Reverse Ordinal – A=26, B=25, ..., Z=1 3. Pythagorean – A=1, B=2, ..., I=9, J=1, ..., Z=8 4. Standard Hebrew – א=1, ב=2, ..., ת=400 (Hebrew letters only)

Also includes hidden meaning based on ordinal value.

Case-insensitive – non-alphabetic characters ignored.

Endpoint

Method Path
GET https://api.numerologyapi.com/api/v1/gematria
POST https://api.numerologyapi.com/api/v1/gematria

Note: POST uses same path as GET — no /post suffix.

Required Headers

X-API-Key: YOUR_API_KEY
Content-Type: application/json   (POST only)
Host: api.numerologyapi.com

You can also authenticate with Authorization: Bearer YOUR_API_KEY.

Create and manage API keys in the Numerology API dashboard.

Parameters

Param Type Required Description
text string Yes Any text (e.g., "Hello there", "Love").

Only alphabetic characters used.
Hebrew Gematria: Only Hebrew letters (א–ת) count.

Add the optional lang query parameter to localize responses. Supported values: en, es, de, fr, pt.

Example Requests

GET Request

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/gematria?text=John+Doe&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST Request (JSON Body)

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/gematria?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "text": "John Doe"
}'

Response Example

{
  "text": "John Doe",
  "systems": {
    "ordinal": {
      "total": 71,
      "letter_values": [
        {
          "letter": "J",
          "value": 10
        },
        {
          "letter": "o",
          "value": 15
        },
        {
          "letter": "h",
          "value": 8
        },
        {
          "letter": "n",
          "value": 14
        },
        {
          "letter": "D",
          "value": 4
        },
        {
          "letter": "o",
          "value": 15
        },
        {
          "letter": "e",
          "value": 5
        }
      ],
      "interpretation": "Power, abundance, authority, karma, material mastery"
    },
    "reverse_ordinal": {
      "total": 118,
      "letter_values": [
        {
          "letter": "J",
          "value": 17
        },
        {
          "letter": "o",
          "value": 12
        },
        {
          "letter": "h",
          "value": 19
        },
        {
          "letter": "n",
          "value": 13
        },
        {
          "letter": "D",
          "value": 23
        },
        {
          "letter": "o",
          "value": 12
        },
        {
          "letter": "e",
          "value": 22
        }
      ],
      "interpretation": "Creation, leadership, individuality, divine spark, initiation"
    },
    "pythagorean": {
      "total": 35,
      "letter_values": [
        {
          "letter": "J",
          "value": 1
        },
        {
          "letter": "o",
          "value": 6
        },
        {
          "letter": "h",
          "value": 8
        },
        {
          "letter": "n",
          "value": 5
        },
        {
          "letter": "D",
          "value": 4
        },
        {
          "letter": "o",
          "value": 6
        },
        {
          "letter": "e",
          "value": 5
        }
      ],
      "interpretation": "Power, abundance, authority, karma, material mastery"
    },
    "standard_hebrew": {
      "total": 0,
      "letter_values": [],
      "interpretation": "Void, divine source, infinite potential, the unmanifest"
    }
  },
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "0644581355794227",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "gematria",
    "endpoint_description": "Performs Gematria calculations on text, revealing numerical values and meanings.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:29.270421+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

Gematria Systems

System Mapping
Ordinal A=1, B=2, ..., Z=26
Reverse Ordinal A=26, B=25, ..., Z=1
Pythagorean A=1, B=2, ..., I=9, J=1, ..., Z=8
Hebrew א=1, ב=2, ..., כ=20, ל=30, ..., ת=400

Hidden Meaning: Based on ordinal value → interpret_gematria() lookup.

Calculation Example

"Hello there"
→ letters: H E L L O T H E R E
→ Ordinal: 8+5+12+12+15+20+8+5+18+5 = 108
→ Reverse: 19+22+15+15+12+7+19+22+9+22 = 162
→ Pythagorean: 8+5+3+3+6+2+8+5+9+5 = 54
→ Hebrew: 0 (no Hebrew letters)

Open Dashboard

Note

  • Input: Any string — spaces, punctuation, numbers ignored.
  • Case-insensitive — all converted to uppercase.
  • Hebrew Support: Only valid Hebrew Unicode letters (א–ת).
  • Hidden Meaning:
  • Based on ordinal_gematria
  • Returns "No specific hidden meaning found" if not in lookup
  • Use Case:
  • Sacred name analysis
  • Mystical text decoding
  • Spiritual branding
  • Biblical/Kabbalistic studies