For developers

API documentation Coming soon

The same computation core that ships inside the app, over HTTP. 62 endpoints covering Vedic (Drik and Surya Siddhanta), Western tropical and KP — charts, dashas, transits, kundli matching and reports.

Browse endpoints

The birth payload

Almost every calculation endpoint takes the same body. Time is local wall-clock time at the birth place, and timezone_offset resolves it to UTC — so no timezone database lookup is involved.

FieldTypeNotes
yearintegerRequired. Negative values are BCE.
month, day integerRequired. 1–12 and 1–31.
hour, minute integerRequired. 0–23 and 0–59.
secondintegerOptional, defaults to 0.
latitude, longitude floatRequired. East and north positive.
timezone_offset float Required. Decimal hours from UTC — 5.5 is IST.
placestring Optional label. Never used in the calculation.
tradition enum Optional on endpoints that accept it. See below.

Traditions

The path sets the tradition by default — /vedic/* is sidereal, /western/* is tropical. Endpoints that take a tradition field let you override it.

drik

Sidereal, Lahiri ayanamsa, whole-sign houses. The default.

surya_siddhanta

Classical Siddhantic positions rather than modern ephemeris.

western

Tropical zodiac with Placidus houses.

kp

Krishnamurti Paddhati sub-lord divisions.

A worked example

Requesting a Drik sidereal chart. The response is trimmed to one planet and one house — the real payload carries all nine grahas and twelve houses.

Request 

curl https://api.astrobaje.com/api/v1/vedic/drik/chart \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "year": 1990, "month": 6, "day": 15,
    "hour": 14, "minute": 30, "second": 0,
    "latitude": 28.6139, "longitude": 77.2090,
    "timezone_offset": 5.5,
    "place": "New Delhi"
  }'

Response 

{
  "data": {
    "planets": [
      {
        "name": "Sun",
        "longitude": 60.283007332,
        "latitude": 0.000116107,
        "speed": 0.955115250,
        "retrograde": false,
        "sign": "Gemini",
        "degree": 0.283007332,
        "house": 10,
        "nakshatra": {
          "name": "Mrigashira",
          "index": 4,
          "pada": 3,
          "lord": "Mars",
          "gana": "Deva",
          "degree": 6.949673998
        }
      }
    ],
    "houses": [
      { "number": 1, "cusp": 156.272908326, "sign": "Virgo", "planets": [] }
    ],
    "ascendant": 178.743061180,
    "rising_sign": "Virgo",
    "midheaven": 89.996595057,
    "ayanamsa": 23.727091673,
    "zodiac": "Sidereal",
    "house_system": "WholeSign",
    "panchanga": {
      "tithi": 22, "tithi_name": "Saptami", "paksha": "Krishna",
      "vara": "Friday", "yoga_name": "Priti", "karana": "Bava"
    },
    "tradition": "drik"
  }
}

Endpoint reference

All paths are relative to /api/v1.

Saved charts 6

GET/chartsList the caller’s saved charts
POST/chartsSave a chart
GET/charts/{id}Another user’s chart returns 404, never 403.
PUT/charts/{id}Replace a saved chart
DELETE/charts/{id}Delete a saved chart
POST/charts/{id}/computeOptional body: tradition.

Mantras 3

GET/mantrasList every mantra recording
GET/mantras/{slug}Check has_text before rendering text — only the nine planetary beeja mantras carry verified text.
GET/mantras/planet/{planet}Mantras for a planet

Charts 5

POST/vedic/drik/chartSwiss Ephemeris sidereal chart with Lahiri ayanamsa and whole-sign houses.
POST/vedic/surya-siddhanta/chartTraditional calibrated positions (JHora SS offsets applied to Lahiri base).
POST/vedic/dual/chartReturns both Drik and Surya Siddhanta charts for comparison.
POST/western/chartWestern tropical chart
POST/kp/chartKrishnamurti ayanamsa with Placidus house system.

Analysis 21

POST/analysis/house-lordsHouse lords
POST/analysis/planet-dignityPlanet dignity
POST/analysis/vargasAll varga divisions for planets
POST/analysis/varga-chart/{division}Divisional (varga) chart
POST/analysis/arabic-partsArabic parts / lots
POST/analysis/upagrahasUpagrahas (sub-planets)
POST/analysis/special-lagnasSpecial lagnas (Bhava, Hora, etc.)
POST/analysis/planet-conditionsPlanet conditions and dignities
POST/analysis/shadbalaShadbala (six-fold strength)
POST/analysis/vimshopakaVimshopaka Bala
POST/analysis/ashtakavargaAshtakavarga (SAV/BAV)
POST/analysis/vedic-aspectsVedic planetary aspects
POST/analysis/western-aspectsWestern major aspects
POST/analysis/yogasYoga detection
POST/analysis/panchangaPanchanga elements for birth moment
POST/analysis/sunrise-sunsetSunrise and sunset times
POST/analysis/rahu-kaalRahu Kaal window
POST/analysis/kpKP sub-lord analysis
POST/analysis/lal-kitabLal Kitab analysis
POST/analysis/fixed-starsFixed star conjunctions
POST/analysis/layoutChart layout positions (North/South/Western wheel)

Dasha 4

POST/dasha/vimsottariVimsottari mahadashas
POST/dasha/vimsottari-with-antardashasVimsottari with antardashas
POST/dasha/yoginiYogini dasha periods
POST/dasha/current-stackCurrent dasha stack at target Julian day

Transits 3

POST/transits/positionsPlanetary transit positions
POST/transits/chartNatal + transit chart overlay
POST/transits/gocharaGochara (transits from Moon) with Sade Sati

Predictive 7

POST/predictive/progressedSecondary progressed chart
POST/predictive/solar-arcSolar arc directions
POST/predictive/solar-returnSolar return chart
POST/predictive/lunar-returnLunar return chart
POST/predictive/varshaphalaVarshaphala (annual chart/Tajika)
POST/predictive/score-muhuratScore a muhurat candidate time
POST/predictive/find-best-muhuratFind best muhurat in a date range

Relationship 2

POST/relationship/synastryInter-aspects, house overlays, composite, Davison chart, compatibility score.
POST/relationship/kundli-matchingperson_a = bride, person_b = groom.

Reports 3

POST/report/interpretChart interpretation
POST/report/fullFull composite report
POST/report/remediesRecommended remedies

Utility 2

POST/utility/numerologyNumerology report
POST/utility/sabianSend ecliptic_longitude directly, or send birth data (uses the Sun's longitude). Example below uses ecliptic longitude.

Health 1

GET/healthReturns API status and whether Swiss Ephemeris files are available.

Errors

401

Missing, expired or revoked bearer token.

404

Unknown route, or a saved chart owned by someone else.

422

Validation failed. The body names each offending field.

503

The calculation engine is unavailable.