{
  "description": "Generate complete Vedic astrology kundali with 16 divisional charts",
  "endpoints": {
    "/api/generate-kundali": "Generate complete kundali (POST)",
    "/api/health": "Health check"
  },
  "example_advanced_request": {
    "ayanamsa": "Lahiri/Chitrapaksha",
    "birth_city": "Honavar",
    "birth_country": "India",
    "birth_state": "Karnataka",
    "day": 8,
    "elevation": 0,
    "gender": "male",
    "hour": 14,
    "latitude": 14.2798,
    "longitude": 74.4439,
    "minute": 47,
    "month": 10,
    "name": "Shyam Bhat",
    "second": 36,
    "timezone": 5.5,
    "timezone_name": "Asia/Kolkata",
    "year": 1991
  },
  "example_basic_request": {
    "birth_city": "Honavar",
    "birth_country": "India",
    "birth_state": "Karnataka",
    "day": 8,
    "gender": "male",
    "hour": 14,
    "latitude": 14.2798,
    "longitude": 74.4439,
    "minute": 47,
    "month": 10,
    "name": "Shyam Bhat",
    "timezone": 5.5,
    "year": 1991
  },
  "field_descriptions": {
    "ayanamsa": "Ayanamsa system - Optional, defaults to Lahiri/Chitrapaksha",
    "birth_city": "Birth city name",
    "birth_country": "Birth country name",
    "birth_state": "Birth state/province name",
    "day": "Birth day (1-31)",
    "elevation": "Elevation in meters - Optional, defaults to 0",
    "gender": "male, female, or other",
    "hour": "Birth hour in 24-hour format (0-23)",
    "latitude": "Latitude in decimal degrees (Positive=North, Negative=South)",
    "longitude": "Longitude in decimal degrees (Positive=East, Negative=West)",
    "minute": "Birth minute (0-59)",
    "month": "Birth month (1-12)",
    "name": "Full name of the person",
    "second": "Birth second (0-59) - Optional, defaults to 0",
    "timezone": "UTC offset in hours (e.g., 5.5 for IST, -5.0 for EST)",
    "timezone_name": "IANA timezone name (e.g., Asia/Kolkata) - Optional",
    "year": "Birth year (YYYY)"
  },
  "important_notes": {
    "advanced_mode": "User manually enters all coordinates and timezone values",
    "basic_mode": "User enters city/state/country \u2192 Frontend geocodes \u2192 Sends with coordinates",
    "frontend_responsibility": "Frontend should use geocoding API (like Google Maps, OpenStreetMap) to convert city/state/country to longitude/latitude/timezone before sending to this API",
    "time_format": "All times should be in local civil time (not UTC)"
  },
  "name": "Kundali API",
  "request_fields": {
    "advanced_mode_fields": [
      "second",
      "elevation",
      "timezone_name",
      "ayanamsa"
    ],
    "always_required": [
      "name",
      "gender",
      "year",
      "month",
      "day",
      "hour",
      "minute",
      "longitude",
      "latitude",
      "timezone"
    ],
    "basic_mode_fields": [
      "birth_city",
      "birth_state",
      "birth_country"
    ]
  },
  "version": "1.0.0"
}