{"openapi":"3.1.0","info":{"title":"Genesis World Health API","version":"1.0.0","description":"AI-powered health intelligence API with 75+ specialized agents covering clinical medicine, 30+ global healing traditions, faith-based wellness, nutrition, biohacking, addiction recovery (Bottoms Up Recovery), and more. Built on HIA Pathos: Honor, Integrity, Authenticity. All recommendations validated through Five Gates safety system. Includes Bottoms Up Recovery programs for Alcohol Use Disorder (7 Bandidos framework) and Cannabis Use Disorder (5 Hijacked Systems protocol) with phenotype-guided, supplement-first protocols.","contact":{"name":"Genesis World Health API Support","url":"https://genesisworldhealth.com/developers","email":"api@genesisworldhealth.com"},"license":{"name":"Proprietary","url":"https://genesisworldhealth.com/terms"},"x-logo":{"url":"https://genesisworldhealth.com/logo.png","altText":"Genesis World Health"}},"servers":[{"url":"https://genesisworldhealth.com/api/v1","description":"Production API"}],"security":[{"BearerAuth":[]}],"paths":{"/register":{"get":{"operationId":"getRegistrationInfo","summary":"Registration information","description":"Returns instructions for programmatic API registration.","tags":["Authentication"],"security":[],"responses":{"200":{"description":"Registration info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationInfo"}}}}}},"post":{"operationId":"registerAccount","summary":"Register for API access","description":"Create an account and receive an API key. No CAPTCHA required — designed for programmatic/bot registration. Rate limited to 5 registrations per hour per IP.","tags":["Authentication"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"},"example":{"email":"agent@example.com","password":"securePassword123!","firstName":"Health","lastName":"Agent"}}}},"responses":{"201":{"description":"Account created with API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterResponse"}}}},"400":{"description":"Invalid request parameters"},"409":{"description":"Email already registered"},"429":{"description":"Rate limit exceeded"}}}},"/health-query":{"get":{"operationId":"getApiInfo","summary":"API information and available endpoints","description":"Returns API information, available endpoints, HIA Pathos methodology, and rate limit details.","tags":["Health Intelligence"],"security":[],"responses":{"200":{"description":"API information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiInfo"}}}}}},"post":{"operationId":"submitHealthQuery","summary":"Submit a health intelligence query","description":"Send a natural language health question to any of 75+ specialized AI agents. The system routes your query to the most relevant specialist and returns structured, evidence-based recommendations following HIA methodology.","tags":["Health Intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthQueryRequest"},"examples":{"general":{"summary":"General health query","value":{"query":"What are the best natural approaches for improving sleep quality?"}},"targeted":{"summary":"Agent-specific query","value":{"query":"What frequency protocols support cellular repair?","agent":"frequency_medicine"}},"tcm":{"summary":"Traditional medicine query","value":{"query":"How does Traditional Chinese Medicine approach liver stagnation?","agent":"tcm"}}}}}},"responses":{"200":{"description":"Health intelligence response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthQueryResponse"}}}},"400":{"description":"Invalid query"},"401":{"description":"Invalid or missing API key"},"429":{"description":"Monthly usage limit exceeded"}}}},"/agents":{"get":{"operationId":"listAgents","summary":"List all available health agents","description":"Returns the complete catalog of 75+ specialized AI health agents with names, descriptions, and tier availability.","tags":["Agent Catalog"],"security":[],"responses":{"200":{"description":"Agent catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCatalog"}}}}}}},"/usage":{"get":{"operationId":"getUsageStats","summary":"Get API usage statistics","description":"Returns real-time usage metrics including calls this month, remaining quota, performance stats, and per-endpoint breakdown.","tags":["Usage & Billing"],"responses":{"200":{"description":"Usage statistics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageStats"}}}},"401":{"description":"Invalid or missing API key"}}}},"/subscribe":{"get":{"operationId":"getSubscriptionInfo","summary":"Get subscription tier information","description":"Returns current subscription tier and available upgrade options.","tags":["Usage & Billing"],"responses":{"200":{"description":"Subscription information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionInfo"}}}},"401":{"description":"Invalid or missing API key"}}},"post":{"operationId":"upgradeSubscription","summary":"Upgrade subscription tier","description":"Creates a Stripe Checkout URL for upgrading to a higher tier.","tags":["Usage & Billing"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tier":{"type":"string","enum":["premium","vip"],"description":"Target subscription tier"}},"required":["tier"]}}}},"responses":{"200":{"description":"Stripe Checkout URL","content":{"application/json":{"schema":{"type":"object","properties":{"checkoutUrl":{"type":"string","format":"uri"},"tier":{"type":"string"}}}}}},"401":{"description":"Invalid or missing API key"}}}},"/referral":{"get":{"operationId":"getReferralStats","summary":"Get referral program stats","description":"Returns your unique referral link and conversion statistics.","tags":["Referral Program"],"responses":{"200":{"description":"Referral stats","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferralStats"}}}},"401":{"description":"Invalid or missing API key"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key obtained from POST /register. Include as: Authorization: Bearer gwh_k1_..."}},"schemas":{"RegisterRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"Account email address"},"password":{"type":"string","minLength":6,"description":"Account password (min 6 characters)"},"firstName":{"type":"string","description":"First name (optional)"},"lastName":{"type":"string","description":"Last name (optional)"}},"required":["email","password"]},"RegisterResponse":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"apiKey":{"type":"string","description":"Your API key — store securely, shown only once"},"tier":{"type":"string","description":"Current subscription tier"},"usage":{"type":"object","properties":{"monthly_limit":{"type":"integer"},"calls_remaining":{"type":"integer"}}},"endpoints":{"type":"object","description":"Available API endpoints"}}},"RegistrationInfo":{"type":"object","properties":{"message":{"type":"string"},"registration":{"type":"object"}}},"HealthQueryRequest":{"type":"object","properties":{"query":{"type":"string","description":"Natural language health question"},"agent":{"type":"string","description":"Target agent type (optional — auto-routes if omitted)","enum":["christ_consciousness","genetics","epigenetics","medicine","diet","detoxification","addiction_recovery","faith","mens_health","womens_health","pediatric_health","micro_medicine","whole_foods","tcm","ayurveda","osteopathic_medicine","naturopathy","homeopathy","kampo","korean_medicine","thai_medicine","tibetan_medicine","persian_medicine","unani_medicine","siddha_medicine","hawaiian_healing","aboriginal_medicine","mayan_medicine","greek_medicine","celtic_healing","slavic_medicine","indigenous_medicine","anthroposophic_medicine","curanderismo","african_traditional_medicine","environmental_medicine","rongoa_maori","babaylan_healing","native_american_medicine","jamu_medicine","thuoc_nam","amazonian_medicine","andean_medicine","nordic_medicine","egyptian_medicine","sufi_healing","mongolian_medicine","caribbean_ital","exercise","nutraceuticals","orthomolecular","gut_microbiome","immune_optimization","fasting","lymphatic_health","hydrotherapy","cardiovascular","metabolic_health","hormone_endocrine","chronic_fatigue_energy","pain_management","kidney_urinary","eye_vision","hearing_ear_health","respiratory_lung","cancer_oncology","autoimmune","structural_musculoskeletal","dermatology_skin","dental_oral_health","liver_hepatic","digestive_gastrointestinal","fertility","mental_health_root_cause","behavioral_health","harm_reduction","psychonaut","pregnancy_prenatal","mitochondria_healing","breathwork","frequency_medicine","regenerative_medicine","neurological_brain_health","sleep_circadian","longevity_aging","peptides","root_cause","sports_performance","stress_adrenal","light_therapy","cold_heat_therapy","trauma_somatic","emf_bioelectromagnetics","water_hydration","sound_healing","financial_wellness","biohacking"]},"context":{"type":"object","description":"Optional health context (conditions, medications, goals)","properties":{"conditions":{"type":"array","items":{"type":"string"}},"medications":{"type":"array","items":{"type":"string"}},"goals":{"type":"array","items":{"type":"string"}},"age":{"type":"integer"},"gender":{"type":"string"}}}},"required":["query"]},"HealthQueryResponse":{"type":"object","properties":{"success":{"type":"boolean"},"agent":{"type":"string","description":"Agent that processed the query"},"agentDisplayName":{"type":"string"},"response":{"type":"string","description":"Health intelligence response"},"hia_validation":{"type":"object","description":"HIA methodology validation markers","properties":{"honor":{"type":"boolean"},"integrity":{"type":"boolean"},"authenticity":{"type":"boolean"}}},"disclaimer":{"type":"string"},"usage":{"type":"object","properties":{"calls_this_month":{"type":"integer"},"monthly_limit":{"type":"integer"},"remaining":{"type":"integer"}}}}},"AgentCatalog":{"type":"object","properties":{"total":{"type":"integer"},"agents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"tier":{"type":"string","enum":["basic","premium","vip"]}}}}}},"UsageStats":{"type":"object","properties":{"tier":{"type":"string"},"limits":{"type":"object"},"usage":{"type":"object"},"performance":{"type":"object"}}},"SubscriptionInfo":{"type":"object","properties":{"current_tier":{"type":"string"},"available_upgrades":{"type":"array","items":{"type":"object"}}}},"ReferralStats":{"type":"object","properties":{"referral_link":{"type":"string","format":"uri"},"stats":{"type":"object","properties":{"total_referrals":{"type":"integer"},"signed_up":{"type":"integer"},"subscribed":{"type":"integer"}}}}}}},"tags":[{"name":"Authentication","description":"Register and authenticate for API access"},{"name":"Health Intelligence","description":"Submit health queries to specialized AI agents"},{"name":"Agent Catalog","description":"Browse available health agents and their capabilities"},{"name":"Usage & Billing","description":"Monitor API usage and manage subscriptions"},{"name":"Referral Program","description":"Referral links and conversion tracking"}],"externalDocs":{"description":"Developer Portal","url":"https://genesisworldhealth.com/developers"}}