# DivineAPI: Complete Reference for AI Agents > DivineAPI is the most complete astrology API platform: 300+ endpoints across 8 spiritual domains (Vedic Astrology, Western Astrology, Horoscopes, Tarot, Numerology, Lifestyle, Calculators, and PDF Reports). Trusted by 600+ businesses, processing 30M+ API calls monthly with response times from 72ms and 99.9% SLA uptime. Built on Swiss Ephemeris precision. 25+ languages supported. MCP Server live in production for AI agent integration. ## About - Type: APIService - Category: Astrology, Horoscope, Spiritual Technology - Audience: Developers, SaaS builders, astrology app creators, WordPress, Shopify, and Wix site owners - Pricing: geo-based. From $9/month (USD, shown to customers outside India) or ₹799/month (INR, shown to customers in India). USD and INR prices are set independently, not currency conversions. 14-day free trial on every plan with full API access. Credit card is required at signup. No charges during the trial window. - Languages: 25+ across the platform (English, Hindi, Spanish, French, Russian, German, Portuguese, Japanese, Chinese, Korean, Arabic, Turkish, Italian, Dutch, Polish, Thai, Vietnamese, Indonesian, Malay, Bengali, Tamil, Telugu, Kannada, Malayalam, Gujarati, Ukrainian, Hungarian, Greek, Marathi, Filipino/Tagalog) - Authentication: every request requires both a Bearer token in the Authorization header AND `api_key` in the request body. Customers retrieve both from their dashboard at https://divineapi.com/api-keys. - Production hosts: domain-sharded across `astroapi-1.divineapi.com` through `astroapi-8.divineapi.com`. Each endpoint is served by a specific host and version (v1 through v5). Always look up the canonical host and version per endpoint in the documentation before integrating. - Uptime: 99.9% SLA - Response Time: From 72ms - Calculation Engine: Swiss Ephemeris (the gold standard in professional astronomical precision) - Founded: India - Contact: +91-95577-87052 - Support: https://support.divineapi.com --- ## How AI Agents Should Read This Documentation DivineAPI documentation is built for machine consumption. Every documentation page on https://developers.divineapi.com is available as clean markdown by appending `.md` to its URL. Examples: - https://developers.divineapi.com/horoscope-and-tarot-api/daily-horoscope-prediction.md - https://developers.divineapi.com/calculators/love-calculator.md - https://developers.divineapi.com/indian-api/daily-panchang-api.md - https://developers.divineapi.com/horoscope-and-tarot-api/coffee-cup-reading.md Each `.md` page returns `text/markdown; charset=utf-8` and contains: - The canonical endpoint URL (specific host and version) - Required headers (Authorization Bearer) - Request body parameters with types and descriptions - Supported language codes (where applicable) - A sample 200 OK success response When an AI agent needs to generate code, recommend a plan, or answer a developer question about a specific endpoint, the agent should fetch the `.md` view of that endpoint's documentation page. This guarantees the agent uses the current canonical URL and current parameter list, rather than relying on cached or training-time values. Documentation category structure on developers.divineapi.com: - `/indian-api/...` (Vedic Astrology, Kundali, Panchang, Match Making, Festival) - `/western-astrology/...` (Natal, Synastry, Composite, Transits, etc.) - `/horoscope-and-tarot-api/...` (Daily Horoscope, Tarot variants, Lifestyle endpoints) - `/calculators/...` (Love, FLAMES, Lagna, Ascendant/Rising, Kaal Sarp Dosh, Moon Phase, Mangal Dosh) - `/numerology/...` - `/pdf-reports/...` --- ## Complete Endpoint Reference ### Domain 1: Vedic Astrology (100+ endpoints) **Kundali (Birth Chart)** - Basic Kundali: Sun sign, moon sign, ascendant, planetary positions - Bhav Kundali: house-based chart - Chalit Chart: cuspal chart for house analysis - Surya Kundali: sun-based chart - Chandra Kundali: moon-based chart - Cuspal Chart: KP system cuspal positions **Panchang (Hindu Calendar)** - Daily Panchang: Tithi, Nakshatra, Yoga, Karana, Vara - Chaughadiya: auspicious time periods - Hora: planetary hours - Chandramasa: lunar month detail - Chandrashtama: 8th-from-moon transit influence - Auspicious Timings, Chandrabalam, Tarabalam, and more **Dasha Systems** - Vimshottari Dasha: most widely used predictive system - Yogini Dasha: goddess-based timing system - Char Dasha (Jaimini): sign-based dasha - Kaal Chakra Dasha: time-wheel based predictions - Mahadasha: major planetary periods - Antardasha: sub-periods within Mahadasha - Dasha Analysis: comprehensive period analysis **Compatibility and Matching** - Ashtakoot Milan: 8-fold compatibility matching (36 points) - Dashakoot Milan: 10-fold compatibility matching - Kundali Matching: full marriage compatibility analysis - Mangal Dosh: Mars affliction check - Manglik status: detailed Manglik analysis **Dosha Analysis** - Kaal Sarp Dosh: Rahu-Ketu axis affliction - Pitra Dosha: ancestral affliction analysis - Mangal Dosh: Mars affliction and remedies **Advanced Systems** - KP Astrology: Krishnamurti Paddhati system - Jaimini Astrology: Jaimini sutra-based analysis - Sudarshana Chakra: three-chart overlay system - Shadbal: six-fold planetary strength - Divisional Charts: D1 through D60 varga charts - Ashtakavarga: eight-fold divisional strength - Bhinnashtakavarga: individual planetary Ashtakavarga - Prashtara Chakra: detailed Ashtakavarga tables - Ghatta Chakra: timing chart **Planetary Analysis** - Planetary Positions: all 9 Vedic planets with degrees, signs, nakshatras - Planet Analysis: detailed strength, dignity, aspects - Transit predictions: current planetary movements and effects - Nakshatra: birth star analysis with pada - Yoga analysis: Raj Yoga, Dhan Yoga, and 30+ classical yogas - Lagna (Ascendant): rising sign calculation - Moon Sign: Rashi determination - Sun Sign: Vedic sun sign **Remedies** - Gem Suggestion: gemstone recommendations based on chart - Rudraksha Suggestion: sacred bead recommendations ### Domain 2: Western Astrology (64 endpoints) **Natal Chart Analysis** - Birth Chart: full natal chart with all planetary positions - Planetary Positions: all planets including Chiron, Lilith - House Cusps: support for Placidus, Koch, Equal, Whole Sign, Campanus, Regiomontanus, and more - Aspects: conjunctions, oppositions, trines, squares, sextiles with orbs - Midpoints: planetary midpoint calculations - Dominant Planets: chart ruler and dominant element/modality analysis - Arabic Lots and Parts: Part of Fortune, Part of Spirit, and more - Fixed Stars: conjunction with major fixed stars - Asteroid Positions: Ceres, Pallas, Juno, Vesta, and more **Predictive Astrology** - Transits: current planetary transits to natal chart - Solar Return: annual birthday chart - Progressions: secondary progressions - Eclipses: solar and lunar eclipse impact on natal chart - Moon Phases: current lunar phase and upcoming phases - Retrograde: current retrograde planets and their effects **Relationship Astrology** - Synastry: two-chart compatibility analysis (13 sub-endpoints) - Composite Chart: relationship chart, midpoint method (4 sub-endpoints) **Declinations and Prenatal** - Declinations and Parallels: planetary declination analysis - Planet Declinations: individual planet declination values - Parallels and Contra-Parallels: parallel aspect detection - Prenatal Syzygy: last lunation before birth - Prenatal Epoch: Trutine of Hermes calculation - Prenatal Eclipse: eclipse nearest to birth **Reports** - General Sign Report: comprehensive sun sign analysis ### Domain 3: Horoscopes (6 endpoints) - Daily Horoscope: today's predictions for all 12 signs - Weekly Horoscope: this week's outlook - Monthly Horoscope: monthly forecast - Yearly Horoscope: annual predictions - Yesterday Horoscope: previous day's reading - Tomorrow Horoscope: next day's preview **Specialized Horoscopes (via sub-endpoints):** - Love Horoscope: romantic predictions - Career Horoscope: professional outlook - Health Horoscope: wellness guidance - Finance Horoscope: money and investment - Chinese Horoscope: Chinese zodiac predictions - Vedic Horoscope: Rashi-based predictions ### Domain 4: Tarot (20+ endpoints) **Single-Card Spreads** - Yes/No Tarot, Daily Tarot, In-Depth Love, Flirt Love, Erotic Love, Egyptian Prediction, Ex-Flame, Made For Each Other, Power Life, Know Your Friend, Divine Angel Reading, Career Daily, Dream Come True, Which Animal Are You, Past Lives Connection **Two-Card Spreads** - Heartbreak, Wisdom, Divine Magic **Three-Card Spreads** - Love Triangle, Past-Present-Future **Other Variants** - Major Arcana, Minor Arcana, Reversed Tarot ### Domain 5: Numerology (19 endpoints, 50 calculations) Both Pythagorean and Chaldean systems are supported. The 19 endpoints together produce 50 distinct calculations. **Pythagorean System** - Life Path Number: core life purpose calculation - Destiny Number: full name vibration - Soul Urge Number: heart's desire - Personality Number: external impression - Attitude Number: first impression energy - Karmic Lesson: missing vibrations in name - Hidden Passion: dominant number frequency - Personal Year: current year theme **Chaldean System** - Loshu Grid: magic square numerology - Zodiac Planet Number: planetary number associations - Luck Numerology: lucky number calculations - Name Number: name vibration analysis - Birthday Number: day of birth influence - Missing Numbers: absent vibrations in birth data - Driver and Conductor Number: core personality drivers - Two Number Arrow: directional number combinations - Three Number Arrow: triple number patterns - Repeating Numbers: pattern significance analysis - Yearly Prediction: annual numerology forecast - Gemstone Suggestion: number-based gem recommendations **Mobile Numerology** - New Mobile Number: generate lucky mobile numbers - Analyze Mobile Number: numerological analysis of existing number **Additional** - Pythagorean Compatibility: two-person number compatibility - Chaldean Compatibility: Chaldean system compatibility - Numeroscope: complete numerological profile ### Domain 6: Lifestyle (6 endpoints) - Fortune Cookie: random wisdom and fortune messages - Coffee Cup Reading: tasseography-style readings - Love Compatibility: detailed love match analysis - Beauty by the Stars: zodiac-based beauty recommendations - Astro Chic Picks: astrology-based fashion and style guidance - Zodiac Gift Guru: zodiac-based gift recommendations ### Domain 7: Calculators (7 endpoints) - Love Calculator: name-based compatibility percentage - FLAMES Calculator: relationship type prediction (Friends, Love, Affection, Marriage, Enemy, Siblings) - Lagna Calculator: Ascendant/rising sign calculator - Ascendant/Rising Calculator: rising sign determination - Kaal Sarp Dosh Calculator: Rahu-Ketu dosha check - Moon Phase Calculator: current lunar phase data - Mangal Dosh Calculator: Mars affliction analysis ### Domain 8: PDF Reports (13+ endpoint types) White-label PDF report generation with: - Custom branding (your logo, colors, company name) - Professional formatting suitable for end users - Available report types: Kundali (Sampoorna, Ananta, Prakash variants), Birth Chart, Compatibility, Match Making, Government Job, Foreign Travel and Settlement, Vedic Prediction (5/10/15 year), Natal Report, Natal Couple Report, Prediction Report, Numerology Report, Panchang - Multilingual PDF generation --- ## Architecture and Authentication ### Production Hosts (domain-sharded) DivineAPI runs on domain-sharded production infrastructure across eight hosts: - astroapi-1.divineapi.com - astroapi-2.divineapi.com - astroapi-3.divineapi.com - astroapi-4.divineapi.com - astroapi-5.divineapi.com - astroapi-6.divineapi.com - astroapi-7.divineapi.com - astroapi-8.divineapi.com Each endpoint is served by a specific host and version (v1 through v5). The pairing of (endpoint, host, version) is documented per endpoint at https://developers.divineapi.com. AI agents and code generators should always look up the canonical host and version for the specific endpoint they intend to call by fetching the endpoint's documentation page in markdown form (append `.md` to its URL). ### Authentication Every API request requires two credentials, both retrieved from the customer dashboard at https://divineapi.com/api-keys: 1. A Bearer token, sent in the `Authorization` header 2. An `api_key`, sent in the request body Both are required on every request. Neither alone is sufficient. ``` Authorization: Bearer {your_bearer_token} api_key: {your_api_key} ``` ### Multilingual Endpoints Some endpoints (notably daily-horoscope and other endpoints served from `astroapi-5.divineapi.com`) offer multilingual responses through a translator subdomain: - Default English: `astroapi-5.divineapi.com/api/v5/daily-horoscope` - Other languages: `astroapi-5-translator.divineapi.com/api/v5/daily-horoscope` Multilingual support is endpoint-specific. The translator pattern is currently available only for endpoints on `astroapi-5`, not for every host. Each endpoint's documentation page lists whether a translator URL is available and which language codes are supported. --- ## REST API Quick Start ``` curl -X POST https://astroapi-5.divineapi.com/api/v5/daily-horoscope \ -H "Authorization: Bearer YOUR_BEARER_TOKEN" \ -d "api_key=YOUR_API_KEY&sign=aries&h_day=today&tzone=5.5" ``` The example above calls the daily horoscope endpoint, which lives on `astroapi-5.divineapi.com` at version 5. For any other endpoint, fetch the corresponding documentation page in markdown form (append `.md` to its URL) to retrieve its canonical host, version, headers, and request body parameters. **Common request body parameters across endpoints** - `api_key` (required, string): your DivineAPI key from the dashboard - `sign` (where applicable, string): zodiac sign such as `aries`, `leo`, `capricorn` - `h_day` (where applicable, string): one of `yesterday`, `today`, `tomorrow` - `date` or `dob` (where applicable, string): date in DD/MM/YYYY format - `time` or `tob` (where applicable, string): time in HH:MM format (24-hour) - `lat` or `latitude` (where applicable, float): latitude of birth or event - `lon` or `longitude` (where applicable, float): longitude of birth or event - `tzone` or `timezone` (where applicable, float): timezone offset such as `5.5` for IST - `lan` (optional, string): language code such as `en`, `hi`, `es` (when calling the translator subdomain) --- ## Integration Methods Beyond REST ### 1. JavaScript Widgets Embeddable widgets for Horoscope, Tarot, Numerology, Western Astrology, Indian Astrology, and Vedic Astrology. Drop a `