Vedic Astrology and Kundli MCP Server by RoxyAPI

{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2025-12-26",
      "description": "Date for ayanamsa calculation in YYYY-MM-DD format. Defaults to today if not provided. Ayanamsa changes by ~0.01 degrees per month due to the precession of Earth."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "09:00:00",
      "description": "Time of day in 24-hour HH:MM:SS format, interpreted in the timezone below. Omit for midnight UTC. The ayanamsa moves about 0.14 arcseconds across a day, so supplying the time matters only when reconciling a chart against reference software to the arcsecond."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "timezone": {
      "type": "string",
      "example": "Asia/Kolkata",
      "description": "IANA name (e.g. \"Asia/Kolkata\", \"America/New_York\"), decimal hours (e.g. 5.5 for IST, -5 for EST), or a fixed UTC offset (e.g. \"+05:30\"). IANA resolved to the offset in force at the given date and the time field above. Defaults to 0 (UTC)."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "2026-02-03",
      "time": "12:00:00",
      "latitude": 17.385044,
      "longitude": 78.486671
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-02-03",
      "description": "Date in YYYY-MM-DD format. Planetary positions are calculated for this date to determine mutual aspects (drishti)."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "12:00:00",
      "description": "Time in HH:MM:SS format (24-hour). Exact time affects fast-moving planets (Moon, Mercury) and aspect orbs."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "latitude": {
      "type": "number",
      "example": 17.385044,
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude in decimal degrees. Used for Lagna calculation which affects house-based aspect analysis."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5 (IST)."
    },
    "longitude": {
      "type": "number",
      "example": 78.486671,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees. Affects local sidereal time for positional calculations."
    },
    "coordinateSystem": {
      "enum": [
        "sidereal",
        "tropical"
      ],
      "type": "string",
      "default": "sidereal",
      "example": "sidereal",
      "description": "Coordinate system for longitude output. \"sidereal\" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. \"tropical\" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to \"sidereal\"."
    }
  }
}

{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 2026,
      "maximum": 2649,
      "minimum": 1551,
      "description": "Year for monthly analysis (1551 to 2649). Defaults to the current year (UTC)."
    },
    "month": {
      "type": "integer",
      "example": 2,
      "maximum": 12,
      "minimum": 1,
      "description": "Month number (1-12). Defaults to the current month (UTC)."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 0,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC)."
    },
    "coordinateSystem": {
      "enum": [
        "sidereal",
        "tropical"
      ],
      "type": "string",
      "default": "sidereal",
      "example": "sidereal",
      "description": "Coordinate system for longitude output. \"sidereal\" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. \"tropical\" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to \"sidereal\"."
    }
  }
}

