---
title: "Get Complete KP Chart (v2)"
method: POST
path: "/api/v2/vedic/kp"
tags: ["Vedic v2"]
---

# Get Complete KP Chart (v2)

`POST /api/v2/vedic/kp`

## Request

- Base URL: `https://api.freeastroapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.freeastroapi.com/api/v2/vedic/kp`
- Auth: none declared

Return a complete Krishnamurti Paddhati calculation contract.

The endpoint reuses the standard Vedic birth fields and coordinate resolver,
including ``tz_str=AUTO``. KP invariants are explicit: Krishnamurti
ayanamsha and sidereal Placidus house cusps.

## Request body

- KPChartRequest
  - `year` integer, required: Astronomical year of birth (0-2399; 0 = 1 BCE)
  - `month` integer, required: Month of birth (1-12)
  - `day` integer, required: Day of birth (1-31)
  - `hour` integer, required: Hour of birth (0-23)
  - `minute` integer, required: Minute of birth (0-59)
  - `second` integer: Second of birth (0-59)
  - `city` string: City name (optional)
  - `lat` number, nullable: Latitude
  - `lng` number, nullable: Longitude
  - `tz_str` string: Timezone: AUTO, LMT, or standard (e.g. Europe/Berlin)
  - `ayanamsha` 'kp': KP endpoint invariant. Uses Swiss Ephemeris Krishnamurti ayanamsha.
  - `house_system` 'placidus': KP endpoint invariant. Uses sidereal Placidus house cusps.
  - `node_type` string: Node type (mean/true)
  - `reference_date` string, date, nullable: Reference date for transit-sensitive chart context, including Sade Sati. Defaults to today in timezone_used.
  - `dasha_levels` integer: KP-compatible Vimshottari depth: 1=Maha, 2=+Antar, 3=+Pratyantar.
  - `ruling_datetime` string, date-time, nullable: Optional ISO 8601 moment for ruling planets. A timezone-aware value is converted to the resolved birth-place timezone; a naive value is interpreted there. Defaults to the current moment.

## Response `200`

Successful Response

