Bhava Houses

Endpoint POST https://starsapi.com/api/v3/vedic/houses/bhava

Returns house boundary data for the Bhava (Equal House) system — sign, lord, begin/madhya/end cusps, and planet occupants for each of the 12 houses, plus the four chart angles (ASC, MC, DSC, IC). In the Equal House system, the ascendant degree sits at the mid-point of the 1st house, and each house spans exactly 30°.

For chart images of this house system, use /charts/bhava. For other house systems, see /houses/chalit (Placidus) and /houses/sripati (Sripati).

Authentication

Method	Example
Header (recommended)	`X-Api-Key: am_live_xxxxxxxxxxxx`
Bearer	`Authorization: Bearer am_live_xxxxxxxxxxxx`
Query	`?api_key=am_live_xxxxxxxxxxxx`

Request body

Field	Type	Required	Description
`year`	integer	Yes	Birth year, 4-digit.
`month`	integer	Yes	Birth month, `1`–`12`.
`day`	integer	Yes	Day of month.
`hour`	integer	Yes	Hour, 24-hour format.
`minute`	integer	Yes	Minute.
`second`	integer	No	Default `0`.
`latitude`	number	Yes	Decimal degrees, −90…90.
`longitude`	number	Yes	Decimal degrees, −180…180.
`timezone`	string	Yes	IANA timezone identifier.
`ayanamsa`	string	No	Default `lahiri`. Full list →
`node_type`	string	No	`mean` (default) or `true`.

Response shape

houses.{1–12}

Field	Type	Description
`sign`	string	Sign on the house cusp.
`sign_lord`	string	Ruling planet of that sign.
`begin`	string	House start boundary in `Sign D°M′S″` format.
`madhya`	string	House mid-point (bhava madhya).
`end`	string	House end boundary.
`planets`	array	2-letter planet codes occupying this house (e.g. `["Su", "Me"]`). Empty array if none.

angles

Four chart angles with absolute longitude, sign, and degree within sign.

Key	Full name	Description
`asc`	Ascendant	Rising degree — cusp of 1st house.
`mc`	Midheaven (MC)	Medium Coeli — cusp of 10th house.
`dsc`	Descendant	Setting degree — cusp of 7th house.
`ic`	Imum Coeli (IC)	Nadir — cusp of 4th house.

Each angle contains:

Field	Type	Description
`longitude`	number	Absolute sidereal longitude (0–360).
`sign`	string	Sign name.
`degree_dms`	string	Degree within the sign.

Use cases

House table — render a 12-row house grid showing sign, lord, cusps, and occupants.
Custom chart rendering — use begin/end boundaries to draw house divisions programmatically.
Angles display — show ASC/MC/DSC/IC in a chart header or summary card.
Planet-in-house lookup — find which house a planet occupies under Equal House rules.

Errors

HTTP	Code	Cause
400	`MISSING_FIELD`	Required field absent.
400	`INVALID_DATE`	Bad calendar date.
400	`INVALID_TIME`	Hour/minute/second out of range.
400	`INVALID_TIMEZONE`	Non-IANA timezone.
400	`INVALID_COORDINATE`	Lat/lon out of range.
405	`METHOD_NOT_ALLOWED`	Non-POST request.

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/vedic/houses/bhava" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/vedic/houses/bhava',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year: 1990,
      month: 5,
      day: 20,
      hour: 14,
      minute: 30,
      second: 0,
      latitude: 28.6139,
      longitude: 77.209,
      timezone: 'Asia/Kolkata'
    })
  }
);
const result = await response.json();

if (result.success) {
  console.log(result.data);
}

import requests
import os

response = requests.post(
    'https://starsapi.com/api/v3/vedic/houses/bhava',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'year': 1990,
        'month': 5,
        'day': 20,
        'hour': 14,
        'minute': 30,
        'second': 0,
        'latitude': 28.6139,
        'longitude': 77.209,
        'timezone': 'Asia/Kolkata'
    }
)
result = response.json()

if result['success']:
    print(result['data'])

<?php
$payload = [
    'year' => 1990,
    'month' => 5,
    'day' => 20,
    'hour' => 14,
    'minute' => 30,
    'second' => 0,
    'latitude' => 28.6139,
    'longitude' => 77.209,
    'timezone' => 'Asia/Kolkata',
];

$ch = curl_init('https://starsapi.com/api/v3/vedic/houses/bhava');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Api-Key: ' . getenv('STARSAPI_KEY'),
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['success']) {
    print_r($data['data']);
}

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<Map<String, dynamic>> getAscendant() async {
  final response = await http.post(
    Uri.parse('https://starsapi.com/api/v3/vedic/houses/bhava'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'year': 1990,
      'month': 5,
      'day': 20,
      'hour': 14,
      'minute': 30,
      'second': 0,
      'latitude': 28.6139,
      'longitude': 77.209,
      'timezone': 'Asia/Kolkata',
    }),
  );
  return jsonDecode(response.body);
}

import Foundation