{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 2026,
      "maximum": 2649,
      "minimum": 1551,
      "description": "Year for monthly analysis (1551 to 2649). Defaults to the current year (UTC)."
    },
    "month": {
      "type": "integer",
      "example": 2,
      "maximum": 12,
      "minimum": 1,
      "description": "Month number (1-12). Defaults to the current month (UTC)."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 0,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC)."
    },
    "coordinateSystem": {
      "enum": [
        "sidereal",
        "tropical"
      ],
      "type": "string",
      "default": "sidereal",
      "example": "sidereal",
      "description": "Coordinate system for longitude output. \"sidereal\" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. \"tropical\" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to \"sidereal\"."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "avasthaInfo": {
      "type": "boolean",
      "default": false,
      "example": true,
      "description": "Set true to include a localized meaning and one-sentence classical interpretation beside each graha avastha state, under avasthaInfo on that graha in meta. Defaults to false, so an existing integration is byte-identical until it opts in. Saves a second call to GET /avasthas and the client-side join that would otherwise be needed to turn Yuva or Swapna into readable text."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    },
    "modernPlanets": {
      "type": "boolean",
      "default": false,
      "example": true,
      "description": "Set true to also return Uranus, Neptune and Pluto, under the Sanskrit names Arun, Varun and Yam that Indian software prints for them. They arrive in a separate modernPlanets array, NOT inside meta, because classical Jyotish is defined over nine grahas: the moderns rule no sign, so they have no dignity, avastha, combustion or aspect strength and it would be fabrication to report one. Each carries longitude, rashi, degree in sign, nakshatra with pada and lord, and retrograde status. Defaults to false, so an existing integration is byte-identical until it opts in."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "scheme": {
      "enum": [
        "seven",
        "eight"
      ],
      "type": "string",
      "default": "eight",
      "example": "eight",
      "description": "Which Chara Karaka scheme to rank. \"eight\" includes Rahu, counting its degree in reverse because it moves retrograde, and returns eight offices including Pitrikaraka. \"seven\" ranks only the seven classical grahas and drops Pitrikaraka. Ketu is excluded from both, since it always mirrors the Rahu degree exactly. The two schemes can produce a different Atmakaraka for the same chart, so select the one your reference software uses. Defaults to \"eight\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "person1": {
        "date": "1990-07-04",
        "time": "10:12:00",
        "latitude": 28.6139,
        "longitude": 77.209
      },
      "person2": {
        "date": "1990-07-04",
        "time": "10:12:00",
        "latitude": 28.6139,
        "longitude": 77.209
      }
    }
  ],
  "required": [
    "person1",
    "person2"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "person1": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "example": "1990-07-04",
          "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
        },
        "time": {
          "type": "string",
          "format": "time",
          "example": "10:12:00",
          "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
        },
        "latitude": {
          "type": "number",
          "example": 28.6139,
          "maximum": 90,
          "minimum": -90,
          "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
        },
        "timezone": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "string"
            }
          ],
          "default": 5.5,
          "example": 5.5,
          "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
        },
        "longitude": {
          "type": "number",
          "example": 77.209,
          "maximum": 180,
          "minimum": -180,
          "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
        }
      },
      "description": "Birth data of the first person (typically the boy/groom in traditional Ashtakoot matching). Date, time, and location determine Moon nakshatra for koota scoring."
    },
    "person2": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "example": "1990-07-04",
          "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
        },
        "time": {
          "type": "string",
          "format": "time",
          "example": "10:12:00",
          "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
        },
        "latitude": {
          "type": "number",
          "example": 28.6139,
          "maximum": 90,
          "minimum": -90,
          "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
        },
        "timezone": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "string"
            }
          ],
          "default": 5.5,
          "example": 5.5,
          "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
        },
        "longitude": {
          "type": "number",
          "example": 77.209,
          "maximum": 180,
          "minimum": -180,
          "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
        }
      },
      "description": "Birth data of the second person (typically the girl/bride in traditional Ashtakoot matching). Moon nakshatra compared against person 1 across all 8 kootas."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "person1": {
        "date": "1990-07-04",
        "time": "10:12:00",
        "latitude": 28.6139,
        "longitude": 77.209
      },
      "person2": {
        "date": "1990-07-04",
        "time": "10:12:00",
        "latitude": 28.6139,
        "longitude": 77.209
      }
    }
  ],
  "required": [
    "person1",
    "person2"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "person1": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "example": "1990-07-04",
          "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
        },
        "time": {
          "type": "string",
          "format": "time",
          "example": "10:12:00",
          "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
        },
        "latitude": {
          "type": "number",
          "example": 28.6139,
          "maximum": 90,
          "minimum": -90,
          "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
        },
        "timezone": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "string"
            }
          ],
          "default": 5.5,
          "example": 5.5,
          "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
        },
        "longitude": {
          "type": "number",
          "example": 77.209,
          "maximum": 180,
          "minimum": -180,
          "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
        }
      },
      "description": "Birth data of the GROOM. Direction is load bearing in this system: Dina, Mahendra, Stree Deergha, Rasi and Vasya all count from the bride toward the groom, so sending the two people the wrong way round returns a different and wrong sheet without any error."
    },
    "person2": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "example": "1990-07-04",
          "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
        },
        "time": {
          "type": "string",
          "format": "time",
          "example": "10:12:00",
          "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
        },
        "latitude": {
          "type": "number",
          "example": 28.6139,
          "maximum": 90,
          "minimum": -90,
          "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
        },
        "timezone": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "string"
            }
          ],
          "default": 5.5,
          "example": 5.5,
          "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
        },
        "longitude": {
          "type": "number",
          "example": 77.209,
          "maximum": 180,
          "minimum": -180,
          "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
        }
      },
      "description": "Birth data of the BRIDE. Five of the ten poruthams count FROM this birth star, so this field is not interchangeable with person1. Date, time and location determine the Moon nakshatra and Moon rashi every porutham reads."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "person1": {
        "date": "1990-07-04",
        "time": "10:12:00",
        "latitude": 28.6139,
        "longitude": 77.209
      },
      "person2": {
        "date": "1990-07-04",
        "time": "10:12:00",
        "latitude": 28.6139,
        "longitude": 77.209
      }
    }
  ],
  "required": [
    "person1",
    "person2"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "person1": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "example": "1990-07-04",
          "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
        },
        "time": {
          "type": "string",
          "format": "time",
          "example": "10:12:00",
          "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
        },
        "latitude": {
          "type": "number",
          "example": 28.6139,
          "maximum": 90,
          "minimum": -90,
          "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
        },
        "timezone": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "string"
            }
          ],
          "default": 5.5,
          "example": 5.5,
          "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
        },
        "longitude": {
          "type": "number",
          "example": 77.209,
          "maximum": 180,
          "minimum": -180,
          "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
        }
      },
      "description": "Birth data of the GROOM. The comparison is directional, so this field is not interchangeable with person2: the match reads as balanced only when the bride carries no more affliction than the groom, and swapping the two people can flip the verdict."
    },
    "person2": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "example": "1990-07-04",
          "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
        },
        "time": {
          "type": "string",
          "format": "time",
          "example": "10:12:00",
          "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
        },
        "latitude": {
          "type": "number",
          "example": 28.6139,
          "maximum": 90,
          "minimum": -90,
          "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
        },
        "timezone": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "string"
            }
          ],
          "default": 5.5,
          "example": 5.5,
          "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
        },
        "longitude": {
          "type": "number",
          "example": 77.209,
          "maximum": 180,
          "minimum": -180,
          "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
        }
      },
      "description": "Birth data of the BRIDE. Date, time and location determine the Lagna, the Moon and Venus, which are the three points every papa point is counted from."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "latitude": 28.8944,
      "birthDate": "1984-11-03",
      "birthTime": "01:35:00",
      "longitude": 76.5894
    }
  ],
  "required": [
    "birthDate",
    "birthTime",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-06-21",
      "description": "Civil date to read, in YYYY-MM-DD format. Defaults to today (UTC). The panchanga day it names runs from sunrise at the birth coordinates to the next sunrise, not from midnight, so a reading for this date covers the night that follows it."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "latitude": {
      "type": "number",
      "example": 28.8944,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Sets the natal house cusps behind the Ashtakavarga scorecard and the KP significators, and the sunrise that opens the panchanga day."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node type for Rahu and Ketu. \"mean\" uses the smooth mean node, which is the traditional Vedic default and what printed panchangs use. \"true\" uses the osculating node, which swings up to 1.5 degrees either side of mean and can therefore move a node into a different rashi and change its gochara house. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: IANA name (e.g. \"Asia/Kolkata\", \"America/New_York\") OR decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). IANA strings are resolved to the DST-correct offset for the date being read. Interprets the birth time and the civil date below. Defaults to 5.5."
    },
    "birthDate": {
      "type": "string",
      "format": "date",
      "example": "1984-11-03",
      "description": "Birth date in YYYY-MM-DD format. Fixes the Janma Rashi and Janma Nakshatra every part of this reading is counted from, and the natal Ashtakavarga the bindu gate reads."
    },
    "birthTime": {
      "type": "string",
      "format": "time",
      "example": "01:35:00",
      "description": "Birth time in HH:MM:SS format (24-hour). The Moon moves about half a degree an hour, so an error here moves the Janma Rashi and Janma Nakshatra and therefore every gochara house count, the tarabala and the chandrabala in this response."
    },
    "longitude": {
      "type": "number",
      "example": 76.5894,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local sidereal time for the natal cusps and the sunrise the reading is composed at."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. \"lahiri\" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. \"kp-old\" uses the Krishnamurti original table from KP Reader-1. \"raman\" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses."
    },
    "datetime": {
      "type": "string",
      "format": "date-time",
      "example": "2026-08-23T13:47:46Z",
      "description": "ISO 8601 datetime (YYYY-MM-DDTHH:MM:SS) to read the running periods at, for a reading prepared for a future day, a backtest, or a chart cast for a past moment. Defaults to the current instant. Interpreted as local time in the request timezone (a trailing Z is accepted but ignored); with timezone 0 it is UTC."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node type for Rahu and Ketu, used ONLY when \"significators\" is true. Dasha dates themselves come from the Moon and never move with this field. \"mean\" uses the smooth mean node (traditional default). \"true\" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    },
    "significators": {
      "type": "boolean",
      "default": false,
      "example": false,
      "description": "Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. \"lahiri\" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. \"kp-old\" uses the Krishnamurti original table from KP Reader-1. \"raman\" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node type for Rahu and Ketu, used ONLY when \"significators\" is true. Dasha dates themselves come from the Moon and never move with this field. \"mean\" uses the smooth mean node (traditional default). \"true\" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    },
    "significators": {
      "type": "boolean",
      "default": false,
      "example": false,
      "description": "Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209,
      "mahadasha": "Jupiter"
    }
  ],
  "required": [
    "mahadasha",
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. \"lahiri\" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. \"kp-old\" uses the Krishnamurti original table from KP Reader-1. \"raman\" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node type for Rahu and Ketu, used ONLY when \"significators\" is true. Dasha dates themselves come from the Moon and never move with this field. \"mean\" uses the smooth mean node (traditional default). \"true\" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "mahadasha": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Jupiter",
      "description": "Mahadasha planet name, case-insensitive (e.g., jupiter, Jupiter, JUPITER all work). Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    },
    "significators": {
      "type": "boolean",
      "default": false,
      "example": false,
      "description": "Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209,
      "mahadasha": "Saturn",
      "antardasha": "Venus"
    }
  ],
  "required": [
    "mahadasha",
    "antardasha",
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. \"lahiri\" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. \"kp-old\" uses the Krishnamurti original table from KP Reader-1. \"raman\" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node type for Rahu and Ketu, used ONLY when \"significators\" is true. Dasha dates themselves come from the Moon and never move with this field. \"mean\" uses the smooth mean node (traditional default). \"true\" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "mahadasha": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Saturn",
      "description": "Mahadasha planet name, case-insensitive (e.g. saturn, Saturn, SATURN all work). Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury."
    },
    "antardasha": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Venus",
      "description": "Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive. Every Mahadasha contains all 9 lords, so a repeat such as saturn/saturn is valid."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    },
    "significators": {
      "type": "boolean",
      "default": false,
      "example": false,
      "description": "Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209,
      "mahadasha": "Saturn",
      "antardasha": "Venus",
      "pratyantardasha": "Rahu"
    }
  ],
  "required": [
    "mahadasha",
    "antardasha",
    "pratyantardasha",
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. \"lahiri\" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. \"kp-old\" uses the Krishnamurti original table from KP Reader-1. \"raman\" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node type for Rahu and Ketu, used ONLY when \"significators\" is true. Dasha dates themselves come from the Moon and never move with this field. \"mean\" uses the smooth mean node (traditional default). \"true\" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "mahadasha": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Saturn",
      "description": "Mahadasha planet name, case-insensitive. Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury."
    },
    "antardasha": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Venus",
      "description": "Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    },
    "significators": {
      "type": "boolean",
      "default": false,
      "example": false,
      "description": "Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above."
    },
    "pratyantardasha": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Rahu",
      "description": "Pratyantardasha (antara) planet name inside that Antardasha, case-insensitive."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "sookshma": "Jupiter",
      "longitude": 77.209,
      "mahadasha": "Saturn",
      "antardasha": "Venus",
      "pratyantardasha": "Rahu"
    }
  ],
  "required": [
    "mahadasha",
    "antardasha",
    "pratyantardasha",
    "sookshma",
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Ayanamsa system used to place the birth Moon in its nakshatra, which sets every dasha start and end date. \"lahiri\" uses Lahiri/Chitrapaksha, the traditional Vedic standard, and is the default. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, matching Krishnamurti Paddhati software. \"kp-old\" uses the Krishnamurti original table from KP Reader-1. \"raman\" uses the B.V. Raman ayanamsa, the second frame traditional Indian software commonly offers beside Lahiri. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. Switching frames shifts every dasha boundary by weeks, so pick the one your reference software uses."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node type for Rahu and Ketu, used ONLY when \"significators\" is true. Dasha dates themselves come from the Moon and never move with this field. \"mean\" uses the smooth mean node (traditional default). \"true\" uses the osculating node, which swings up to 1.5 degrees either side of mean over a 173-day cycle and can therefore change which house or star a node falls in. Defaults to \"mean\"."
    },
    "sookshma": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Jupiter",
      "description": "Sookshma dasha planet name inside that Pratyantardasha, case-insensitive. Every full period contains all 9 lords, so a repeat such as saturn/saturn/saturn/saturn is valid."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "mahadasha": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Saturn",
      "description": "Mahadasha planet name, case-insensitive. Valid: Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury."
    },
    "antardasha": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Venus",
      "description": "Antardasha (bhukti) planet name inside that Mahadasha, case-insensitive."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    },
    "significators": {
      "type": "boolean",
      "default": false,
      "example": false,
      "description": "Set true to attach the KP significators of each period lord: its star lord, sub lord, occupied house, the houses it signifies at levels L1 to L4, and a strength grade. Off by default, so responses stay exactly as they are for clients that only need dates. Requires the birth latitude and longitude, since significators are read off a Placidus house chart, and uses the same ayanamsa frame selected above."
    },
    "pratyantardasha": {
      "enum": [
        "Ketu",
        "Venus",
        "Sun",
        "Moon",
        "Mars",
        "Rahu",
        "Jupiter",
        "Saturn",
        "Mercury"
      ],
      "type": "string",
      "example": "Rahu",
      "description": "Pratyantardasha (antara) planet name inside that Antardasha, case-insensitive."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "division": 10,
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude",
    "division"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "division": {
      "type": "integer",
      "example": 10,
      "description": "Divisional chart number. Each division reveals a specific life area. Supported: 2 (Hora, wealth), 3 (Drekkana, siblings), 4 (Chaturthamsa, property), 7 (Saptamsa, children), 9 (Navamsa, marriage), 10 (Dasamsa, career), 12 (Dwadasamsa, parents), 16 (Shodasamsa, vehicles), 20 (Vimsamsa, spirituality), 24 (Chaturvimsamsa, education), 27 (Bhamsa, strength), 30 (Trimsamsa, misfortunes), 40 (Khavedamsa, merit), 45 (Akshavedamsa, character), 60 (Shashtiamsa, past life karma)."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "year": 2026
    }
  ],
  "required": [
    "year"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 2026,
      "maximum": 2649,
      "minimum": 1551,
      "description": "Year to scan for ecliptic crossings (1551 to 2649)."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 0,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC)."
    },
    "coordinateSystem": {
      "enum": [
        "sidereal",
        "tropical"
      ],
      "type": "string",
      "default": "sidereal",
      "example": "sidereal",
      "description": "Coordinate system for longitude output. \"sidereal\" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. \"tropical\" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to \"sidereal\"."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "2026-07-25",
      "latitude": 19.076,
      "longitude": 72.8777
    }
  ],
  "required": [
    "date",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-07-25",
      "description": "Local calendar date to judge, in YYYY-MM-DD format. There is deliberately no time field: heliacal visibility is a once-a-day verdict read at that day sunrise or sunset, so a clock time could only pick a different day."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "latitude": {
      "type": "number",
      "example": 19.076,
      "maximum": 60,
      "minimum": -60,
      "description": "Observer latitude in decimal degrees, restricted to -60 to 60. Visibility depends on the observer, unlike the longitude orb every chart API reports, because the angle the ecliptic makes with the horizon decides how long a graha lingers after the Sun. Beyond this band the classical rule stops describing solar glare and starts describing polar horizon geometry, so it is declined rather than answered wrongly."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: IANA name (e.g. \"Asia/Kolkata\", \"Europe/London\") OR decimal hours from UTC. Fixes which local day the date refers to, and every datetime in the response is returned in it. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 72.8777,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees. Sets local sunrise and sunset, which are the instants the verdict is read at. Example: Mumbai 72.8777, Delhi 77.2090, London -0.1278."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format"
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. CRITICAL for accurate Lagna and house calculations."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "kp-newcomb",
      "example": "kp-newcomb",
      "description": "Ayanamsa system for sidereal conversion. \"kp-newcomb\" uses the KP-Newcomb dynamic formula (most common for KP). \"kp-old\" uses the Krishnamurti original table. \"lahiri\" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. \"raman\" uses the B.V. Raman ayanamsa, about 1.45 degrees below Lahiri. \"custom\" allows providing your own value via ayanamsaValue. Defaults to \"kp-newcomb\"."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees"
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5 (IST) for Vedic astrology."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees"
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format"
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format"
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "kp-newcomb",
      "example": "kp-newcomb",
      "description": "Ayanamsa system for sidereal conversion. \"kp-newcomb\" uses the KP-Newcomb dynamic formula (most common for KP). \"kp-old\" uses the Krishnamurti original table. \"lahiri\" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. \"raman\" uses the B.V. Raman ayanamsa, about 1.45 degrees below Lahiri. \"custom\" allows providing your own value via ayanamsaValue. Defaults to \"kp-newcomb\"."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees"
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5 (IST) for Vedic astrology."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees"
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "latitude": 28.6139,
      "birthDate": "1990-06-15",
      "birthTime": "07:30:00",
      "longitude": 77.209
    }
  ],
  "required": [
    "birthDate",
    "birthTime",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-09-14",
      "description": "Civil date to read, YYYY-MM-DD in the request timezone. Defaults to today (UTC). The Moon windows cover this date from midnight to midnight."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "12:00:00",
      "description": "Reading moment on that date, HH:MM:SS local. The ruling planets and the running sookshma lord are read at this instant. Defaults to 12:00:00; pass a market open or any hour for an intraday read."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "weights": {
      "type": "object",
      "default": {
        "cusps": 30,
        "dasha": 40,
        "moonWindows": 15,
        "rulingPlanets": 15
      },
      "example": {
        "cusps": 30,
        "dasha": 40,
        "moonWindows": 15,
        "rulingPlanets": 15
      },
      "required": [
        "cusps",
        "dasha",
        "rulingPlanets",
        "moonWindows"
      ],
      "properties": {
        "cusps": {
          "type": "number",
          "example": 30,
          "maximum": 100,
          "minimum": 0,
          "description": "Percent of the final score the cusps layer carries."
        },
        "dasha": {
          "type": "number",
          "example": 40,
          "maximum": 100,
          "minimum": 0,
          "description": "Percent of the final score the dasha layer carries."
        },
        "moonWindows": {
          "type": "number",
          "example": 15,
          "maximum": 100,
          "minimum": 0,
          "description": "Percent of the final score the moonWindows layer carries."
        },
        "rulingPlanets": {
          "type": "number",
          "example": 15,
          "maximum": 100,
          "minimum": 0,
          "description": "Percent of the final score the rulingPlanets layer carries."
        }
      },
      "description": "Layer weights in percent, all four required, summing to 100. Defaults to the convention, cusps 30, dasha 40, rulingPlanets 15, moonWindows 15. Seventy percent of the default sits on the cusps and the outer dasha levels, which hold for months, so a chart reads inside a narrow band all month and the bands separate charts more than days. Move weight onto rulingPlanets and moonWindows for a reading that turns with the day."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman"
      ],
      "type": "string",
      "default": "kp-newcomb",
      "example": "kp-newcomb",
      "description": "Ayanamsa system for sidereal conversion. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. \"kp-old\" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. \"lahiri\" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. \"raman\" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to \"kp-newcomb\"."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth latitude in decimal degrees. Sets the Placidus cusps; also the place the ruling planets and the Moon windows are read at."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone as an IANA name (Asia/Kolkata) or decimal hours from UTC. Applies to the birth time, to the reading date and time, and to every local timestamp in the response. IANA names resolve to the offset in force on the date being read."
    },
    "birthDate": {
      "type": "string",
      "format": "date",
      "example": "1990-06-15",
      "description": "Birth date, YYYY-MM-DD. Fixes the Placidus cusps, the four tier significators and the Vimshottari balance every layer reads."
    },
    "birthTime": {
      "type": "string",
      "format": "time",
      "example": "07:30:00",
      "description": "Birth time, HH:MM:SS, 24 hour, local to the birth place. The cusp sub lords move about one sub every four minutes of clock time, so this is the input the whole reading is most sensitive to."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth longitude in decimal degrees, east positive."
    },
    "gainHouses": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 12,
        "minimum": 1
      },
      "default": [
        2,
        11
      ],
      "example": [
        2,
        11
      ],
      "maxItems": 12,
      "minItems": 1,
      "description": "Houses whose significators count as gain, 1 to 12. Defaults to the convention, 2 and 11. Override it to run your own school: the two lists may not share a house."
    },
    "lossHouses": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 12,
        "minimum": 1
      },
      "default": [
        6,
        8,
        12
      ],
      "example": [
        6,
        8,
        12
      ],
      "maxItems": 12,
      "minItems": 1,
      "description": "Houses whose significators count as loss, 1 to 12. Defaults to the convention, 6 and 8 and 12. Override it to run your own school: the two lists may not share a house."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "2026-03-08",
      "time": "14:30:00",
      "latitude": 19.076,
      "longitude": 72.8777,
      "horaryNumber": 108
    }
  ],
  "required": [
    "horaryNumber",
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-03-08",
      "description": "Date the question was taken up for judgment, YYYY-MM-DD. Not a birth date: a horary chart needs no birth details at all, which is the point of the method."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "14:30:00",
      "description": "Time the question was taken up for judgment, 24-hour HH:MM:SS. In KP practice this is the moment the astrologer receives and understands the question, not the moment the querent first thought of it. It sets every planetary position and all twelve cusps except the Ascendant."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "kp-newcomb",
      "example": "kp-newcomb",
      "description": "Ayanamsa system for sidereal conversion. \"kp-newcomb\" uses the KP-Newcomb dynamic formula (most common for KP). \"kp-old\" uses the Krishnamurti original table. \"lahiri\" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. \"raman\" uses the B.V. Raman ayanamsa, about 1.45 degrees below Lahiri. \"custom\" allows providing your own value via ayanamsaValue. Defaults to \"kp-newcomb\"."
    },
    "latitude": {
      "type": "number",
      "example": 19.076,
      "maximum": 90,
      "minimum": -90,
      "description": "Latitude where the question is judged, decimal degrees. The house cusps are Placidus and therefore latitude dependent, so this is the place of judgment, not the querent birthplace."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: IANA name (e.g. \"Asia/Kolkata\") OR decimal hours from UTC. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 72.8777,
      "maximum": 180,
      "minimum": -180,
      "description": "Longitude where the question is judged, decimal degrees."
    },
    "horaryNumber": {
      "type": "integer",
      "example": 108,
      "maximum": 249,
      "minimum": 1,
      "description": "Horary number from 1 to 249, given by the querent while focused on their question. It maps to one of the 249 KP sub divisions of the zodiac, and that division sets the Ascendant of the chart. The querent should give the first number that comes to mind and use it once for that question; the astrologer never chooses it. Numbers outside 1 to 249 are rejected rather than wrapped, because a wrapped number would silently answer a different question."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format"
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "kp-newcomb",
      "example": "kp-newcomb",
      "description": "Ayanamsa system for sidereal conversion. \"kp-newcomb\" uses the KP-Newcomb dynamic formula (most common for KP). \"kp-old\" uses the Krishnamurti original table. \"lahiri\" uses Lahiri/Chitrapaksha ayanamsa matching most traditional Vedic software. \"raman\" uses the B.V. Raman ayanamsa, about 1.45 degrees below Lahiri. \"custom\" allows providing your own value via ayanamsaValue. Defaults to \"kp-newcomb\"."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees"
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5 (IST) for Vedic astrology."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees"
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "latitude": 28.6139,
      "longitude": 77.209,
      "endDatetime": "2025-01-15T23:59:00Z",
      "startDatetime": "2025-01-15T00:00:00Z",
      "intervalMinutes": 60
    }
  ],
  "required": [
    "startDatetime",
    "endDatetime",
    "intervalMinutes",
    "latitude",
    "longitude"
  ],
  "properties": {
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman"
      ],
      "type": "string",
      "default": "kp-newcomb",
      "example": "kp-newcomb",
      "description": "Ayanamsa system for sidereal conversion. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. \"kp-old\" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. \"lahiri\" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. \"raman\" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to \"kp-newcomb\"."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude in decimal degrees (for future Lagna calculations)"
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 0,
      "example": 5.5,
      "description": "IANA name (e.g. \"America/New_York\", \"Europe/London\") OR decimal hours from UTC. IANA resolved to the DST-correct offset for the startDatetime date. When non-zero, all datetimes are treated as local time in this timezone (Z suffix is ignored). Defaults to 0 (UTC)."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees (for future Lagna calculations)"
    },
    "endDatetime": {
      "type": "string",
      "format": "date-time",
      "example": "2025-01-15T23:59:00Z",
      "description": "End datetime in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Maximum 7 days from start. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC."
    },
    "startDatetime": {
      "type": "string",
      "format": "date-time",
      "example": "2025-01-15T00:00:00Z",
      "description": "Start datetime in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC."
    },
    "intervalMinutes": {
      "type": "number",
      "example": 60,
      "maximum": 1440,
      "minimum": 15,
      "description": "Time between calculations in minutes. Range: 15 (quarter-hourly) to 1440 (daily)."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "planet": "Sun",
      "endDate": "2025-12-31",
      "startDate": "2025-01-01"
    }
  ],
  "required": [
    "planet",
    "startDate",
    "endDate"
  ],
  "properties": {
    "planet": {
      "enum": [
        "Sun",
        "Moon",
        "Mars",
        "Mercury",
        "Jupiter",
        "Venus",
        "Saturn"
      ],
      "type": "string",
      "example": "Sun",
      "description": "Planet to track (case-insensitive). Valid values: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "endDate": {
      "type": "string",
      "format": "date",
      "example": "2025-12-31",
      "description": "Last day of the search, inclusive (YYYY-MM-DD), a calendar day in `timezone`. Not before startDate, at most 365 days after it."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman"
      ],
      "type": "string",
      "default": "kp-newcomb",
      "example": "kp-newcomb",
      "description": "Ayanamsa system for sidereal conversion. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. \"kp-old\" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. \"lahiri\" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. \"raman\" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to \"kp-newcomb\"."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 0,
      "example": 5.5,
      "description": "IANA name (e.g. \"America/New_York\", \"Europe/London\"), a fixed offset like \"+05:30\", OR decimal hours from UTC. One offset is taken from startDate (DST-correct for that date) and used for the whole range, so a window crossing a daylight-saving change is read on the earlier offset throughout; send a fixed offset if you need that explicit. The two dates are read as calendar days in this timezone and output times are converted to it, so one date with 5.5 is that whole Indian day. Defaults to 0 (UTC)."
    },
    "startDate": {
      "type": "string",
      "format": "date",
      "example": "2025-01-01",
      "description": "First day of the search (YYYY-MM-DD), a calendar day in `timezone`."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "datetime": {
      "type": "string",
      "format": "date-time",
      "example": "2025-01-15T10:30:00Z",
      "description": "ISO 8601 datetime (YYYY-MM-DDTHH:MM:SS) for ruling planets. Defaults to current time. Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude in decimal degrees"
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: IANA name (e.g. \"America/New_York\", \"Europe/London\") OR decimal hours from UTC. IANA resolved to the DST-correct offset based on birthDate or datetime. Defaults to 5.5."
    },
    "birthDate": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date (YYYY-MM-DD) to calculate significators. If provided with birthTime, response includes which houses each ruling planet signifies."
    },
    "birthTime": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time (HH:MM:SS) for significator calculation. Required if birthDate is provided."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees"
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "latitude": 17.385044,
      "longitude": 78.486671,
      "endDatetime": "2026-02-03T01:00:00Z",
      "startDatetime": "2026-02-03T00:00:00Z",
      "intervalMinutes": 5
    }
  ],
  "required": [
    "startDatetime",
    "endDatetime",
    "intervalMinutes",
    "latitude",
    "longitude"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "focus": {
      "enum": [
        "general",
        "finance"
      ],
      "type": "string",
      "default": "general",
      "example": "general",
      "description": "Which signification vocabulary the houseThemes map returns. \"general\" gives the classical bhava significations (self, wealth, siblings, home, and so on). \"finance\" gives the money reading of the same twelve bhavas, so house 2 returns income and savings, 5 speculation and risk appetite, 8 sudden money and leverage, 11 gains and profits, and 12 expenses and capital outflow. Use \"finance\" for wealth, income, business and market timing questions in Krishnamurti Paddhati, where the significator house groups 2, 6, 10, 11 for earned income and 5, 8, 11 for speculation are read against a running dasha. Defaults to \"general\"."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman"
      ],
      "type": "string",
      "default": "kp-newcomb",
      "example": "kp-newcomb",
      "description": "Ayanamsa system for sidereal conversion. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. \"kp-old\" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. \"lahiri\" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. \"raman\" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to \"kp-newcomb\"."
    },
    "latitude": {
      "type": "number",
      "example": 17.385044,
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude in decimal degrees"
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved once, at the start of the window, and that offset applies to every time in the response. When non-zero, all datetimes are treated as local time in this timezone (Z suffix is ignored). Output times are also converted to this timezone. Defaults to 5.5 (IST)."
    },
    "longitude": {
      "type": "number",
      "example": 78.486671,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees"
    },
    "endDatetime": {
      "type": "string",
      "format": "date-time",
      "example": "2026-02-03T01:00:00Z",
      "description": "End of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC."
    },
    "startDatetime": {
      "type": "string",
      "format": "date-time",
      "example": "2026-02-03T00:00:00Z",
      "description": "Start of the interval range in ISO 8601 (YYYY-MM-DDTHH:MM:SS). Interpreted as local time when a non-zero timezone is provided (a trailing Z is accepted but ignored); with timezone 0 it is UTC."
    },
    "intervalMinutes": {
      "type": "integer",
      "example": 5,
      "maximum": 1440,
      "minimum": 1,
      "description": "Interval between calculations in minutes (1-1440). Use 1-5 for birth time rectification."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "planet": "Moon",
      "endDate": "2025-01-31",
      "startDate": "2025-01-01"
    }
  ],
  "required": [
    "planet",
    "startDate",
    "endDate"
  ],
  "properties": {
    "planet": {
      "enum": [
        "Sun",
        "Moon",
        "Mars",
        "Mercury",
        "Jupiter",
        "Venus",
        "Saturn"
      ],
      "type": "string",
      "example": "Moon",
      "description": "Planet to track (case-insensitive). Valid values: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "endDate": {
      "type": "string",
      "format": "date",
      "example": "2025-01-31",
      "description": "Last day of the search, inclusive (YYYY-MM-DD), a calendar day in `timezone`. Not before startDate, at most 365 days after it."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman"
      ],
      "type": "string",
      "default": "kp-newcomb",
      "example": "kp-newcomb",
      "description": "Ayanamsa system for sidereal conversion. \"kp-newcomb\" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. \"kp-old\" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. \"lahiri\" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. \"raman\" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to \"kp-newcomb\"."
    },
    "nodeType": {
      "enum": [
        "mean",
        "true"
      ],
      "type": "string",
      "default": "mean",
      "example": "mean",
      "description": "Lunar node convention. \"mean\" is the smoothed average node, which always moves retrograde; \"true\" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to \"mean\"."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 0,
      "example": 5.5,
      "description": "IANA name (e.g. \"America/New_York\", \"Europe/London\"), a fixed offset like \"+05:30\", OR decimal hours from UTC. One offset is taken from startDate (DST-correct for that date) and used for the whole range, so a window crossing a daylight-saving change is read on the earlier offset throughout; send a fixed offset if you need that explicit. The two dates are read as calendar days in this timezone and output times are converted to it, so one date with 5.5 is that whole Indian day. Defaults to 0 (UTC)."
    },
    "startDate": {
      "type": "string",
      "format": "date",
      "example": "2025-01-01",
      "description": "First day of the search (YYYY-MM-DD), a calendar day in `timezone`."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "2025-12-17",
      "time": "12:00:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2025-12-17",
      "description": "Date in YYYY-MM-DD format. Panchang elements (Tithi, Nakshatra, Yoga, Karana) are calculated for this date."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "12:00:00",
      "description": "Time in HH:MM:SS format (24-hour). Determines the exact Moon and Sun positions for tithi and nakshatra calculation."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude in decimal degrees. Determines sunrise/sunset times which define the Vara (weekday) and muhurta boundaries."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5 (IST)."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees. Affects local time calculations for sunrise/sunset-dependent panchang elements."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "2026-02-03",
      "latitude": 17.385044,
      "longitude": 78.486671
    }
  ],
  "required": [
    "date",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-02-03",
      "description": "Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "latitude": {
      "type": "number",
      "example": 17.385044,
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude in decimal degrees. Determines sunrise and sunset times which define day/night boundaries for muhurta calculations."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Used for accurate sunrise/sunset calculation and output time formatting. Essential for correct Choghadiya periods outside IST. Defaults to 5.5 (IST)."
    },
    "longitude": {
      "type": "number",
      "example": 78.486671,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees. Affects local time calculations for sunrise, sunset, and muhurta period boundaries."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "2026-02-03",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-02-03",
      "description": "Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude in decimal degrees. Determines sunrise and sunset times which define day/night boundaries for muhurta calculations."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Send the timezone that matches the coordinates: sunrise, sunset and every muhurta boundary are found by searching forward from local midnight, so the default anchors the search to an Indian day. Omitting it for a location outside IST returns a correctly ordered set of periods for the wrong window, shifted by the difference between 5.5 and the real offset. Defaults to 5.5 (IST)."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees. Affects local time calculations for sunrise, sunset, and muhurta period boundaries."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "2026-02-03",
      "latitude": 17.385044,
      "longitude": 78.486671
    }
  ],
  "required": [
    "date",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-02-03",
      "description": "Date in YYYY-MM-DD format. A single-digit month or day is accepted and zero-padded (2026-3-5 becomes 2026-03-05). Impossible calendar dates are rejected. Calculations that read planetary positions support 1550-01-02 to 2650-01-22; outside that span they answer 400 with code date_out_of_range, and a calculation that reads a window around the date (a sunrise search, a run of days) may answer the same 400 for a date within a few days of either end."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "latitude": {
      "type": "number",
      "example": 17.385044,
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude in decimal degrees. Determines sunrise and sunset times which define day/night boundaries for muhurta calculations."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Used for accurate sunrise/sunset calculation and output time formatting. Essential for correct Hora periods outside IST. Defaults to 5.5 (IST)."
    },
    "longitude": {
      "type": "number",
      "example": 78.486671,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees. Affects local time calculations for sunrise, sunset, and muhurta period boundaries."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "2026-02-03",
      "time": "12:00:00",
      "latitude": 17.385044,
      "longitude": 78.486671
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "orb": {
      "type": "number",
      "default": 1.5,
      "example": 1.5,
      "maximum": 3,
      "minimum": 0.5,
      "description": "Orb in degrees for parallel/contraparallel detection. Defaults to 1.5°."
    },
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-02-03",
      "description": "Date in YYYY-MM-DD format. Planetary declinations are calculated for this date to find parallel and contraparallel aspects."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "12:00:00",
      "description": "Time in HH:MM:SS format (24-hour). Exact time affects declination values, especially for the fast-moving Moon."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "latitude": {
      "type": "number",
      "example": 17.385044,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth latitude in decimal degrees, part of the birth record. Declinations are geocentric, as every published ephemeris prints them, so it does not move them."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5 (IST)."
    },
    "longitude": {
      "type": "number",
      "example": 78.486671,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth longitude in decimal degrees, part of the birth record. Declinations are geocentric, so it does not move them; the instant comes from date, time and timezone."
    }
  }
}

