POST/api/astro/saham/1 credit

Sahams

A saham is a sensitive point worked out by arithmetic on three positions in a chart: take the arc from one planet to another and lay it off from a third point, usually the ascendant. The technique reached Indian astrology from Perso-Arabic sources and is the same idea as the Arabic lot or the Hellenistic part — Punya Saham is the Lot of Fortune under another name. Each saham stands for one department of life, such as marriage, children, wealth, illness or litigation, and its position and the strength of its lord are read for what that department will bring, chiefly in the Tajaka annual chart. Thirty-eight individual sahams are available as keys, plus `all_sahams`, which returns them all in one object. Every one returns a single point in the same shape: `{longitude, astrological: {degree, sign, minutes, seconds}, nakshatra, pada}`, where `longitude` is sidereal degrees from 0 to 360 and `sign` is a two-letter abbreviation such as `Cp` or `Sg`. Request fields are `date_time`, `latitude`, `longitude`, `timezone_as_float`, and `chart`, naming the chart class the point is built from — `RashiChart` for the ordinary birth or annual chart, with the divisional chart classes also accepted. `night_time_birth` swaps the two planets in the formula for a night birth, and `compensation` adds 30° when the projected point does not fall in the arc the classical rule expects. Both are required fields, so set them deliberately. Fifteen of the sahams have no night-time variant in this implementation and return the day formula whichever way the flag is set; those say so in their own descriptions. The `notation` field is accepted but currently makes no difference to the output: both settings return the same four fields.

https://yogataraapi.prahlad.app/api/astro/saham/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
chart	string	required	`BhavaChartRashiChartHoraChartJagannathHoraChartParivrittidwayaHoraChartDrekkanaChartParivrittitrayaDrekkanaChartSomnathDrekkanaChartJagannathDrekkanaChartChaturthamsaChartPanchamsaChartShashthamsaChart` The value is used directly as a CoreEngine registry key, so it must be one of the chart CLASS names (exact CamelCase, case-sensitive). This list is the chart-class subset of the CoreEngine registry and matches the valid_chart_types list used by /api/astro/chart/ (which lists ParivrittidwayaHoraChart twice).
compensation	boolean	required
date_time	string (date-time)	required	The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers.
keys	array	required	Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls.
night_time_birth	boolean	required
notation	string	required	`degreeastrological` Only used by the 'all_sahams' key. 'astrological' returns sign/degree/nakshatra/pada form; anything else falls through to the raw-degree output, so 'degree' is the documented (and engine-default) value for the non-astrological branch. No exception is raised for other values. The individual saham keys ignore this field entirely.
timezone_as_float	number (double)	required	UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30), -5 for New York in winter, 5.75 for Nepal. This is NOT validated against date_time - if the two disagree you get a successful response for the wrong moment, so derive both from the same source. Use the offset in force on that date, not today's: a summer birth in a country with daylight saving needs the summer offset. min -12 · max 14
latitude	number (double)	optional	Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. min -89.9 · max 89.9
longitude	number (double)	optional	Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. min -180 · max 180

Available keys (39)

Ask for exactly the calculations you want by listing them in keys. An unknown key rejects the whole request, and you are charged 1 credit however many you ask for — so batch them.