func getAscendant() async throws -> [String: Any] {
    var request = URLRequest(url: URL(string:
        "https://starsapi.com/api/v3/vedic/houses/bhava"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "year": 1990,
            "month": 5,
            "day": 20,
            "hour": 14,
            "minute": 30,
            "second": 0,
            "latitude": 28.6139,
            "longitude": 77.209,
            "timezone": "Asia/Kolkata"
        }
        """.data(using: .utf8)

    let (data, _) = try await URLSession.shared.data(for: request)
    return try JSONSerialization.jsonObject(with: data) as! [String: Any]
}

import okhttp3.*
import org.json.JSONObject

val client = OkHttpClient()
val JSON = "application/json; charset=utf-8".toMediaType()

fun getAscendant(callback: (JSONObject) -> Unit) {
    val payload = """
    {
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/vedic/houses/bhava")
        .addHeader("X-Api-Key", "YOUR_API_KEY")
        .post(payload.toRequestBody(JSON))
        .build()

    client.newCall(request).enqueue(object : Callback {
        override fun onResponse(call: Call, response: Response) {
            callback(JSONObject(response.body!!.string()))
        }
        override fun onFailure(call: Call, e: java.io.IOException) {
            e.printStackTrace()
        }
    })
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    payload, _ := json.Marshal(map[string]interface{}{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/vedic/houses/bhava",
        bytes.NewBuffer(payload))
    req.Header.Set("X-Api-Key", os.Getenv("STARSAPI_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result["data"])
}

require 'net/http'
require 'json'

uri = URI('https://starsapi.com/api/v3/vedic/houses/bhava')
payload = {
  'year' => 1990,
  'month' => 5,
  'day' => 20,
  'hour' => 14,
  'minute' => 30,
  'second' => 0,
  'latitude' => 28.6139,
  'longitude' => 77.209,
  'timezone' => 'Asia/Kolkata'
}

req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = ENV['STARSAPI_KEY']
req['Content-Type'] = 'application/json'
req.body = payload.to_json

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
res = http.request(req)

data = JSON.parse(res.body)
puts data['data'] if data['success']

200 RESPONSE

{
  "status": 200,
  "success": true,
  "data": {
    "house_system": "Equal House (Bhava Madhya)",
    "ascendant": {
      "sign": "Virgo",
      "sign_lord": "Mercury",
      "degree_dms": "6°14'52\""
    },
    "houses": {
      "1": { "sign": "Virgo", "sign_lord": "Mercury", "begin": "Leo 21°14'52\"", "madhya": "Vir 6°14'52\"", "end": "Vir 21°14'52\"", "planets": [] },
      "2": { "sign": "Libra", "sign_lord": "Venus", "begin": "Vir 21°14'52\"", "madhya": "Lib 6°14'52\"", "end": "Lib 21°14'52\"", "planets": [] },
      "3": { "sign": "Scorpio", "sign_lord": "Mars", "begin": "Lib 21°14'52\"", "madhya": "Sco 6°14'52\"", "end": "Sco 21°14'52\"", "planets": ["Pl"] },
      "4": { "sign": "Sagittarius", "sign_lord": "Jupiter", "begin": "Sco 21°14'52\"", "madhya": "Sag 6°14'52\"", "end": "Sag 21°14'52\"", "planets": ["Ur", "Ne"] },
      "5": { "sign": "Capricorn", "sign_lord": "Saturn", "begin": "Sag 21°14'52\"", "madhya": "Cap 6°14'52\"", "end": "Cap 21°14'52\"", "planets": ["Sa", "Ra"] },
      "6": { "sign": "Aquarius", "sign_lord": "Saturn", "begin": "Cap 21°14'52\"", "madhya": "Aqu 6°14'52\"", "end": "Aqu 21°14'52\"", "planets": [] },
      "7": { "sign": "Pisces", "sign_lord": "Jupiter", "begin": "Aqu 21°14'52\"", "madhya": "Pis 6°14'52\"", "end": "Pis 21°14'52\"", "planets": ["Mo", "Ma"] },
      "8": { "sign": "Aries", "sign_lord": "Mars", "begin": "Pis 21°14'52\"", "madhya": "Ari 6°14'52\"", "end": "Ari 21°14'52\"", "planets": ["Me", "Ve"] },
      "9": { "sign": "Taurus", "sign_lord": "Venus", "begin": "Ari 21°14'52\"", "madhya": "Tau 6°14'52\"", "end": "Tau 21°14'52\"", "planets": ["Su"] },
      "10": { "sign": "Gemini", "sign_lord": "Mercury", "begin": "Tau 21°14'52\"", "madhya": "Gem 6°14'52\"", "end": "Gem 21°14'52\"", "planets": ["Ju", "Ch"] },
      "11": { "sign": "Cancer", "sign_lord": "Moon", "begin": "Gem 21°14'52\"", "madhya": "Can 6°14'52\"", "end": "Can 21°14'52\"", "planets": ["Ke"] },
      "12": { "sign": "Leo", "sign_lord": "Sun", "begin": "Can 21°14'52\"", "madhya": "Leo 6°14'52\"", "end": "Leo 21°14'52\"", "planets": [] }
    },
    "angles": {
      "asc": { "longitude": 156.2478, "sign": "Virgo", "degree_dms": "6°14'52\"" },
      "mc":  { "longitude": 66.2478, "sign": "Gemini", "degree_dms": "6°14'52\"" },
      "dsc": { "longitude": 336.2478, "sign": "Pisces", "degree_dms": "6°14'52\"" },
      "ic":  { "longitude": 246.2478, "sign": "Sagittarius", "degree_dms": "6°14'52\"" }
    }
  },
  "meta": {
    "endpoint": "/api/v3/vedic/houses/bhava",
    "version": "3.0",
    "response_time_ms": 4,
    "timestamp": "2026-06-09T06:57:04+05:30",
    "credits_remaining": 198590,
    "request_id": "c45a40938ef5d7df",
    "ayanamsa": {
      "name": "Lahiri",
      "value": 23.725957,
      "value_dms": "23°43'33\""
    },
    "node_type": "mean"
  }
}