API reference / Bhrigu Nandi Nadi (BNN)

Bhrigu Nandi Nadi (BNN)

BNN progression charts, nadi relations, graha phala, ratna, yogas and dashas.

8 endpoints. Every endpoint is POST with a JSON body and your key in the Authorization header. Request schemas and examples come from the OpenAPI document; each example response was captured from the live engine and its data fields are a guide to the shape, not a contract.

BNN Charts (in bundle)

POSTAvailable

https://api.96astro.com/v1/bnn/bnn-bundle-charts

The nine-graha D1 and Bhav Chalit house lists used for BNN reading: each house's sign and planets.

Credits: 3 credits
Input: Birth details
Output: JSON
Delivery: Direct response
Languages: English; translated term names with labels

Headers
Header	Value and description
`Authorization`Required	`Bearer YOUR_API_KEY` Your sandbox (sk_test_...) or live (sk_live_...) key. X-API-Key: <key> is accepted instead.
`Content-Type`Required	`application/json` The body is JSON.
`Idempotency-Key`Optional	`<unique string>` Makes retries safe: a repeated key with the same body replays the stored response and is never charged twice. (1 to 200 characters)

Body · application/json
Field	Description
`datetime`stringRequired	Local date and time, ISO 8601 without offset, e.g. 1990-10-18T14:30:00 Limits: format local-date-time, pattern ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?$ Example: `1990-10-18T14:30:00`
`timezone`string \| nullOptional	IANA time zone, e.g. Asia/Kolkata Default: `null` Example: `Asia/Kolkata`
`utc_offset`string \| nullOptional	Fixed offset such as +05:30, if no IANA zone is known Default: `null`
`latitude`numberRequired	Limits: minimum -90, maximum 90 Example: `28.6139`
`longitude`numberRequired	Limits: minimum -180, maximum 180 Example: `77.209`
`ayanamsha`stringOptional	Default: `lahiri`
`language`stringOptional	Output language (ISO 639-1). The values listed are the ones this capability supports; any other is refused with 422 unsupported_language. Identifiers, enum values and numbers never change with language. Default: `en` Allowed value: en
`node`stringOptional	Lunar node: true (osculating) or mean. Default: `true` Allowed values: truemean
`labels`stringOptional	Optional. Adds `meta.labels`: translated display names for the identifiers in the answer. `data` is unchanged. Free. Any other code is refused with 422 unsupported_language. Allowed values: asbndeesfrguhiitknkomlmrnenlorpaplptrusitatetrur

Response · fields in data

Inferred from the example response: a guide to the shape, not a contract.

ayanamsha · object
d1 · array of object
chalit · array of object

Try in Playground →Capability overview

Example request

curl -X POST https://api.96astro.com/v1/bnn/bnn-bundle-charts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}'

const response = await fetch("https://api.96astro.com/v1/bnn/bnn-bundle-charts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209
  }),
});

const { data, meta } = await response.json();
console.log(data);

import { Astro96Client } from "@96astro/api";

const astro = new Astro96Client({ apiKey: "YOUR_API_KEY" });

const { data, meta } = await astro.bnn.bnnBundleCharts({
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
});
console.log(data);

import requests

