Houses¶
5 endpoint(s).
| Endpoint | Method | Summary | Auth |
|---|---|---|---|
/api/v1/houses/all |
POST |
All 12 Houses | |
/api/v1/houses/aspects |
POST |
House Aspects | |
/api/v1/houses/lords |
POST |
All House Lords | |
/api/v1/houses/occupants |
POST |
House Occupants | |
/api/v1/houses/{house_number} |
POST |
Specific House Analysis |
POST /api/v1/houses/all¶
All 12 Houses
Get complete analysis of all 12 houses.
Returns for each house: - Sign on house cusp - House lord and its placement - Planets in the house - Aspects on the house - House significations and nature
House System:
- d1 / whole_sign: Whole sign houses - Classical Vedic method
- Planet house positions are FIXED
- Effect intensity varies via Bhava Madhya/Sandhi system
Note: - Bhav Chalit (planet shifting) is NOT classical Vedic astrology - Use /bhava-intensity endpoint for effect strength analysis
| Param | In | Type | Required | Description |
|---|---|---|---|---|
house_system |
query | string | no | House system: d1 (Whole Sign) - Classical Vedic |
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/houses/all' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/houses/aspects¶
House Aspects
Get all planetary aspects on each house.
Includes: - Standard 7th aspect from all planets - Special aspects (Mars: 4,8; Jupiter: 5,9; Saturn: 3,10) - Rahu/Ketu aspects (5th and 9th)
Note: Uses Whole Sign (D1) house system - Classical Vedic.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
house_system |
query | string | no | House system: d1 (Whole Sign) |
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/houses/aspects' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/houses/lords¶
All House Lords
Get all house lords and their placements.
Returns: - Each house lord - Where the lord is placed - Functional benefic/malefic nature for the ascendant
| Param | In | Type | Required | Description |
|---|---|---|---|---|
house_system |
query | string | no | House system |
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/houses/lords' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/houses/occupants¶
House Occupants
Get planets occupying each house.
Note: Uses Whole Sign (D1) house system - Classical Vedic approach. Planet house positions are FIXED. Effect intensity varies via Bhava Madhya/Sandhi.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
house_system |
query | string | no | House system: d1 (Whole Sign) |
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/houses/occupants' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/houses/{house_number}¶
Specific House Analysis
Get detailed analysis of a specific house (1-12).
Returns comprehensive information including: - House lord and its strength - Planets in house and their effects - All aspects on the house - Relevant yogas formed - Predictions based on house analysis
Note: Uses Whole Sign (D1) house system - Classical Vedic.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
house_number |
path | integer | yes | |
house_system |
query | string | no | House system: d1 (Whole Sign) |
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/houses/${house_number}' \
-H 'Authorization: Bearer <API_KEY>'