{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 2026,
      "maximum": 2649,
      "minimum": 1551,
      "description": "Year for monthly parallel analysis (1551 to 2649). Defaults to the current year (UTC)."
    },
    "month": {
      "type": "integer",
      "example": 2,
      "maximum": 12,
      "minimum": 1,
      "description": "Month number (1-12) for parallel analysis. Defaults to the current month (UTC)."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 0,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC)."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 2026,
      "maximum": 2649,
      "minimum": 1551,
      "description": "Year for monthly ephemeris (1551 to 2649). Defaults to the current year (UTC)."
    },
    "month": {
      "type": "integer",
      "example": 2,
      "maximum": 12,
      "minimum": 1,
      "description": "Month number (1-12) for ephemeris. Defaults to the current month (UTC)."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "coordinateSystem": {
      "enum": [
        "sidereal",
        "tropical"
      ],
      "type": "string",
      "default": "sidereal",
      "example": "sidereal",
      "description": "Coordinate system for longitude output. \"sidereal\" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. \"tropical\" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to \"sidereal\"."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "latitude": 17.385044,
      "birthDate": "1990-07-04",
      "birthTime": "10:12:00",
      "longitude": 78.486671,
      "transitDate": "2026-02-03"
    }
  ],
  "required": [
    "birthDate",
    "birthTime",
    "transitDate",
    "latitude",
    "longitude"
  ],
  "properties": {
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "latitude": {
      "type": "number",
      "example": 17.385044,
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude in decimal degrees. Determines Placidus house cusps for natal chart house assignments."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5 (IST)."
    },
    "birthDate": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Used to calculate the natal chart against which transits are analyzed."
    },
    "birthTime": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in HH:MM:SS format (24-hour). Critical for accurate natal Lagna and Placidus house cusps which determine transit house placements."
    },
    "longitude": {
      "type": "number",
      "example": 78.486671,
      "maximum": 180,
      "minimum": -180,
      "description": "Observer longitude in decimal degrees. Affects local sidereal time for Lagna and house calculations."
    },
    "transitDate": {
      "type": "string",
      "format": "date",
      "example": "2026-02-03",
      "description": "Transit date to analyze in YYYY-MM-DD format. Planetary positions on this date are overlaid on the natal chart."
    },
    "transitTime": {
      "type": "string",
      "format": "time",
      "example": "12:00:00",
      "description": "Transit time in HH:MM:SS format (24-hour). Affects fast-moving planets like Moon. Defaults to noon."
    },
    "coordinateSystem": {
      "enum": [
        "sidereal",
        "tropical"
      ],
      "type": "string",
      "default": "sidereal",
      "example": "sidereal",
      "description": "Coordinate system for longitude output. \"sidereal\" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. \"tropical\" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to \"sidereal\"."
    }
  }
}