response = requests.post(
    "https://api.96astro.com/v1/bnn/bnn-bundle-charts",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209,
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()["data"]
print(data)

from astro96_api import Astro96Client

astro = Astro96Client(api_key="YOUR_API_KEY")

res = astro.bnn.bnn_bundle_charts({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209,
})
print(res.data)

<?php
$ch = curl_init('https://api.96astro.com/v1/bnn/bnn-bundle-charts');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'datetime' => '1990-10-18T14:30:00',
        'timezone' => 'Asia/Kolkata',
        'latitude' => 28.6139,
        'longitude' => 77.209,
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}`)
	req, err := http.NewRequest("POST", "https://api.96astro.com/v1/bnn/bnn-bundle-charts", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Example response

200application/json

{
  "data": {
    "ayanamsha": {
      "id": "lahiri",
      "name": "N.C. Lahiri",
      "degrees": 23.7285
    },
    "d1": [
      {
        "house": 1,
        "sign": "Capricorn",
        "planets": [
          "Rahu"
        ]
      },
      {
        "house": 2,
        "sign": "Aquarius",
        "planets": []
      },
  …

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items.

Error responses

400invalid_request
401invalid_key, expired_key
402payment_required
403account_suspended
404not_found
409idempotency_conflict
413payload_too_large
422invalid_request, unsupported_language
429rate_limited, quota_exhausted, spend_cap_reached, project_budget_exceeded
500computation_failed
502unavailable
503unavailable
504deadline_exceeded

Errors are never charged. What each status means and what to do: errors.

BNN Progression

POSTAvailable

https://api.96astro.com/v1/bnn/bnn-progression

Bhrigu Nandi Nadi natal positions, the karaka role and doctrine applied to each planet, and the progressed positions for every age.

Credits: 3 credits
Input: Birth details
Output: JSON
Delivery: Direct response
Languages: English; translated term names with labels

Headers
Header	Value and description
`Authorization`Required	`Bearer YOUR_API_KEY` Your sandbox (sk_test_...) or live (sk_live_...) key. X-API-Key: <key> is accepted instead.
`Content-Type`Required	`application/json` The body is JSON.
`Idempotency-Key`Optional	`<unique string>` Makes retries safe: a repeated key with the same body replays the stored response and is never charged twice. (1 to 200 characters)

Body · application/json
Field	Description
`datetime`stringRequired	Local date and time, ISO 8601 without offset, e.g. 1990-10-18T14:30:00 Limits: format local-date-time, pattern ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?$ Example: `1990-10-18T14:30:00`
`timezone`string \| nullOptional	IANA time zone, e.g. Asia/Kolkata Default: `null` Example: `Asia/Kolkata`
`utc_offset`string \| nullOptional	Fixed offset such as +05:30, if no IANA zone is known Default: `null`
`latitude`numberRequired	Limits: minimum -90, maximum 90 Example: `28.6139`
`longitude`numberRequired	Limits: minimum -180, maximum 180 Example: `77.209`
`ayanamsha`stringOptional	Default: `lahiri`
`language`stringOptional	Output language (ISO 639-1). The values listed are the ones this capability supports; any other is refused with 422 unsupported_language. Identifiers, enum values and numbers never change with language. Default: `en` Allowed value: en
`node`stringOptional	Lunar node: true (osculating) or mean. Default: `true` Allowed values: truemean
`progression_years`integerOptional	Years of the progression table. Default: `80` Limits: minimum 1, maximum 120
`doctrine`integer \| nullOptional	Force one progression doctrine (1-4) for every karaka. Default: `null` Allowed values: 1234
`doctrine_by_planet`map of integer \| nullOptional	Force a doctrine (1-4) per planet. Default: `null`
`labels`stringOptional	Optional. Adds `meta.labels`: translated display names for the identifiers in the answer. `data` is unchanged. Free. Any other code is refused with 422 unsupported_language. Allowed values: asbndeesfrguhiitknkomlmrnenlorpaplptrusitatetrur

Options (4)
Value	Meaning
`1`	Doctrine 1
`2`	Doctrine 2
`3`	Doctrine 3
`4`	Doctrine 4

Response · fields in data

Inferred from the example response: a guide to the shape, not a contract.

ayanamsha · string
natal · array of object
karakas · array of object
progression · array of object

Try in Playground →Capability overview

Example request

curl -X POST https://api.96astro.com/v1/bnn/bnn-progression \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}'

const response = await fetch("https://api.96astro.com/v1/bnn/bnn-progression", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209
  }),
});

const { data, meta } = await response.json();
console.log(data);

import { Astro96Client } from "@96astro/api";

const astro = new Astro96Client({ apiKey: "YOUR_API_KEY" });

const { data, meta } = await astro.bnn.bnnProgression({
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
});
console.log(data);

import requests

response = requests.post(
    "https://api.96astro.com/v1/bnn/bnn-progression",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209,
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()["data"]
print(data)

from astro96_api import Astro96Client

astro = Astro96Client(api_key="YOUR_API_KEY")

res = astro.bnn.bnn_progression({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209,
})
print(res.data)

<?php
$ch = curl_init('https://api.96astro.com/v1/bnn/bnn-progression');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'datetime' => '1990-10-18T14:30:00',
        'timezone' => 'Asia/Kolkata',
        'latitude' => 28.6139,
        'longitude' => 77.209,
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}`)
	req, err := http.NewRequest("POST", "https://api.96astro.com/v1/bnn/bnn-progression", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Example response

200application/json

{
  "data": {
    "ayanamsha": "lahiri",
    "natal": [
      {
        "name": "Ascendant",
        "longitude": 293.8936,
        "sign": "Capricorn",
        "degree": 23.8936,
        "nakshatra": "Dhanishta",
        "pada": 1
      },
      {
        "name": "Sun",
        "longitude": 180.995,
        "sign": "Libra",
        "degree": 0.995,
        "nakshatra": "Chitra",
        "pada": 3,
        "retrograde": null
  …

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items.

Error responses

400invalid_request
401invalid_key, expired_key
402payment_required
403account_suspended
404not_found
409idempotency_conflict
413payload_too_large
422invalid_request, unsupported_language
429rate_limited, quota_exhausted, spend_cap_reached, project_budget_exceeded
500computation_failed
502unavailable
503unavailable
504deadline_exceeded

Errors are never charged. What each status means and what to do: errors.

BNN Snapshot for a Date

POSTAvailable

https://api.96astro.com/v1/bnn/bnn-snapshot

The progressed BNN positions for one target date and time, with the age and month offset used.

Credits: 1 credit
Input: Specific input
Output: JSON
Delivery: Direct response
Languages: English; translated term names with labels

Headers
Header	Value and description
`Authorization`Required	`Bearer YOUR_API_KEY` Your sandbox (sk_test_...) or live (sk_live_...) key. X-API-Key: <key> is accepted instead.
`Content-Type`Required	`application/json` The body is JSON.
`Idempotency-Key`Optional	`<unique string>` Makes retries safe: a repeated key with the same body replays the stored response and is never charged twice. (1 to 200 characters)

Body · application/json
Field	Description
`datetime`stringRequired	Local date and time, ISO 8601 without offset, e.g. 1990-10-18T14:30:00 Limits: format local-date-time, pattern ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?$ Example: `1990-10-18T14:30:00`
`timezone`string \| nullOptional	IANA time zone, e.g. Asia/Kolkata Default: `null` Example: `Asia/Kolkata`
`utc_offset`string \| nullOptional	Fixed offset such as +05:30, if no IANA zone is known Default: `null`
`latitude`numberRequired	Limits: minimum -90, maximum 90 Example: `28.6139`
`longitude`numberRequired	Limits: minimum -180, maximum 180 Example: `77.209`
`ayanamsha`stringOptional	Default: `lahiri`
`language`stringOptional	Output language (ISO 639-1). The values listed are the ones this capability supports; any other is refused with 422 unsupported_language. Identifiers, enum values and numbers never change with language. Default: `en` Allowed value: en
`node`stringOptional	Lunar node: true (osculating) or mean. Default: `true` Allowed values: truemean
`target`stringRequired	Local date and time to progress to, in the birth's time zone, ISO 8601 without offset Limits: format local-date-time, pattern ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?$ Example: `2026-10-13T12:00:00`
`labels`stringOptional	Optional. Adds `meta.labels`: translated display names for the identifiers in the answer. `data` is unchanged. Free. Any other code is refused with 422 unsupported_language. Allowed values: asbndeesfrguhiitknkomlmrnenlorpaplptrusitatetrur

Response · fields in data

Inferred from the example response: a guide to the shape, not a contract.

ayanamsha · string
target · string
age · integer
month_offset · integer
progressed · array of object

Try in Playground →Capability overview

Example request

curl -X POST https://api.96astro.com/v1/bnn/bnn-snapshot \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209,
  "target": "2026-10-13T12:00:00"
}'

const response = await fetch("https://api.96astro.com/v1/bnn/bnn-snapshot", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209,
    "target": "2026-10-13T12:00:00"
  }),
});

const { data, meta } = await response.json();
console.log(data);

import { Astro96Client } from "@96astro/api";

const astro = new Astro96Client({ apiKey: "YOUR_API_KEY" });

const { data, meta } = await astro.bnn.bnnSnapshot({
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209,
  "target": "2026-10-13T12:00:00"
});
console.log(data);

import requests

response = requests.post(
    "https://api.96astro.com/v1/bnn/bnn-snapshot",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209,
        "target": "2026-10-13T12:00:00",
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()["data"]
print(data)

from astro96_api import Astro96Client

astro = Astro96Client(api_key="YOUR_API_KEY")

res = astro.bnn.bnn_snapshot({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209,
    "target": "2026-10-13T12:00:00",
})
print(res.data)

<?php
$ch = curl_init('https://api.96astro.com/v1/bnn/bnn-snapshot');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'datetime' => '1990-10-18T14:30:00',
        'timezone' => 'Asia/Kolkata',
        'latitude' => 28.6139,
        'longitude' => 77.209,
        'target' => '2026-10-13T12:00:00',
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209,
  "target": "2026-10-13T12:00:00"
}`)
	req, err := http.NewRequest("POST", "https://api.96astro.com/v1/bnn/bnn-snapshot", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Example response

200application/json

{
  "data": {
    "ayanamsha": "lahiri",
    "target": "2026-10-13T12:00:00",
    "age": 35,
    "month_offset": 11,
    "progressed": [
      {
        "name": "Ascendant",
        "longitude": 263.8833,
        "sign": "Sagittarius",
        "degree": 23.8833,
        "nakshatra": "Purva Ashadha",
        "pada": 4,
        "house": 1
      },
      {
        "name": "Sun",
        "longitude": 150.9833,
        "sign": "Virgo",
  …

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items.

Error responses

400invalid_request
401invalid_key, expired_key
402payment_required
403account_suspended
404not_found
409idempotency_conflict
413payload_too_large
422invalid_request, unsupported_language
429rate_limited, quota_exhausted, spend_cap_reached, project_budget_exceeded
500computation_failed
502unavailable
503unavailable
504deadline_exceeded

Errors are never charged. What each status means and what to do: errors.

BNN Nadi Relations

POSTAvailable

https://api.96astro.com/v1/bnn/bnn-nadi

Nadi points with nadiamshas, planets sharing a nakshatra or sign, sign aspects, exchanges and each planet's movement to the next.

Credits: 1 credit
Input: Birth details
Output: JSON
Delivery: Direct response
Languages: English; translated term names with labels

Headers
Header	Value and description
`Authorization`Required	`Bearer YOUR_API_KEY` Your sandbox (sk_test_...) or live (sk_live_...) key. X-API-Key: <key> is accepted instead.
`Content-Type`Required	`application/json` The body is JSON.
`Idempotency-Key`Optional	`<unique string>` Makes retries safe: a repeated key with the same body replays the stored response and is never charged twice. (1 to 200 characters)

Body · application/json
Field	Description
`datetime`stringRequired	Local date and time, ISO 8601 without offset, e.g. 1990-10-18T14:30:00 Limits: format local-date-time, pattern ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?$ Example: `1990-10-18T14:30:00`
`timezone`string \| nullOptional	IANA time zone, e.g. Asia/Kolkata Default: `null` Example: `Asia/Kolkata`
`utc_offset`string \| nullOptional	Fixed offset such as +05:30, if no IANA zone is known Default: `null`
`latitude`numberRequired	Limits: minimum -90, maximum 90 Example: `28.6139`
`longitude`numberRequired	Limits: minimum -180, maximum 180 Example: `77.209`
`ayanamsha`stringOptional	Default: `lahiri`
`language`stringOptional	Output language (ISO 639-1). The values listed are the ones this capability supports; any other is refused with 422 unsupported_language. Identifiers, enum values and numbers never change with language. Default: `en` Allowed value: en
`node`stringOptional	Lunar node: true (osculating) or mean. Default: `true` Allowed values: truemean
`labels`stringOptional	Optional. Adds `meta.labels`: translated display names for the identifiers in the answer. `data` is unchanged. Free. Any other code is refused with 422 unsupported_language. Allowed values: asbndeesfrguhiitknkomlmrnenlorpaplptrusitatetrur

Response · fields in data

Inferred from the example response: a guide to the shape, not a contract.

ayanamsha · string
note · string
points · array of object
same_nakshatra · array of object
same_sign · array of object
sign_aspects · array of object
exchanges · array
movement · array of object

Try in Playground →Capability overview

Example request

curl -X POST https://api.96astro.com/v1/bnn/bnn-nadi \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}'

const response = await fetch("https://api.96astro.com/v1/bnn/bnn-nadi", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209
  }),
});

const { data, meta } = await response.json();
console.log(data);

import { Astro96Client } from "@96astro/api";

const astro = new Astro96Client({ apiKey: "YOUR_API_KEY" });

const { data, meta } = await astro.bnn.bnnNadi({
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
});
console.log(data);

import requests

response = requests.post(
    "https://api.96astro.com/v1/bnn/bnn-nadi",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209,
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()["data"]
print(data)

from astro96_api import Astro96Client

astro = Astro96Client(api_key="YOUR_API_KEY")

res = astro.bnn.bnn_nadi({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209,
})
print(res.data)

<?php
$ch = curl_init('https://api.96astro.com/v1/bnn/bnn-nadi');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'datetime' => '1990-10-18T14:30:00',
        'timezone' => 'Asia/Kolkata',
        'latitude' => 28.6139,
        'longitude' => 77.209,
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}`)
	req, err := http.NewRequest("POST", "https://api.96astro.com/v1/bnn/bnn-nadi", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Example response

200application/json

{
  "data": {
    "ayanamsha": "lahiri",
    "note": "`nadiamsha` is the 0.2-degree part of the sign (1-150) the point falls in. The nodes are always retrograde (the classical and Nadi rule). `combust` is the chart's own combustion flag.",
    "points": [
      {
        "name": "Ascendant",
        "longitude": 293.8936,
        "sign": "Capricorn",
        "degree": 23.8936,
        "nakshatra": "Dhanishta",
        "pada": 1,
        "sign_lord": "Saturn",
        "nakshatra_lord": "Mars",
        "nadiamsha": 120
      },
      {
        "name": "Sun",
        "longitude": 180.995,
        "sign": "Libra",
  …

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items.

Error responses

400invalid_request
401invalid_key, expired_key
402payment_required
403account_suspended
404not_found
409idempotency_conflict
413payload_too_large
422invalid_request, unsupported_language
429rate_limited, quota_exhausted, spend_cap_reached, project_budget_exceeded
500computation_failed
502unavailable
503unavailable
504deadline_exceeded

Errors are never charged. What each status means and what to do: errors.

BNN Graha Phala

POSTAvailable

https://api.96astro.com/v1/bnn/bnn-graha-phala

Lagna and janma nakshatra readings, each planet's sign, house, dignity and nakshatra with its sign and star lords' placements, and the conjunctions by sign and nakshatra.

Credits: 10 credits
Input: Birth details
Output: JSON
Delivery: Direct response (JSON); PDF via /v1/jobs/pdf
Languages: English; translated term names with labels

Headers
Header	Value and description
`Authorization`Required	`Bearer YOUR_API_KEY` Your sandbox (sk_test_...) or live (sk_live_...) key. X-API-Key: <key> is accepted instead.
`Content-Type`Required	`application/json` The body is JSON.
`Idempotency-Key`Optional	`<unique string>` Makes retries safe: a repeated key with the same body replays the stored response and is never charged twice. (1 to 200 characters)

Body · application/json
Field	Description
`datetime`stringRequired	Local date and time, ISO 8601 without offset, e.g. 1990-10-18T14:30:00 Limits: format local-date-time, pattern ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?$ Example: `1990-10-18T14:30:00`
`timezone`string \| nullOptional	IANA time zone, e.g. Asia/Kolkata Default: `null` Example: `Asia/Kolkata`
`utc_offset`string \| nullOptional	Fixed offset such as +05:30, if no IANA zone is known Default: `null`
`latitude`numberRequired	Limits: minimum -90, maximum 90 Example: `28.6139`
`longitude`numberRequired	Limits: minimum -180, maximum 180 Example: `77.209`
`ayanamsha`stringOptional	Default: `lahiri`
`language`stringOptional	Output language (ISO 639-1). The values listed are the ones this capability supports; any other is refused with 422 unsupported_language. Identifiers, enum values and numbers never change with language. Default: `en` Allowed value: en
`node`stringOptional	Lunar node: true (osculating) or mean. Default: `true` Allowed values: truemean
`labels`stringOptional	Optional. Adds `meta.labels`: translated display names for the identifiers in the answer. `data` is unchanged. Free. Any other code is refused with 422 unsupported_language. Allowed values: asbndeesfrguhiitknkomlmrnenlorpaplptrusitatetrur

Response · fields in data

Inferred from the example response: a guide to the shape, not a contract.

ayanamsha · object
node · string
house_system · string
lagna · object
moon · object
janma_nakshatra · object
planets · array of object
conjunctions · object

Try in Playground →Capability overview

Example request

curl -X POST https://api.96astro.com/v1/bnn/bnn-graha-phala \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}'

const response = await fetch("https://api.96astro.com/v1/bnn/bnn-graha-phala", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209
  }),
});

const { data, meta } = await response.json();
console.log(data);

import { Astro96Client } from "@96astro/api";

const astro = new Astro96Client({ apiKey: "YOUR_API_KEY" });

const { data, meta } = await astro.bnn.bnnGrahaPhala({
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
});
console.log(data);

import requests

response = requests.post(
    "https://api.96astro.com/v1/bnn/bnn-graha-phala",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209,
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()["data"]
print(data)

from astro96_api import Astro96Client

astro = Astro96Client(api_key="YOUR_API_KEY")

res = astro.bnn.bnn_graha_phala({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209,
})
print(res.data)

<?php
$ch = curl_init('https://api.96astro.com/v1/bnn/bnn-graha-phala');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'datetime' => '1990-10-18T14:30:00',
        'timezone' => 'Asia/Kolkata',
        'latitude' => 28.6139,
        'longitude' => 77.209,
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}`)
	req, err := http.NewRequest("POST", "https://api.96astro.com/v1/bnn/bnn-graha-phala", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Example response

200application/json

{
  "data": {
    "ayanamsha": {
      "id": "lahiri"
    },
    "node": "true",
    "house_system": "whole_sign",
    "lagna": {
      "sign": "Capricorn",
      "element": "earth",
      "modality": "cardinal",
      "nakshatra": "Dhanishtha",
      "pada": 1,
      "pada_aim": "dharma",
      "sign_lord": "Saturn",
      "sign_lord_sign": "Sagittarius",
      "sign_lord_house": 12,
      "nakshatra_lord": "Mars",
      "nakshatra_lord_sign": "Taurus",
      "nakshatra_lord_house": 5,
  …

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items.

Error responses

400invalid_request
401invalid_key, expired_key
402payment_required
403account_suspended
404not_found
409idempotency_conflict
413payload_too_large
422invalid_request, unsupported_language
429rate_limited, quota_exhausted, spend_cap_reached, project_budget_exceeded
500computation_failed
502unavailable
503unavailable
504deadline_exceeded

Errors are never charged. What each status means and what to do: errors.

BNN Ratna (Gemstones)

POSTAvailable

https://api.96astro.com/v1/bnn/bnn-ratna

Moolank and Bhagyank and a list of gemstones, each with its planet, basis, metal, finger, substitutes and reason.

Credits: 1 credit
Input: Birth details
Output: JSON
Delivery: Direct response
Languages: English; translated term names with labels

Headers
Header	Value and description
`Authorization`Required	`Bearer YOUR_API_KEY` Your sandbox (sk_test_...) or live (sk_live_...) key. X-API-Key: <key> is accepted instead.
`Content-Type`Required	`application/json` The body is JSON.
`Idempotency-Key`Optional	`<unique string>` Makes retries safe: a repeated key with the same body replays the stored response and is never charged twice. (1 to 200 characters)

Body · application/json
Field	Description
`datetime`stringRequired	Local date and time, ISO 8601 without offset, e.g. 1990-10-18T14:30:00 Limits: format local-date-time, pattern ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?$ Example: `1990-10-18T14:30:00`
`timezone`string \| nullOptional	IANA time zone, e.g. Asia/Kolkata Default: `null` Example: `Asia/Kolkata`
`utc_offset`string \| nullOptional	Fixed offset such as +05:30, if no IANA zone is known Default: `null`
`latitude`numberRequired	Limits: minimum -90, maximum 90 Example: `28.6139`
`longitude`numberRequired	Limits: minimum -180, maximum 180 Example: `77.209`
`ayanamsha`stringOptional	Default: `lahiri`
`language`stringOptional	Output language (ISO 639-1). The values listed are the ones this capability supports; any other is refused with 422 unsupported_language. Identifiers, enum values and numbers never change with language. Default: `en` Allowed value: en
`node`stringOptional	Lunar node: true (osculating) or mean. Default: `true` Allowed values: truemean
`labels`stringOptional	Optional. Adds `meta.labels`: translated display names for the identifiers in the answer. `data` is unchanged. Free. Any other code is refused with 422 unsupported_language. Allowed values: asbndeesfrguhiitknkomlmrnenlorpaplptrusitatetrur

Response · fields in data

Inferred from the example response: a guide to the shape, not a contract.

ayanamsha · string
moolank · integer
bhagyank · integer
gems · array of object

Try in Playground →Capability overview

Example request

curl -X POST https://api.96astro.com/v1/bnn/bnn-ratna \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}'

const response = await fetch("https://api.96astro.com/v1/bnn/bnn-ratna", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209
  }),
});

const { data, meta } = await response.json();
console.log(data);

import { Astro96Client } from "@96astro/api";

const astro = new Astro96Client({ apiKey: "YOUR_API_KEY" });

const { data, meta } = await astro.bnn.bnnRatna({
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
});
console.log(data);

import requests

response = requests.post(
    "https://api.96astro.com/v1/bnn/bnn-ratna",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209,
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()["data"]
print(data)

from astro96_api import Astro96Client

astro = Astro96Client(api_key="YOUR_API_KEY")

res = astro.bnn.bnn_ratna({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209,
})
print(res.data)

<?php
$ch = curl_init('https://api.96astro.com/v1/bnn/bnn-ratna');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'datetime' => '1990-10-18T14:30:00',
        'timezone' => 'Asia/Kolkata',
        'latitude' => 28.6139,
        'longitude' => 77.209,
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}`)
	req, err := http.NewRequest("POST", "https://api.96astro.com/v1/bnn/bnn-ratna", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Example response

200application/json

{
  "data": {
    "ayanamsha": "lahiri",
    "moolank": 9,
    "bhagyank": 2,
    "gems": [
      {
        "type": "life",
        "basis": "Life gem based on birth Nakshatra lord — supports vitality and life path.",
        "planet": "Mars",
        "gem": "Red Coral",
        "hindi_name": "Moonga",
        "metal": "Gold",
        "finger": "Ring",
        "substitutes": [
          "Red Carnelian",
          "Red Jasper"
        ],
        "reason": "Moon is in Chitra; its lord is Mars."
      },
  …

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items.

Error responses

400invalid_request
401invalid_key, expired_key
402payment_required
403account_suspended
404not_found
409idempotency_conflict
413payload_too_large
422invalid_request, unsupported_language
429rate_limited, quota_exhausted, spend_cap_reached, project_budget_exceeded
500computation_failed
502unavailable
503unavailable
504deadline_exceeded

Errors are never charged. What each status means and what to do: errors.

BNN Yogas

POSTAvailable

https://api.96astro.com/v1/bnn/bnn-yoga

Classical and Nadi yogas, Bhrigu Bindu and Nadi chains.

Credits: 1 credit
Input: Birth details
Output: JSON
Delivery: Direct response
Languages: English; translated term names with labels

Headers
Header	Value and description
`Authorization`Required	`Bearer YOUR_API_KEY` Your sandbox (sk_test_...) or live (sk_live_...) key. X-API-Key: <key> is accepted instead.
`Content-Type`Required	`application/json` The body is JSON.
`Idempotency-Key`Optional	`<unique string>` Makes retries safe: a repeated key with the same body replays the stored response and is never charged twice. (1 to 200 characters)

Body · application/json
Field	Description
`datetime`stringRequired	Local date and time, ISO 8601 without offset, e.g. 1990-10-18T14:30:00 Limits: format local-date-time, pattern ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?$ Example: `1990-10-18T14:30:00`
`timezone`string \| nullOptional	IANA time zone, e.g. Asia/Kolkata Default: `null` Example: `Asia/Kolkata`
`utc_offset`string \| nullOptional	Fixed offset such as +05:30, if no IANA zone is known Default: `null`
`latitude`numberRequired	Limits: minimum -90, maximum 90 Example: `28.6139`
`longitude`numberRequired	Limits: minimum -180, maximum 180 Example: `77.209`
`ayanamsha`stringOptional	Default: `lahiri`
`language`stringOptional	Output language (ISO 639-1). The values listed are the ones this capability supports; any other is refused with 422 unsupported_language. Identifiers, enum values and numbers never change with language. Default: `en` Allowed value: en
`node`stringOptional	Lunar node: true (osculating) or mean. Default: `true` Allowed values: truemean
`labels`stringOptional	Optional. Adds `meta.labels`: translated display names for the identifiers in the answer. `data` is unchanged. Free. Any other code is refused with 422 unsupported_language. Allowed values: asbndeesfrguhiitknkomlmrnenlorpaplptrusitatetrur

Response · fields in data

Inferred from the example response: a guide to the shape, not a contract.

ayanamsha · string
classical_yogas · array of object
nadi_yogas · array of object
bhrigu_bindu · object
nadi_chains · array of object

Try in Playground →Capability overview

Example request

curl -X POST https://api.96astro.com/v1/bnn/bnn-yoga \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}'

const response = await fetch("https://api.96astro.com/v1/bnn/bnn-yoga", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209
  }),
});

const { data, meta } = await response.json();
console.log(data);

import { Astro96Client } from "@96astro/api";

const astro = new Astro96Client({ apiKey: "YOUR_API_KEY" });

const { data, meta } = await astro.bnn.bnnYoga({
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
});
console.log(data);

import requests

response = requests.post(
    "https://api.96astro.com/v1/bnn/bnn-yoga",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209,
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()["data"]
print(data)

from astro96_api import Astro96Client

astro = Astro96Client(api_key="YOUR_API_KEY")

res = astro.bnn.bnn_yoga({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209,
})
print(res.data)

<?php
$ch = curl_init('https://api.96astro.com/v1/bnn/bnn-yoga');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'datetime' => '1990-10-18T14:30:00',
        'timezone' => 'Asia/Kolkata',
        'latitude' => 28.6139,
        'longitude' => 77.209,
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}`)
	req, err := http.NewRequest("POST", "https://api.96astro.com/v1/bnn/bnn-yoga", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Example response

200application/json

{
  "data": {
    "ayanamsha": "lahiri",
    "classical_yogas": [
      {
        "name": "Guru-Chandal Yoga",
        "category": "Mixed Yoga",
        "detail": "Jupiter conjunct Ketu in Cancer.",
        "strength": "Mixed"
      },
      {
        "name": "Hamsa Yoga",
        "category": "Panch Mahapurusha",
        "detail": "Jupt in Cancer (house 7) — Hamsa Yoga.",
        "strength": "Strong"
      },
      {
        "name": "Kemadruma Yoga",
        "category": "Dosha Yoga",
        "detail": "No planets in 2nd/12th from Moon (Virgo) — isolation tendency.",
  …

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items.

Error responses

400invalid_request
401invalid_key, expired_key
402payment_required
403account_suspended
404not_found
409idempotency_conflict
413payload_too_large
422invalid_request, unsupported_language
429rate_limited, quota_exhausted, spend_cap_reached, project_budget_exceeded
500computation_failed
502unavailable
503unavailable
504deadline_exceeded

Errors are never charged. What each status means and what to do: errors.

BNN Dashas

POSTAvailable

https://api.96astro.com/v1/bnn/bnn-dasha

Ashtottari and Naisargika dasha periods, with the Ashtottari start lord and balance, and the periods running now.

Credits: 1 credit
Input: Birth details
Output: JSON
Delivery: Direct response
Languages: English; translated term names with labels

Headers
Header	Value and description
`Authorization`Required	`Bearer YOUR_API_KEY` Your sandbox (sk_test_...) or live (sk_live_...) key. X-API-Key: <key> is accepted instead.
`Content-Type`Required	`application/json` The body is JSON.
`Idempotency-Key`Optional	`<unique string>` Makes retries safe: a repeated key with the same body replays the stored response and is never charged twice. (1 to 200 characters)

Body · application/json
Field	Description
`datetime`stringRequired	Local date and time, ISO 8601 without offset, e.g. 1990-10-18T14:30:00 Limits: format local-date-time, pattern ^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?$ Example: `1990-10-18T14:30:00`
`timezone`string \| nullOptional	IANA time zone, e.g. Asia/Kolkata Default: `null` Example: `Asia/Kolkata`
`utc_offset`string \| nullOptional	Fixed offset such as +05:30, if no IANA zone is known Default: `null`
`latitude`numberRequired	Limits: minimum -90, maximum 90 Example: `28.6139`
`longitude`numberRequired	Limits: minimum -180, maximum 180 Example: `77.209`
`ayanamsha`stringOptional	Default: `lahiri`
`language`stringOptional	Output language (ISO 639-1). The values listed are the ones this capability supports; any other is refused with 422 unsupported_language. Identifiers, enum values and numbers never change with language. Default: `en` Allowed value: en
`as_of`string \| nullOptional	Date for `current` (YYYY-MM-DD). Today in UTC when omitted. Default: `null` Limits: format date
`labels`stringOptional	Optional. Adds `meta.labels`: translated display names for the identifiers in the answer. `data` is unchanged. Free. Any other code is refused with 422 unsupported_language. Allowed values: asbndeesfrguhiitknkomlmrnenlorpaplptrusitatetrur

Options (2)
Value	Meaning
`ashtottari`	Ashtottari
`naisargika`	Naisargika

Response · fields in data

Inferred from the example response: a guide to the shape, not a contract.

ayanamsha · string
moon_nakshatra · string
note · string
ashtottari · object
naisargika · object
current · object

Try in Playground →Capability overview

Example request

curl -X POST https://api.96astro.com/v1/bnn/bnn-dasha \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}'

const response = await fetch("https://api.96astro.com/v1/bnn/bnn-dasha", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209
  }),
});

const { data, meta } = await response.json();
console.log(data);

import { Astro96Client } from "@96astro/api";

const astro = new Astro96Client({ apiKey: "YOUR_API_KEY" });

const { data, meta } = await astro.bnn.bnnDasha({
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
});
console.log(data);

import requests

response = requests.post(
    "https://api.96astro.com/v1/bnn/bnn-dasha",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "datetime": "1990-10-18T14:30:00",
        "timezone": "Asia/Kolkata",
        "latitude": 28.6139,
        "longitude": 77.209,
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()["data"]
print(data)

from astro96_api import Astro96Client

astro = Astro96Client(api_key="YOUR_API_KEY")

res = astro.bnn.bnn_dasha({
    "datetime": "1990-10-18T14:30:00",
    "timezone": "Asia/Kolkata",
    "latitude": 28.6139,
    "longitude": 77.209,
})
print(res.data)

<?php
$ch = curl_init('https://api.96astro.com/v1/bnn/bnn-dasha');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'datetime' => '1990-10-18T14:30:00',
        'timezone' => 'Asia/Kolkata',
        'latitude' => 28.6139,
        'longitude' => 77.209,
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "datetime": "1990-10-18T14:30:00",
  "timezone": "Asia/Kolkata",
  "latitude": 28.6139,
  "longitude": 77.209
}`)
	req, err := http.NewRequest("POST", "https://api.96astro.com/v1/bnn/bnn-dasha", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Example response

200application/json

{
  "data": {
    "ayanamsha": "lahiri",
    "moon_nakshatra": "Chitra",
    "note": "Ashtottari (BPHS, 108 years) starts from the lord of the Moon's nakshatra group counted from Ardra; the balance is the unelapsed share of that whole group. Its periods cover at least 80 years and are dated from the birth moment on 365.25-day years (the balance is given to 0.01 year); the Moon is read to the arc-second, which alone can move every boundary by about 22 minutes for this chart. Naisargika (BPHS) runs the same ages for every chart, dated by birthday; `natal_sign` and `natal_house` (whole signs from the ascendant) place each lord in the birth chart.",
    "ashtottari": {
      "total_years": 108,
      "start_lord": "Mars",
      "start_lord_nakshatras": [
        "Hasta",
        "Chitra",
        "Swati"
      ],
      "balance_years": 5.32,
      "periods": [
        {
          "lord": "Mars",
          "years": 5.32,
          "start": "1990-10-18",
          "end": "1996-02-12",
  …

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items.

Error responses

400invalid_request
401invalid_key, expired_key
402payment_required
403account_suspended
404not_found
409idempotency_conflict
413payload_too_large
422invalid_request, unsupported_language
429rate_limited, quota_exhausted, spend_cap_reached, project_budget_exceeded
500computation_failed
502unavailable
503unavailable
504deadline_exceeded

Errors are never charged. What each status means and what to do: errors.