Get free key

Varshphal API

Annual Solar Return: yearly chart, muntha, harsha bala — English JSON with Hindi name twins where available.

Get a free API key Try it in the playground
Test mode

Quick start

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.

cURL
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
  }'
8 endpoints

All Varshphal endpoints

POST/v1/varshphal/ascendant

Varsha Lagna (Solar Return Ascendant) for the given year.

 POST/v1/varshphal/full

Complete Varshphal (Solar Return) chart for given year.

 POST/v1/varshphal/mudda-dasha

Mudda Dasha (365-day Vimshottari) for the solar year.

 POST/v1/varshphal/muntha

Muntha lord and position (advances 1 sign per year from natal lagna).

 POST/v1/varshphal/predictions

Yearly predictions based on Varshphal chart analysis.

 POST/v1/varshphal/sahams

20 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-pataki

Tri Pataki Chakra — 3 signs of importance for the year.

 POST/v1/varshphal/year-lord

Varshesha (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.
FAQ

Frequently asked questions

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

What does the Varshphal API return?

Annual Solar Return: yearly chart, muntha, harsha bala. Every response is JSON ({success, data, meta}); names come with Hindi twins where available (e.g. "sign": "Leo", "sign_hi": "सिंह"), 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, no overage bills. When a plan's monthly limit is used up, calls pause until the 1st (or until you upgrade).

Time to bring the cosmos into your app.

Start free. No credit card. API key in under 1 minute.

Get free API key View pricing