HomeAPI Docs › Transits API

Transits API

Gochara: current planetary positions, natal comparison, Sade Sati, Jupiter/Saturn transits — Hindi + English in every response.

11endpoints
hi + enbilingual JSON
Lahiriayanamsa
Freeunlimited test mode

Get a free API key Try it in the playground

Quick start

curl -X POST https://api.grahaapi.com/v1/transits/aspects \
  -H "Authorization: Bearer sk-test-your-key" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"dob":"1990-06-15","lat":28.6139,"lon":77.209,"tob":"10:30","tz":5.5},"transit_date":"2026-07-15","transit_time":"10:30"}'

Test keys (sk-test-…) are free and unlimited — the response structure is guaranteed identical to production, so you can build your whole integration before paying anything.

All Transits endpoints

EndpointWhat it returns
POST /v1/transits/aspectsTransit planets aspecting natal planets using Vedic Graha Drishti (house-based aspects). All planets aspect 7th; Mars additionally 4th & 8th; Jupiter 5th & 9th; Saturn 3rd & 10th.
POST /v1/transits/currentCurrent planetary positions for given date and location.
POST /v1/transits/from-birthTransit planets positioned relative to natal lagna (house numbers).
POST /v1/transits/fullFull transit report: current transits, transit-from-birth, sade sati, gochara, and next 3 upcoming events.
POST /v1/transits/gocharaAll planets' Gochara effects from natal Moon sign.
POST /v1/transits/ingressPlanet sign ingresses in next 12 months. Served from pre-computed transit data — zero ephemeris scan cost.
POST /v1/transits/jupiterJupiter transit analysis — sign and house from natal chart.
POST /v1/transits/retrogradeCurrently retrograde planets and their effects.
POST /v1/transits/sade-satiFull Sade Sati (7.5-year Saturn cycle) analysis.
POST /v1/transits/saturnSaturn transit analysis including Sade Sati check.
POST /v1/transits/upcomingUpcoming significant planetary transits in next 90 days. Uses pre-computed transit data (zero day-scan cost) + one natal chart lookup.

Frequently asked questions

What does the Transits API return?

Gochara: current planetary positions, natal comparison, Sade Sati, Jupiter/Saturn transits. Every response is JSON with both Hindi and English strings, computed astronomically on the Lahiri ayanamsa (the Indian government standard). This module has 11 endpoints.

Can I try the Transits API for free?

Yes — sk-test- keys are free and unlimited, and return the exact production response structure (computed from a fixed sample chart). The Free plan then gives 1,000 real API calls per month with no credit card.

How is GrahaAPI priced?

Simple INR pricing: Free (1,000 calls/mo), then paid plans from ₹499/mo. One call = one call on every endpoint — no credit system. Paid plans are throttled over quota, never blocked.

Full interactive reference for all 237 endpoints: GrahaAPI Docs · Plain-language explainers: Wiki