HomeAPI Docs › Varshphal API

Varshphal API

Annual Solar Return: yearly chart, muntha, harsha bala — Hindi + English in every response.

8endpoints
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/varshphal/ascendant \
  -H "Authorization: Bearer sk-test-your-key" \
  -H "Content-Type: application/json" \
  -d '{"dob":"1990-06-15","gender":"male","lat":28.6139,"lon":77.209,"name":"Rahul Sharma","tob":"10:30","tz":5.5}'

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 Varshphal endpoints

EndpointWhat it returns
POST /v1/varshphal/ascendantVarsha Lagna (Solar Return Ascendant) for the given year.
POST /v1/varshphal/fullComplete Varshphal (Solar Return) chart for given year.
POST /v1/varshphal/mudda-dashaMudda Dasha (365-day Vimshottari) for the solar year.
POST /v1/varshphal/munthaMuntha lord and position (advances 1 sign per year from natal lagna).
POST /v1/varshphal/predictionsYearly predictions based on Varshphal chart analysis.
POST /v1/varshphal/sahams20 classical Sahams (Tajika sensitive points) for the Varshphal chart. Formula: A − B + C for day charts, A/B swapped for night charts where the saham reverses; +30° when the lagna does not fall between B and A.
POST /v1/varshphal/tri-patakiTri Pataki Chakra — 3 signs of importance for the year.
POST /v1/varshphal/year-lordVarshesha (Year Lord) — classical Tajika five office-bearers method. Candidates: Muntha lord, Varsha-Lagna lord, Janma-Lagna lord, Dina-Ratri lord (Sun's sign lord by day / Moon's by night), Tri-Rashi lord. The one casting a Tajika aspect on the varsha lagna and strongest wins; if none aspects, the Muntha lord is Year Lord by classical fallback.

Frequently asked questions

What does the Varshphal API return?

Annual Solar Return: yearly chart, muntha, harsha bala. Every response is JSON with both Hindi and English strings, computed astronomically on the Lahiri ayanamsa (the Indian government standard). This module has 8 endpoints.

Can I try the Varshphal 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