Vimshottari Dasha API
Calculate a Vimshottari sequence from the sidereal Moon’s birth nakshatra. The response exposes the opening-period balance and the period active at your selected reference instant.
POST /v1/vedic/dashas50,000 credits per monthly allowance · no trial · no automatic overage charges. Plan details ↗
What this API provides.
Get a Moon-nakshatra-based Vimshottari timeline, mahadasha and antardasha with explicit 365.25-day years. Preview real computed period data.
Remaining balance of the opening mahadasha
Mahadasha and antardasha period dates
An explicit 365.25-day year convention
Send
- A known-time birth object
- Optional at timestamp; specify it for reproducible reference-period selection
- The documented Lahiri sidereal profile and locale
Receive
- Moon nakshatra and opening balance
- Major-period timeline and subperiod data
- Current reference-period selection with method metadata
Real input. Real output.
Precomputed by the actual calculation engine and response formatter, using synthetic example data. No purchased access or paid provider call was needed.
{
"locale": "en",
"birth": {
"date": "1990-05-21",
"time": "14:30:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
},
"at": "2026-11-17T12:00:00Z"
}{
"request_id": "4f42f716627dc868f0746690a4adc077",
"api_version": "v1",
"locale": "en",
"data": {
"system": "vimshottari_120",
"at": "2026-11-17T12:00:00Z",
"moon_nakshatra": {
"index": 27,
"name": "revati",
"pada": 3,
"fraction_elapsed": 0.5767318161,
"lord": "mercury"
},
"birth_balance_years": 7.195559126,
"current": {
"mahadasha": "sun",
"antardasha": "jupiter"
},
"mahadashas": [
{
"lord": "mercury",
"start_at": "1980-07-31T10:46:16Z",
"end_at": "1997-07-31T16:46:16Z",
"antardashas": [
{
"lord": "mercury",
"start_at": "1980-07-31T10:46:16Z",
"end_at": "1982-12-28T02:13:16Z"
}
]
},
{
"lord": "ketu",
"start_at": "1997-07-31T16:46:16Z",
"end_at": "2004-07-31T10:46:16Z",
"antardashas": [
{
"lord": "ketu",
"start_at": "1997-07-31T16:46:16Z",
"end_at": "1997-12-27T20:13:16Z"
}
]
}
]
},
"interpretation": {
"locale": "en",
"kind": "vedic/dashas",
"disclaimer": "Symbolic reflection, not a verified prediction or professional advice.",
"coverage": {
"total_facts": 2,
"selected_facts": 2,
"omitted_count": 0,
"selection_method": "all-source-facts-v1",
"full_numeric_data_unchanged": true
},
"method": {
"engine": "celestack-original-rules-v1",
"corpus": "celestack-original-compositional-v1",
"corpus_version": "2026-11-17.2",
"fallback_locale": null,
"editorial_status": "agent-authored; independent linguistic review pending",
"predictive_validity": "symbolic interpretations are not scientifically validated predictions",
"chinese_solar_terms": "numeric calendar output only; no rule paragraphs in this corpus"
},
"items": [
{
"fact_id": "vedic/dashas.moon_nakshatra",
"title": "Revati",
"text": "Calculated lunar mansion: Revati, number 27, pada 3, traditional ruler Mercury. Use this sidereal calendar symbol to reflect on recurring rhythms; it does not determine a personal outcome.",
"source": {
"index": 27,
"name": "revati",
"pada": 3,
"fraction_elapsed": 0.5767318161,
"lord": "mercury",
"id": "vedic/dashas.moon_nakshatra",
"type": "vedic_nakshatra"
}
}
]
},
"warnings": [],
"credits_used": 5
}The response preview selects whole fields and array entries for readability; no numeric values have been replaced. The full download preserves all fields, arrays and interpretation. The request_id is synthetic, and credits_used shows the configured successful-request cost; no credits were consumed.
cURL request — use your own API key and a new idempotency key
curl --request POST 'https://api.celestackapi.com/v1/vedic/dashas' \
+ --header 'Authorization: Bearer YOUR_API_KEY' \
+ --header 'Content-Type: application/json' \
+ --header 'Idempotency-Key: vimshottari-dasha-api-example-001' \
+ --data '{
"locale": "en",
"birth": {
"date": "1990-05-21",
"time": "14:30:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
},
"at": "2026-11-17T12:00:00Z"
}'Example computed 2026-11-17. Full fixture manifest, engine versions and SHA-256 checksums ↗
Ways to use it.
- A scrollable traditional period timeline
- Reference-date period lookup
- A source-linked reading alongside a Vedic chart
12 response locales
English, Ukrainian, Japanese, Spanish, French, German, Portuguese, Arabic, Italian, Hindi, Chinese and Korean.
Calculation values remain language-independent. Localized rule text is agent-authored; independent native-language review remains pending. Machine-readable field names stay stable.
Limits and interpretation.
- Birth time is required because the starting Moon position controls the period balance.
- This is Vimshottari under one stated year convention, not every dasha system.
- Period names are symbolic chronology, not proof that a personal event will occur.
Interpretive content is for symbolic reflection and entertainment. It is not a verified personal prediction or professional advice. Read the API conventions ↗
Choose your billing.
Both options include 50,000 credits per monthly allowance, resetting monthly. No trial and no automatic overage. Custom needs use a contact form.
Saved results: 7-day retention, up to 128 MiB per organization on this initial shared deployment, with a 512 MiB shared retained-result limit. Capacity can return a temporary error; there are no automatic extra charges. Production artifacts have separate retention. All usage and resource limits ↗. Checkout availability is shown in your account.
Frequently asked questions.
How is the first period balance calculated?
It is derived from the fraction of the Moon’s sidereal birth nakshatra remaining and that nakshatra lord’s Vimshottari period length.
Which year length is used?
A period year is 365.25 days in this profile. Other traditional year conventions can yield different boundaries and are not silently mixed into this result.
Can I choose the reference date?
Yes. Supply an offset-aware at timestamp. It is included in the sample so the selected mahadasha and antardasha are reproducible.
What does access cost?
Access is USD 39.99 per month or USD 199 billed annually, with no trial. Both billing options provide 50,000 credits per monthly allowance. 5 credits per successful request or job. Daily credit, attempt, rate and resource limits apply. There are no automatic overage charges.