HIA Ethos API v1

Bring the Five Gates Into
Every Project on Earth

One API call gives your bot or AI agent access to the HIA Ethos framework — Honor, Integrity, Authenticity, Do No Harm, and Absolute Truth — plus the Biblical Medicine agent for scripture-validated health guidance.

This API is dedicated to the Five Gates ethical framework and Biblical Medicine. It does not provide access to the full Genesis World Health agent network.

The Five Gates — HIA Ethos

Every API response passes through all five gates. Each gate carries a weight in the validation score. Failure on “Do No Harm” caps the total score at 0.1 — safety is non-negotiable.

Weight: 30%

Do No Harm

The highest-weight gate. Every response is screened for potential harm. Failure here caps all other scores. Protects the sanctity of human life above all.

Proverbs 4:23

Weight: 15%

Honor

Honors the God-given design of the human body. Recommendations respect individual dignity, cultural context, and the sacred nature of healing.

Romans 12:10

Weight: 20%

Integrity

Dual-source truth verification — every claim cross-validated against peer-reviewed research AND scripture. No conflicts of interest, no hidden agendas.

Proverbs 11:3

Weight: 20%

Absolute Truth

Anchored in scripture as the ultimate source of truth. All guidance measured against the Word of God. No relativism, no compromise on foundational truths.

2 Timothy 3:16

Weight: 15%

Authenticity

Genuine, transparent communication. No hallucinations, no fabricated studies, no marketing-driven claims. What you receive is what the evidence and scripture truly say.

John 8:32

AI Agent

Biblical Medicine

Scripture-validated health guidance rooted in God’s Word. Draws from biblical dietary laws, healing herbs referenced in scripture, and faith-based wellness principles.

agent: "biblical_medicine"

Quickstart — 3 Steps

Integrate the HIA Ethos framework and Biblical Medicine into your project in minutes.

1

Register Your Bot

POST to /api/v1/register — one call, instant API key

2

Query the Five Gates

POST to /api/v1/hia-query — specify a gate or the Biblical Medicine agent

3

Monitor Usage

GET /api/v1/usage for real-time call tracking

import requests

BASE_URL = "https://genesisworldhealth.com/api/v1"

# Step 1: Register your bot (one-time)
reg = requests.post(f"{BASE_URL}/register", json={
    "email": "[email protected]",
    "password": "secure_password_here",
    "bot_name": "MyEthicsBot",
    "platform": "LangChain"
})
API_KEY = reg.json()["api_key"]  # Save this! Shown once only.

# Step 2: Query the HIA Ethos engine
response = requests.post(
    f"{BASE_URL}/hia-query",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "query": "How does Honor apply to patient care decisions?",
        "gate": "honor",           # honor | integrity | authenticity | do_no_harm | absolute_truth
        "include_scripture": True   # optional — include biblical references
    }
)
print(response.json()["response"])

# Step 3: Query the Biblical Medicine agent
response = requests.post(
    f"{BASE_URL}/hia-query",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "query": "What does scripture say about healing herbs?",
        "agent": "biblical_medicine"
    }
)
print(response.json()["response"])

API Reference

POST/api/v1/registerBot-Safe

Register a bot or AI agent. Creates account + API key in one call. No CAPTCHA — bots are welcome.

Request Body:

{
  "email": "[email protected]",
  "password": "secure_password",
  "bot_name": "MyEthicsBot",
  "platform": "LangChain"       // optional
}

Rate limit: 5 registrations/hour per IP. GET this endpoint for full docs.

POST/api/v1/hia-queryAuth Required

Submit a query to the HIA Ethos engine. Specify a gate for targeted ethical validation, or use the Biblical Medicine agent for scripture-based health guidance.

Request Body:

{
  "query": "string (required)",
  "gate": "honor",              // honor | integrity | authenticity
                                // | do_no_harm | absolute_truth
  "agent": "biblical_medicine", // optional — routes to Biblical Medicine
  "include_scripture": true,    // optional — include biblical references
  "context": { ... }            // optional — enhances personalization
}

Response includes:

{
  "response": "...",
  "gates_applied": ["do_no_harm", "integrity", "absolute_truth"],
  "validation_score": 0.92,
  "scripture_references": [...],   // when include_scripture is true
  "usage": { "calls_remaining": 95 }
}
GET/api/v1/usageAuth Required

Real-time usage dashboard: calls this month, remaining quota, gates queried, latency stats.

POST/api/v1/subscribeAuth Required

Upgrade your subscription for more API calls. Returns a Stripe checkout URL.

Request Body:

{ "tier": "premium" }  // or "vip"

How the Five Gates Validate Every Response

Each API response is scored against all five gates. The weighted score determines the confidence level of the guidance returned to your bot.

Do No Harm
30%
Honor
15%
Integrity
20%
Absolute Truth
20%
Authenticity
15%

Critical Rule: If the “Do No Harm” gate fails, the total validation score is capped at 0.1 regardless of other gate scores. Safety is always paramount.

Who Uses the HIA Ethos API?

🤖

AI Agent Ethics Layer

Add a truth-validation layer to any AI agent. Every health claim checked against the Five Gates before reaching users.

💬

Chatbot Truth Verification

Validate your chatbot’s health responses against scripture and evidence before sending them to users. Prevent hallucinations.

📱

Health App Guardrails

Integrate the “Do No Harm” gate into your health app to ensure no harmful guidance ever reaches patients.

Faith Organizations

Churches and ministries can embed Biblical Medicine guidance into their digital platforms — health wisdom rooted in God’s Word.

🔬

Research Validation

Cross-validate health claims against both peer-reviewed evidence and scriptural truth using the Integrity and Absolute Truth gates.

🛡️

Content Moderation

Use the Five Gates to screen health content on your platform for safety, truthfulness, and alignment with ethical principles.

API Pricing — Start Free

Every bot gets 100 free HIA Ethos API calls per month. Upgrade when you need more.

Free

$0

100 calls/mo

  • ✓ All Five Gates validation
  • ✓ Biblical Medicine agent
  • ✓ Scripture references
  • ✓ Usage dashboard

Perfect for prototyping

MOST POPULAR

Premium

$7.99/mo

5,000 calls/mo

  • ✓ Everything in Free
  • ✓ Priority processing
  • ✓ Detailed gate scores
  • ✓ Referral rewards

Best for production bots

VIP

$15.99/mo

50,000 calls/mo

  • ✓ Everything in Premium
  • ✓ Batch validation endpoint
  • ✓ Webhook notifications
  • ✓ Priority support

For high-volume integrations

Spread Truth at Scale

Every API call plants a seed of truth. Bring Honor, Integrity, Authenticity, Do No Harm, and Absolute Truth to every health interaction on earth.

Register your bot in one line:

curl -X POST genesisworldhealth.com/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"pass","bot_name":"MyBot"}'

100 free API calls/month. Upgrade to Premium ($7.99/mo) or VIP ($15.99/mo) for more.