# Gematria API
> Gematria and isopsephy as an API, computed locally and deterministically — turning words into the numeric sums of their letters. The hebrew endpoint computes Hebrew gematria: the standard value (Mispar Hechrachi) that adds the base value of each letter (alef 1, bet 2 … tav 400), the gadol value that counts the five final letters as 500–900, and the reduced digital root; for example שלום (shalom) is 376. The greek endpoint computes Greek isopsephy with the Milesian numeral system (alpha 1 … omega 800, plus the archaic stigma 6, koppa 90 and sampi 900), case-insensitively; for example λογος (logos) is 373. The english endpoint computes English gematria three ways — the ordinal or simple value (a 1 … z 26), the Pythagorean value that reduces each letter to a single digit 1–9, and the Sumerian value (ordinal × 6) — with the digital root; for example HELLO is 52 ordinal. Non-letter characters are ignored and unrecognised letters are listed. Everything is computed locally and deterministically, so it is instant and private. Ideal for word-game, puzzle, esoteric, study and language app developers, name-numerology and text-analysis tools, and Bible and classics study. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is letter-value gematria; for Roman numerals use a Roman-numeral API and for general number bases a base-conversion API.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/gematria-api/..."
```

## Pricing
- **Free** (Free) — 5,800 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 49,000 calls/Mo, 6 req/s
- **Pro** ($11/Mo) — 220,000 calls/Mo, 15 req/s
- **Mega** ($36/Mo) — 1,300,000 calls/Mo, 40 req/s

## Endpoints

### Gematria

#### `GET /v1/english` — English gematria

**Parameters:**
- `text` (query, required, string) — English text Example: `HELLO`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/gematria-api/v1/english?text=HELLO"
```

**Response:**
```json
{
    "data": {
        "note": "English gematria: ordinal/simple (a=1 … z=26), Pythagorean (each letter reduced to 1–9) and Sumerian (ordinal × 6). Example: HELLO = 52 ordinal.",
        "inputs": {
            "text": "HELLO"
        },
        "letters": 5,
        "ordinal_value": 52,
        "reduced_value": 7,
        "sumerian_value": 312,
        "pythagorean_value": 25
    },
    "meta": {
        "timestamp": "2026-06-05T11:30:25.234Z",
        "request_id": "67d9a6b1-f231-4475-a7e2-9c349a390d09"
    },
    "status": "ok",
    "message": "English gematria",
    "success": true
}
```

#### `GET /v1/greek` — Greek isopsephy

**Parameters:**
- `text` (query, required, string) — Greek text Example: `λογος`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/gematria-api/v1/greek?text=%CE%BB%CE%BF%CE%B3%CE%BF%CF%82"
```

**Response:**
```json
{
    "data": {
        "note": "Greek isopsephy with the Milesian numerals (α=1 … ω=800, plus stigma 6, koppa 90, sampi 900). Example: λογος = 373.",
        "value": 373,
        "inputs": {
            "text": "λογος"
        },
        "letters": 5,
        "reduced_value": 4,
        "skipped_characters": []
    },
    "meta": {
        "timestamp": "2026-06-05T11:30:25.345Z",
        "request_id": "168c16fa-a2f6-47f7-af30-7ff2eb3811a7"
    },
    "status": "ok",
    "message": "Greek isopsephy",
    "success": true
}
```

#### `GET /v1/hebrew` — Hebrew gematria

**Parameters:**
- `text` (query, required, string) — Hebrew text Example: `שלום`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/gematria-api/v1/hebrew?text=%D7%A9%D7%9C%D7%95%D7%9D"
```

**Response:**
```json
{
    "data": {
        "note": "Hebrew gematria. Standard (Mispar Hechrachi) sums the base letter values; Gadol counts the five final letters as 500–900. Example: שלום = 376.",
        "inputs": {
            "text": "שלום"
        },
        "letters": 4,
        "gadol_value": 936,
        "reduced_value": 7,
        "standard_value": 376,
        "skipped_characters": []
    },
    "meta": {
        "timestamp": "2026-06-05T11:30:25.453Z",
        "request_id": "0b1d4255-0e66-461d-93fa-c5356d1aa6bf"
    },
    "status": "ok",
    "message": "Hebrew gematria",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/gematria-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "notes": "Pass the word or phrase as 'text'. Non-letter characters are ignored. Hebrew uses the Unicode block U+05D0–U+05EA; Greek is case-insensitive.",
        "service": "gematria-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/greek": "Greek isopsephy with the Milesian numerals.",
            "GET /v1/hebrew": "Hebrew gematria — standard, gadol (final letters) and reduced values.",
            "GET /v1/english": "English ordinal, Pythagorean and Sumerian gematria."
        },
        "description": "Gematria and isopsephy calculator: numeric letter-value sums for Hebrew (standard and gadol), Greek (Milesian isopsephy) and English (ordinal, Pythagorean, Sumerian)."
    },
    "meta": {
        "timestamp": "2026-06-05T11:30:25.530Z",
        "request_id": "1e03b879-33ea-4e53-9c53-5829279978bb"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/gematria-api
OpenAPI spec: https://www.oanor.com/api/gematria-api/openapi.json