Bundles, sections and single endpoints

Three levelsCopy Anchor Link

Every family offers its calculations at up to three levels. Pick the smallest one that answers your question.

A single endpoint returns the same numbers as its section, because it is cut from the same calculation. A section does not drift from its singles, and you can move between levels without re-checking results. Each family page lists its single endpoints under the section they come from, and each single's own page links back to that section. A single cut from another family's section has its own card on its family's page.

Where traditions differ on a calculation, Classical methods and conventions says which one we follow and what each field means.

What they costCopy Anchor Link

A single costs one price class less than the section it is cut from, and never less than the cheapest class:

A chart single with its drawing ("include_image": true) costs 3, the price of chart-image-styles. Each operation in the OpenAPI document lists its prices in x-credits-by-input, and every answer states its charge in meta.credits_used.

Several singles for one birth share one calculation. The calculation behind a birth's sections is kept for 15 minutes, keyed by the exact birth and options. A page that calls ten singles for the same person pays for ten small answers but waits for one computation: the first call takes a few seconds, and the rest answer from it.

OptionsCopy Anchor Link

Every single takes the birth (datetime, timezone or utc_offset, latitude, longitude). Where they apply, it also takes ayanamsha (any of the published variants), node (true or mean), language and labels. A single also takes the options that choose its part:

reference re-counts the houses from the point you choose (Bhavat Bhavam): moon gives the Chandra Lagna and sun the Surya Lagna, and house:4 makes the 4th house the first.

Chart singlesCopy Anchor Link

The 23 divisional charts (divisional-chart-d1 to -d300) and the 7 special lagna charts take these options:

The image is drawn from the lagna, so a request that combines include_image with a reference other than the lagna is refused (422, not charged). Use the data, or leave out reference.

ExampleCopy Anchor Link

curl https://api.96astroapi.com/v1/vedic-charts/divisional-chart-d9 \
  -H "Authorization: Bearer $ASTRO_API_KEY" -H "Content-Type: application/json" \
  -d '{"datetime": "1990-10-18T14:30:00", "timezone": "Asia/Kolkata", "latitude": 28.6139, "longitude": 77.209}'

{
  "data": {
    "ayanamsha": { "id": "lahiri", "name": "N.C. Lahiri", "degrees": 23.7285, "degrees_true": 23.7321 },
    "node": "true",
    "chart": {
      "code": "D9",
      "name": "Navamsha",
      "reference": "lagna",
      "ascendant": { "sign": "Leo", "sign_number": 5, "degree": 5.0425 },
      "planets": [
        { "name": "Sun", "sign": "Libra", "sign_number": 7, "degree": 8.955, "retrograde": false, "combust": false, "house": 3 }
      ],
      "houses": [{ "house": 1, "sign": "Leo", "sign_number": 5, "planets": [] }]
    }
  }
}

The response above is shortened: the real one has every planet and all twelve houses.

LanguagesCopy Anchor Link

A single with sentences (doshas, readings, numerology numbers, poruthams) answers in the same languages as its section. A single with only data (charts, positions, strength tables) has no sentences to translate, so it answers in English; send "labels": "<code>" to get the names of signs, planets and nakshatras in your language next to the data. See Languages.

Every family's singlesCopy Anchor Link

Mistakes are freeCopy Anchor Link

These requests are refused before anything is charged:

• an option the single does not take, such as charts on divisional-chart-d9;
• a value outside its list, such as house: 13 or an unknown layer;
• a combination that cannot be drawn, such as image_layers without include_image.

Each answers 422 with the field and the values it accepts.