📘 API Documentation

🔐 Authentication

All API endpoints require authentication via:

  • BaseURL: https://astrology-api.com/api/v1
  • Authorization: Bearer <your_jwt_token>
  • x-api-key: <your_api_key>

Obtain your API key from the developer dashboard.

GET: /basic-chart? year=2023&month=12&day=20&hour=12&min=0&sec=0

Generate a basic astrological chart with planetary positions and house placements for a given birth date and time. Requires info level access.

GET: /panchanga? year=2023&month=12&day=20&hour=12&min=0&sec=0

Retrieve Panchanga details, including Tithi, Nakshatra, Yoga, and Karana, for a specific date and time. Requires info level access.

GET: /planetary-insights? year=2023&month=12&day=20&hour=12&min=0&sec=0

Provide detailed insights into planetary influences and their astrological significance based on birth details. Requires info level access.

GET: /dasha? year=2023&month=12&day=20&hour=12&min=0&sec=0

Calculate the planetary periods (Dasha) and sub-periods for a given birth date and time. Requires info level access.

GET: /navamsa? year=2023&month=12&day=20&hour=12&min=0&sec=0

Generate the Navamsa (D9) chart, focusing on the divisional chart for marriage and deeper planetary analysis. Requires info level access.

GET: /dasamsa? year=2023&month=12&day=20&hour=12&min=0&sec=0

Generate the Dasamsa (D10) chart, analyzing career and professional prospects based on birth details. Requires info level access.

GET: /divisional-charts? year=2023&month=12&day=20&hour=12&min=0&sec=0&varga=D45

Generate a specific divisional chart (e.g., D45) for detailed astrological analysis based on the provided Varga. Requires info level access.

POST: /compatibility

Calculate astrological compatibility between two individuals based on their birth details, including Ashtakoota matching and recommendations.

{
  "groom": {
    "year": 1995,
    "month": 5,
    "day": 20,
    "hour": 14,
    "min": 30,
    "sec": 0,
    "latitude": 28.6139,
    "longitude": 77.209
  },
  "bride": {
    "year": 1997,
    "month": 7,
    "day": 10,
    "hour": 9,
    "min": 15,
    "sec": 0,
    "latitude": 19.076,
    "longitude": 72.8777
  }
}