- KPChartResponse
  - `system` KPSystem, required
    - `id` string, required
    - `name` string, required
    - `ruleset_version` string, required
  - `birth` KPBirthContext, required
    - `local_datetime` string, required
    - `timezone_used` string, required
    - `lat` number, required
    - `lng` number, required
  - `ayanamsha` KPAyanamsha, required
    - `id` string, required
    - `name` string, required
    - `value_degrees` number, required
  - `angles` KPAngles, required
    - `ascendant` number, required
    - `midheaven` number, required
    - `armc` number, required
    - `vertex` number, required
  - `ascendant` KPAscendant, required
    - `absolute_degree` number, required
    - `sign` string, required
    - `sign_id` integer, required
    - `degree_in_sign` number, required
    - `sign_lord` string, required
    - `nakshatra` KPNakshatra, required
      - `id` integer, required
      - `name` string, required
      - `pada` integer, required
      - `lord` string, required
      - `start_degree` number, required
      - `end_degree` number, required
      - `progress` number, required
    - `star_lord` string, required
    - `sub_lord` string, required
    - `sub_sub_lord` string, required
    - `subdivision` KPSubdivision, required
      - `sub` KPSubdivisionSegment, required
        - `lord` string, required
        - `sequence_index` integer, required
        - `start_degree` number, required
        - `end_degree` number, required
        - `span_degrees` number, required
        - `progress` number, required
        - `offset_degrees` number, required
      - `sub_sub` KPSubdivisionSegment, required
        - `lord` string, required
        - `sequence_index` integer, required
        - `start_degree` number, required
        - `end_degree` number, required
        - `span_degrees` number, required
        - `progress` number, required
        - `offset_degrees` number, required
      - `boundary_policy` string, required
    - `house` integer, required
  - `planets` KPPlanet[], required
    - `absolute_degree` number, required
    - `sign` string, required
    - `sign_id` integer, required
    - `degree_in_sign` number, required
    - `sign_lord` string, required
    - `nakshatra` KPNakshatra, required
      - `id` integer, required
      - `name` string, required
      - `pada` integer, required
      - `lord` string, required
      - `start_degree` number, required
      - `end_degree` number, required
      - `progress` number, required
    - `star_lord` string, required
    - `sub_lord` string, required
    - `sub_sub_lord` string, required
    - `subdivision` KPSubdivision, required
      - `sub` KPSubdivisionSegment, required
        - `lord` string, required
        - `sequence_index` integer, required
        - `start_degree` number, required
        - `end_degree` number, required
        - `span_degrees` number, required
        - `progress` number, required
        - `offset_degrees` number, required
      - `sub_sub` KPSubdivisionSegment, required
        - `lord` string, required
        - `sequence_index` integer, required
        - `start_degree` number, required
        - `end_degree` number, required
        - `span_degrees` number, required
        - `progress` number, required
        - `offset_degrees` number, required
      - `boundary_policy` string, required
    - `name` string, required
    - `house` integer, required
    - `is_retrograde` boolean, required
    - `speed_longitude` number, required
  - `cusps` KPCusp[], required
    - `absolute_degree` number, required
    - `sign` string, required
    - `sign_id` integer, required
    - `degree_in_sign` number, required
    - `sign_lord` string, required
    - `nakshatra` KPNakshatra, required
      - `id` integer, required
      - `name` string, required
      - `pada` integer, required
      - `lord` string, required
      - `start_degree` number, required
      - `end_degree` number, required
      - `progress` number, required
    - `star_lord` string, required
    - `sub_lord` string, required
    - `sub_sub_lord` string, required
    - `subdivision` KPSubdivision, required
      - `sub` KPSubdivisionSegment, required
        - `lord` string, required
        - `sequence_index` integer, required
        - `start_degree` number, required
        - `end_degree` number, required
        - `span_degrees` number, required
        - `progress` number, required
        - `offset_degrees` number, required
      - `sub_sub` KPSubdivisionSegment, required
        - `lord` string, required
        - `sequence_index` integer, required
        - `start_degree` number, required
        - `end_degree` number, required
        - `span_degrees` number, required
        - `progress` number, required
        - `offset_degrees` number, required
      - `boundary_policy` string, required
    - `house` integer, required
    - `cusp_degree` number, required
    - `next_cusp_degree` number, required
    - `span_degrees` number, required
    - `occupants` string[], required
  - `cuspal_sub_lord_table` KPCuspalSubLordRow[], required
    - `house` integer, required
    - `cusp_degree` number, required
    - `sign` string, required
    - `sign_lord` string, required
    - `star_lord` string, required
    - `sub_lord` string, required
    - `sub_sub_lord` string, required
  - `planet_significators` KPPlanetSignificator[], required
    - `planet` string, required
    - `star_lord` string, required
    - `sub_lord` string, required
    - `levels` KPSignificatorLevels, required
      - `level_1_star_lord_occupancy` integer[], required
      - `level_2_planet_occupancy` integer[], required
      - `level_3_star_lord_ownership` integer[], required
      - `level_4_planet_ownership` integer[], required
    - `significator_houses` integer[], required
    - `node_proxy` KPNodeProxy
      - `sign_lord` string, required
      - `sign_lord_occupied_house` integer, nullable
      - `sign_lord_owned_houses` integer[], required
      - `policy` string, required
  - `house_significators` KPHouseSignificator[], required
    - `house` integer, required
    - `levels` KPHouseSignificatorLevels, required
      - `level_1_star_lord_occupancy` string[], required
      - `level_2_planet_occupancy` string[], required
      - `level_3_star_lord_ownership` string[], required
      - `level_4_planet_ownership` string[], required
    - `significators` string[], required
  - `ruling_planets` KPRulingPlanets, required
    - `moment` string, required
    - `moment_basis` string, required
    - `timezone_used` string, required
    - `day_lord` string, required
    - `ascendant` KPRulingPoint, required
      - `absolute_degree` number, required
      - `sign_lord` string, required
      - `star_lord` string, required
      - `sub_lord` string, required
      - `sub_sub_lord` string, required
    - `moon` KPRulingPoint, required
      - `absolute_degree` number, required
      - `sign_lord` string, required
      - `star_lord` string, required
      - `sub_lord` string, required
      - `sub_sub_lord` string, required
    - `components` KPRulingComponent[], required
      - `role` string, required
      - `planet` string, required
    - `ordered_unique` string[], required
    - `ranked_by_repetition` KPRulingRank[], required
      - `planet` string, required
      - `occurrences` integer, required
      - `roles` string[], required
    - `selection_order` string[], required
    - `day_lord_policy` string, required
  - `dasha` KPDashaResponse, required
    - `moon_nakshatra` KPDashaMoonNakshatra, required
      - `id` integer, required
      - `name` string, required
      - `pada` integer, required
      - `lord` string, required
    - `birth_balance` KPDashaBirthBalance, required
      - `lord` string, required
      - `actual_start` string, required
      - `birth_date` string, required
      - `end` string, required
      - `full_duration_years` number, required
      - `elapsed_years` number, required
      - `remaining_years` number, required
      - `elapsed_fraction` number, required
      - `remaining_fraction` number, required
    - `active_periods` KPDashaActivePeriod[], required
      - `level` string, required
      - `lord` string, required
      - `start` string, required
      - `end` string, required
      - `duration_years` number, required
      - `elapsed_years` number, required
      - `remaining_years` number, required
      - `progress_fraction` number, required
      - `elapsed_days` integer, required
      - `remaining_days` integer, required
      - `path` string[], required
    - `timeline` KPDashaTimelinePeriod[], required
      - `level` string, required
      - `lord` string, required
      - `start` string, required
      - `end` string, required
      - `duration_years` number, required
      - `sub_periods` KPDashaTimelinePeriod[], nullable
    - `metadata` KPDashaMetadata, required
      - `endpoint_version` string, required
      - `ruleset_version` string, required
      - `system` string, required
      - `levels_requested` integer, required
      - `reference_date` string, required
      - `ayanamsha` string, required
      - `house_system` string, required
      - `node_type` string, required
      - `timezone_used` string, required
      - `moon_degree_policy` string, required
    - `kp_context` KPDashaContext, required
      - `active_periods` KPDashaActiveContext[], required
        - `level` string, required
        - `lord` string, required
        - `start` string, required
        - `end` string, required
        - `duration_years` number, required
        - `elapsed_years` number, required
        - `remaining_years` number, required
        - `progress_fraction` number, required
        - `elapsed_days` integer, required
        - `remaining_days` integer, required
        - `path` string[], required
        - `significator_houses` integer[], required
        - `significator_levels` KPSignificatorLevels, required
          - `level_1_star_lord_occupancy` integer[], required
          - `level_2_planet_occupancy` integer[], required
          - `level_3_star_lord_ownership` integer[], required
          - `level_4_planet_ownership` integer[], required
      - `lord_significators` object, required
      - `calculation_basis` string, required
  - `metadata` KPMetadata, required
    - `endpoint_version` string, required
    - `ruleset_version` string, required
    - `calculation_engine` string, required
    - `planet_position_policy` string, required
    - `ayanamsha` string, required
    - `house_system` string, required
    - `house_code` string, required
    - `node_type` string, required
    - `timezone_used` string, required
    - `julian_day_ut` number, required
    - `subdivision_basis` string, required
    - `subdivision_boundary_policy` string, required
    - `significator_policy` string, required
    - `node_policy` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/freeastroapi/apis/astroservice-api.md) · [All operations](https://skmtc.dev/freeastroapi/apis/astroservice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freeastroapi/apis/astroservice-api/revisions/0c9b4a759522?raw)