Ashtakoota Matching API
Return the components behind a traditional Ashtakoota comparison instead of an unexplained compatibility badge. Both role directions are calculated, and an optional explicit role selects one score.
POST /v1/vedic/matching50,000 credits per monthly allowance · no trial · no automatic overage charges. Plan details ↗
What this API provides.
Calculate all eight Ashtakoota components and raw totals out of 36 in both traditional role directions. Inspect scores, conventions and limitations.
Totals out of 36 in both traditional directions
Explicit person1/person2 role ordering
Moon sidereal longitudes, nakshatras and profile metadata
Send
- Known-time person1.birth and person2.birth objects
- Optional role_order: person1_as_groom or person2_as_groom
- Lahiri profile and locale; gender is never inferred
Receive
- person1_moon and person2_moon
- directional_scores with component-level points and totals
- selected_score only when role_order is supplied
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",
"person1": {
"birth": {
"date": "1990-05-21",
"time": "14:30:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
}
},
"person2": {
"birth": {
"date": "1992-02-10",
"time": "08:15:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
}
}
}{
"request_id": "acc40d93865a84cfdd7989601054b777",
"api_version": "v1",
"locale": "en",
"data": {
"person1_moon": {
"sidereal_longitude": 354.35642422,
"nakshatra": {
"index": 27,
"name": "revati",
"pada": 3,
"fraction_elapsed": 0.5767318161
}
},
"person2_moon": {
"sidereal_longitude": 10.36003238,
"nakshatra": {
"index": 1,
"name": "ashwini",
"pada": 4,
"fraction_elapsed": 0.7770024286
}
},
"role_policy": "explicit_traditional_roles_not_inferred_gender",
"directional_scores": {
"person1_as_groom": {
"total": 26,
"maximum": 36,
"components": [
{
"name": "varna",
"points": 1,
"maximum": 1
}
],
"exceptions_applied": false
},
"person2_as_groom": {
"total": 25,
"maximum": 36,
"components": [
{
"name": "varna",
"points": 0,
"maximum": 1
}
],
"exceptions_applied": false
}
},
"selected_score": null
},
"interpretation": {
"locale": "en",
"kind": "vedic/matching",
"disclaimer": "Symbolic reflection, not a verified prediction or professional advice.",
"coverage": {
"total_facts": 4,
"selected_facts": 4,
"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/matching.person1_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/matching.person1_moon.nakshatra",
"type": "vedic_nakshatra"
}
}
]
},
"warnings": [
"traditional_symbolic_score_not_relationship_probability",
"raw_points_no_dosha_cancellation_or_remedies_applied"
],
"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/matching' \
+ --header 'Authorization: Bearer YOUR_API_KEY' \
+ --header 'Content-Type: application/json' \
+ --header 'Idempotency-Key: ashtakoota-matching-api-example-001' \
+ --data '{
"locale": "en",
"person1": {
"birth": {
"date": "1990-05-21",
"time": "14:30:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
}
},
"person2": {
"birth": {
"date": "1992-02-10",
"time": "08:15:00",
"timezone": "Europe/Madrid",
"latitude": 40.4168,
"longitude": -3.7038
}
}
}'Example computed 2026-11-17. Full fixture manifest, engine versions and SHA-256 checksums ↗
Ways to use it.
- A transparent traditional matching interface
- Side-by-side directional score explanations
- An alternative symbolic comparison alongside synastry
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.
- The raw 36-point profile does not apply dosha cancellations or prescribe remedies.
- A traditional score is not a scientifically measured relationship probability or a recommendation to marry.
- Regional tables and exceptions vary; the named AIFAS2021 raw36 profile is returned explicitly.
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.
Why are there two totals?
Some traditional component rules are directional. Both person1_as_groom and person2_as_groom are returned, so the service does not infer gender or silently choose a role.
Are cancellations or remedies included?
No. This endpoint returns raw component points under the declared profile. Dosha cancellations and remedies are explicitly excluded.
Is a high score a guarantee?
No. This is a symbolic traditional comparison, not a validated relationship outcome prediction. The response includes that limitation.
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.