{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 2026,
      "maximum": 2649,
      "minimum": 1551,
      "description": "Year for monthly transit analysis (1551 to 2649). Defaults to the current year (UTC)."
    },
    "month": {
      "type": "integer",
      "example": 2,
      "maximum": 12,
      "minimum": 1,
      "description": "Month number (1-12) for transit analysis. Defaults to the current month (UTC)."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 0,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved once, at the start of the window, and that offset applies to every time in the response. Output times are converted to this timezone. Defaults to 0 (UTC)."
    },
    "coordinateSystem": {
      "enum": [
        "sidereal",
        "tropical"
      ],
      "type": "string",
      "default": "sidereal",
      "example": "sidereal",
      "description": "Coordinate system for longitude output. \"sidereal\" (Nirayana) uses Lahiri ayanamsa, the standard for Vedic astrology. \"tropical\" (Sayana) uses raw ecliptic longitude matching Western astrology. Defaults to \"sidereal\"."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "date": "1990-07-04",
      "time": "10:12:00",
      "latitude": 28.6139,
      "longitude": 77.209
    }
  ],
  "required": [
    "date",
    "time",
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "1990-07-04",
      "description": "Birth date in YYYY-MM-DD format. Date determines planetary positions and nakshatra calculations for Vedic kundli (janam patri). Accurate birth date is essential for dashas, yoga calculations, and divisional charts (vargas)."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "time": {
      "type": "string",
      "format": "time",
      "example": "10:12:00",
      "description": "Birth time in 24-hour HH:MM:SS format. Time is CRITICAL for Lagna (Ascendant) calculation and house divisions. It changes every two hours roughly. Even minutes matter for accurate nakshatra pada and divisional chart (D9, D10) calculations. Without exact time, Lagna and house-based predictions will be incorrect."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "ayanamsa": {
      "enum": [
        "kp-newcomb",
        "kp-old",
        "lahiri",
        "raman",
        "custom"
      ],
      "type": "string",
      "default": "lahiri",
      "example": "lahiri",
      "description": "Sidereal frame (ayanamsa) the chart is cast in. \"lahiri\" is Lahiri/Chitrapaksha, the traditional Vedic standard used by most software, and is the default. \"raman\" is the B.V. Raman ayanamsa from Hindu Predictive Astrology, about 1.45 degrees below Lahiri. \"kp-newcomb\" and \"kp-old\" are the two Krishnamurti Paddhati frames. \"custom\" takes your own value in degrees via ayanamsaValue, for reconciling exactly against a specific reference program. The frame rotates the whole zodiac, so a graha sitting within 1.45 degrees of a boundary can change rashi or nakshatra when you switch: pick the one your reference software uses and keep it."
    },
    "latitude": {
      "type": "number",
      "example": 28.6139,
      "maximum": 90,
      "minimum": -90,
      "description": "Birth location latitude in decimal degrees. Location determines local sidereal time for Lagna calculation and affects bhava (house) cusps. Example: Delhi 28.6139, Mumbai 19.0760, Kathmandu 27.7172."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "default": 5.5,
      "example": 5.5,
      "description": "Timezone: an IANA name (e.g. \"America/New_York\", \"Europe/London\", or `cities[0].timezone` from /location/search) or decimal hours from UTC (e.g. -5 for EST, 5.5 for IST). An IANA name is resolved to the offset in force at the given date and time. Defaults to 5.5."
    },
    "longitude": {
      "type": "number",
      "example": 77.209,
      "maximum": 180,
      "minimum": -180,
      "description": "Birth location longitude in decimal degrees. Affects local time calculations and ayanamsha adjustments. Example: Delhi 77.2090, Mumbai 72.8777, Kathmandu 85.3240."
    },
    "ayanamsaValue": {
      "type": "number",
      "example": 24,
      "description": "Custom ayanamsa value in degrees. When provided, overrides the computed ayanamsa from the selected type. Use for testing with specific ayanamsa values or matching a particular reference source."
    }
  }
}