Key	Extra fields needed	Description
all_sahams	notation	All thirty-eight sahams in one object, keyed by saham name, each value the same `{longitude, astrological, nakshatra, pada}` structure the individual keys return. Cheaper to read than listing every key by hand and the natural starting point for the endpoint. Two names differ from the individual key spellings: `anya_karma_saha` (no final m) and `santapa_saham` (single a). The `notation` parameter this key takes currently makes no difference — both settings produce the same fields.
anya_karma_saham	—	The saham of other people's work, the affairs one takes on for others. Moon minus Saturn, projected from the ascendant, reversed for a night birth. Note that in the `all_sahams` response this appears under the key `anya_karma_saha`, without the final m. Returns a single point in the standard saham shape.
artha_saham	—	The saham of wealth. The cusp of the second house minus the lord of the second, projected from the ascendant. No night-time variant in the implementation. Returns a single point in the standard saham shape.
asha_saham	—	The saham of hopes and desires. Saturn minus Venus, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
bandhana_saham	—	The saham of imprisonment and confinement. Punya Saham minus Saturn, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
bandhu_saham	—	The saham of relatives and kin. Mercury minus Moon, projected from the ascendant. No night-time variant in the implementation. Returns a single point in the standard saham shape.
bhratri_saham	—	The saham of brothers and siblings. Jupiter minus Saturn, projected from the ascendant. This one has no night-time variant in the implementation: the day formula is used whatever `night_time_birth` is set to. Returns a single point in the standard saham shape.
deshantara_saham	—	The saham of foreign lands and travel abroad. The cusp of the ninth house minus the lord of the ninth, projected from the ascendant. No night-time variant in the implementation. Returns a single point in the standard saham shape.
gaurava_saham	—	The saham of dignity and the honour shown to one. Sun minus Moon, projected from Jupiter rather than from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
jadya_saham	—	The saham of chronic illness and dullness. Mars minus Saturn, projected from Mercury rather than from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
jalpatha_saham	—	The saham of the sea route, read for voyages by water. Computed from a fixed point at 15° Cancer (105° of sidereal longitude) minus Saturn, projected from the ascendant, reversed for a night birth. The only saham with a fixed zodiacal degree as an ingredient. Returns a single point in the standard saham shape.
jeeva_saham	—	The saham of life and livelihood. Saturn minus Jupiter, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
kali_saham	—	The saham of strife, marked in the source as the same computation as Kshama Saham, forbearance. Jupiter minus Mars, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
karma_saham	—	The saham of work, profession and action. Mars minus Mercury, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
karya_sidhi_saham	—	The saham of accomplishment — whether undertakings come off. Saturn minus the Sun, projected from the lord of the Sun's sign; for a night birth it becomes Saturn minus the Moon, projected from the lord of the Moon's sign. Returns a single point in the standard saham shape.
labha_saham	—	The saham of gains. The cusp of the eleventh house minus the lord of the eleventh, projected from the ascendant. No night-time variant in the implementation. Returns a single point in the standard saham shape.
mahatmya_saham	—	The saham of greatness and standing. Punya Saham minus Mars, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
manmatha_saham	—	The saham of desire and infatuation. Moon minus the lord of the ascendant's sign, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
matri_saham	—	The saham of the mother. Moon minus Venus, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
mitra_saham	—	The saham of friends and allies. Vidya Saham minus Punya Saham, projected from Venus rather than from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
mrityu_saham	—	The saham of death. The cusp of the eighth house minus the Moon, projected from Saturn — the only saham built on a house cusp rather than on the ascendant degree. No night-time variant in the implementation. Returns a single point in the standard saham shape.
paneeya_paata_saham	—	The saham of drink and of falling into water. Saturn minus Moon, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
paradara_saham	—	The saham of adultery — attachment to another's spouse. Venus minus Sun, projected from the ascendant. No night-time variant in the implementation. Returns a single point in the standard saham shape.
pitri_saham	—	The saham of the father, which here is also the computation the sources give for Raja Saham. Saturn minus Sun, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
prasava_saham	—	The saham of childbirth. Jupiter minus Mercury, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
preeti_saham	—	The saham of love and affection. Vidya Saham minus Punya Saham, projected from the ascendant. No night-time variant in the implementation, which is the one thing that distinguishes it from `mitra_saham` — that one uses the same difference but projects it from Venus and does reverse at night. Returns a single point in the standard saham shape.
punya_saham	—	Punya Saham, the Lot of Fortune and the most important of the set — read for general good fortune and protection over the year. Moon minus Sun, projected from the ascendant, reversed to Sun minus Moon for a night birth. Returns a single point in the standard saham shape.
putra_saham	—	The saham of children and progeny. Jupiter minus Moon, projected from the ascendant. No night-time variant in the implementation — the day formula is used whatever `night_time_birth` is set to. Returns a single point in the standard saham shape.
roga_saham	—	The saham of illness. Ascendant minus Moon, projected from the ascendant again, which reduces to twice the ascendant less the Moon. No night-time variant in the implementation. Returns a single point in the standard saham shape.
samarthya_saham	—	The saham of capability — what the native can actually carry out. Mars minus the lord of the ascendant's sign, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
santaapa_saham	—	The saham of sorrow and distress. Saturn minus Moon, projected from the cusp of the sixth house. No night-time variant in the implementation. Returns a single point in the standard saham shape. In the `all_sahams` response it appears under the key `santapa_saham`, with a single a.
shastra_saham	—	The saham of scripture and formal learning. Jupiter minus Saturn, projected from Mercury rather than from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
shatru_saham	—	The saham of enemies. Mars minus Saturn, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
shraddha_saham	—	The saham of faith and devotion. Venus minus Mars, projected from the ascendant. No night-time variant in the implementation. Returns a single point in the standard saham shape.
vanika_saham	—	The saham of trade and the merchant's business. Moon minus Mercury, projected from the ascendant. No night-time variant in the implementation. Returns a single point in the standard saham shape.
vidya_saham	—	The saham of learning and education, the same computation the sources give for Guru Saham. Sun minus Moon, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.
vivaha_saham	—	The saham of marriage. Venus minus Saturn, projected from the ascendant. No night-time variant in the implementation. Returns a single point in the standard saham shape.
vyapara_saham	—	The saham of business dealings. Mars minus Mercury, projected from the ascendant. No night-time variant in the implementation, which is what separates it from `karma_saham` — that one uses the same difference and does reverse at night. Returns a single point in the standard saham shape.
yasha_saham	—	The saham of fame and reputation. Jupiter minus the Punya Saham point, projected from the ascendant, reversed for a night birth. Returns a single point in the standard saham shape.

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/saham/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["vidya_saham"],"latitude":26.1046,"longitude":74.319,"timezone_as_float":5.5,"chart":"RashiChart","night_time_birth":true,"compensation":true,"notation":"degree","date_time":"2026-09-01T06:00:00+05:30"}'

Response

{
  "data": {
    "vidya_saham": {
      "longitude": 263.64509259138845,
      "astrological": {
        "degree": 23,
        "sign": "Sg",
        "minutes": 38,
        "seconds": 42
      },
      "nakshatra": "Poorvaashaadha",
      "pada": 4
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Captured from a real call using the exact request above. Results sit under data, keyed by what you requested.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.