{"openapi":"3.1.0","info":{"title":"Ashwagosha","description":"\n# AshwaGosha Vedic Astrology API\n\nThis document describes only the versioned Jyotisha developer API at\n`https://api.ashwagosha.com/v1/jyotisha`.\n\n## Authentication\n\nSend a developer key from a trusted backend on every request:\n\n```bash\ncurl --fail-with-body -H \"Accept: application/json\" -H \"X-API-Key: $ASHWAGOSHA_API_KEY\" https://api.ashwagosha.com/v1/jyotisha/horoscope/rashi-profile/Simha\n```\n\nOperations that use saved user data also document an `Authorization: Bearer …`\nrequirement. A user bearer token does not replace the developer API key.\n\n## Contract scope\n\nOnly ready API operations explicitly assigned to the published groups appear\nhere. Experimental process-memory prototypes, explicit 501 shells, first-party\ncompatibility routes, internal operations, and Purohit workflows remain outside\nthis developer contract.\n\n## Support\n\nContact `api@ashwagosha.com` and include the response `X-Request-ID` when\nreporting a failed request.\n","version":"2.0.0"},"paths":{"/billing/plans":{"get":{"tags":["Billing & Subscriptions"],"summary":"List Plans","description":"List available subscription plans.\n\nFilter by tier or billing cycle optionally.","operationId":"list_plans_api_v1_billing_plans_get","parameters":[{"required":false,"schema":{"$ref":"#/components/schemas/SubscriptionTier"},"name":"tier","in":"query"},{"required":false,"schema":{"$ref":"#/components/schemas/BillingCycle"},"name":"billing_cycle","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlansListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/billing/plans/{plan_id}":{"get":{"tags":["Billing & Subscriptions"],"summary":"Get Plan","description":"Get details of a specific plan.","operationId":"get_plan_api_v1_billing_plans__plan_id__get","parameters":[{"required":true,"schema":{"type":"string","title":"Plan Id"},"name":"plan_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/billing/tiers/compare":{"get":{"tags":["Billing & Subscriptions"],"summary":"Compare Tiers","description":"Get tier comparison for pricing page.","operationId":"compare_tiers_api_v1_billing_tiers_compare_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TierComparisonResponse"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/billing/subscription":{"get":{"tags":["Billing & Subscriptions"],"summary":"Get My Subscription","description":"Get current user's subscription details.","operationId":"get_my_subscription_api_v1_billing_subscription_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"},"put":{"tags":["Billing & Subscriptions"],"summary":"Update Subscription","description":"Update subscription (upgrade/downgrade or settings).","operationId":"update_subscription_api_v1_billing_subscription_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"},"post":{"tags":["Billing & Subscriptions"],"summary":"Create Subscription","description":"Create a new subscription.\n\nReturns checkout session for payment.","operationId":"create_subscription_api_v1_billing_subscription_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/billing/subscription/cancel":{"post":{"tags":["Billing & Subscriptions"],"summary":"Cancel Subscription","description":"Cancel the current subscription.","operationId":"cancel_subscription_api_v1_billing_subscription_cancel_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelSubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/billing/subscription/reactivate":{"post":{"tags":["Billing & Subscriptions"],"summary":"Reactivate Subscription","description":"Reactivate a cancelled subscription.","operationId":"reactivate_subscription_api_v1_billing_subscription_reactivate_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/billing/usage":{"get":{"tags":["Billing & Subscriptions"],"summary":"Get Usage","description":"Get current usage and limits.","operationId":"get_usage_api_v1_billing_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/billing/usage/{usage_type}":{"get":{"tags":["Billing & Subscriptions"],"summary":"Get Specific Usage","description":"Get usage for a specific type.","operationId":"get_specific_usage_api_v1_billing_usage__usage_type__get","parameters":[{"required":true,"schema":{"$ref":"#/components/schemas/UsageType"},"name":"usage_type","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/billing/features":{"get":{"tags":["Billing & Subscriptions"],"summary":"Get Features","description":"Get available features for user's tier.","operationId":"get_features_api_v1_billing_features_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/billing/features/{feature}":{"get":{"tags":["Billing & Subscriptions"],"summary":"Check Feature","description":"Check if user has access to a specific feature.","operationId":"check_feature_api_v1_billing_features__feature__get","parameters":[{"required":true,"schema":{"$ref":"#/components/schemas/FeatureFlag"},"name":"feature","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/billing/invoices":{"get":{"tags":["Billing & Subscriptions"],"summary":"List Invoices","description":"List user's invoices.","operationId":"list_invoices_api_v1_billing_invoices_get","parameters":[{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":50},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/billing/invoices/{invoice_id}":{"get":{"tags":["Billing & Subscriptions"],"summary":"Get Invoice","description":"Get invoice details.","operationId":"get_invoice_api_v1_billing_invoices__invoice_id__get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Invoice Id"},"name":"invoice_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/billing/webhooks/razorpay":{"post":{"tags":["Billing & Subscriptions"],"summary":"Razorpay Subscription Webhook","description":"Forward the untouched body to the durable, signature-validating ledger.","operationId":"razorpay_subscription_webhook_api_v1_billing_webhooks_razorpay_post","parameters":[{"required":false,"schema":{"type":"string","title":"X-Razorpay-Signature"},"name":"x-razorpay-signature","in":"header"},{"required":false,"schema":{"type":"string","title":"X-Razorpay-Event-Id"},"name":"x-razorpay-event-id","in":"header"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/billing/pricing":{"get":{"tags":["Billing & Subscriptions"],"summary":"Get Pricing Data","description":"Get all data needed for pricing page.","operationId":"get_pricing_data_api_v1_billing_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/horoscope/nakshatra-profile":{"get":{"tags":["Horoscope"],"summary":"Get All Nakshatra Profiles","description":"All 27 nakshatra reference profiles (janma-nakshatra lakshana).","operationId":"get_all_nakshatra_profiles_api_v1_horoscope_nakshatra_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/horoscope/nakshatra-profile/{nakshatra}":{"get":{"tags":["Horoscope"],"summary":"Get Nakshatra Profile","description":"One nakshatra's reference profile — by number (1-27) or name.","operationId":"get_nakshatra_profile_api_v1_horoscope_nakshatra_profile__nakshatra__get","parameters":[{"required":true,"schema":{"type":"string","title":"Nakshatra"},"name":"nakshatra","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/horoscope/rashi-profile":{"get":{"tags":["Horoscope"],"summary":"Get All Rashi Profiles","description":"Reference profiles (remedies, favourable activities, varna, deity, mantra) for all 12 rashis.","operationId":"get_all_rashi_profiles_api_v1_horoscope_rashi_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/horoscope/rashi-profile/{sign}":{"get":{"tags":["Horoscope"],"summary":"Get Rashi Profile","description":"Per-Rashi reference profile: lord, element, varna, guna, presiding deity,\nbeej mantra, lucky attributes, favourable activities and classical remedies.\n\n`sign` accepts English (Leo) or Sanskrit (Simha) names.","operationId":"get_rashi_profile_api_v1_horoscope_rashi_profile__sign__get","parameters":[{"required":true,"schema":{"type":"string","title":"Sign"},"name":"sign","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/horoscope/janma-rashi":{"post":{"tags":["Horoscope"],"summary":"Get Janma Rashi","description":"The janma rashi, nakshatra and pada for one birth moment.\n\nThis is what \"which rashi am I?\" actually asks, and it is NOT answerable\nfrom `/panchang/calculate`: a panchang reads its limbs at the sunrise that\nopens the day, so for a birth on the far side of a sign ingress it names the\nsign the Moon was leaving. The Moon takes about 2.25 days to cross a sign,\nso that error is a whole wrong rashi, and the reader has no way to see it.\n\nSigned-in readers do not need this -- every person in a family household\nalready carries `janma_rashi`. It exists for the rashi finder, which serves\nvisitors with no account and no stored birth profile, and both go through\n`app/services/janma.py` so the two answers cannot diverge.\n\nAn unknown timezone is a 422 rather than a silent UTC fallback: a confident\nrashi for an instant nobody asked about is worse than a refusal.","operationId":"get_janma_rashi_api_v1_horoscope_janma_rashi_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JanmaRashiRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JanmaRashiResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/horoscope/daily":{"post":{"tags":["Horoscope"],"summary":"Get Daily Horoscope","description":"Get daily horoscope for a zodiac sign.\n\n**FREE tier** - Tracks usage against daily limits.","operationId":"get_daily_horoscope_api_v1_horoscope_daily_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/horoscope/weekly":{"post":{"tags":["Horoscope"],"summary":"Get Weekly Horoscope","description":"Get weekly horoscope for a zodiac sign (accepts `zodiac_sign`; date optional).","operationId":"get_weekly_horoscope_api_v1_horoscope_weekly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/horoscope/monthly":{"post":{"tags":["Horoscope"],"summary":"Get Monthly Horoscope","description":"Get monthly horoscope for a zodiac sign (accepts `zodiac_sign`; date optional).","operationId":"get_monthly_horoscope_api_v1_horoscope_monthly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/horoscope/all-daily":{"get":{"tags":["Horoscope"],"summary":"Get All Daily Horoscopes","description":"Get daily horoscopes for all zodiac signs.","operationId":"get_all_daily_horoscopes_api_v1_horoscope_all_daily_get","parameters":[{"required":true,"schema":{"type":"string","format":"date","title":"Date"},"name":"date","in":"query"},{"required":false,"schema":{"type":"string","title":"Ayanamsa"},"name":"ayanamsa","in":"query"},{"required":false,"schema":{"type":"string","title":"Language"},"name":"language","in":"query"},{"required":false,"schema":{"type":"string","title":"Timezone"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"number","title":"Latitude"},"name":"latitude","in":"query"},{"required":false,"schema":{"type":"number","title":"Longitude"},"name":"longitude","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllDailyHoroscopesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/horoscope/yearly":{"post":{"tags":["Horoscope"],"summary":"Get Yearly Horoscope","description":"Get yearly horoscope (Varshik Rashifal) for a zodiac sign.\n\nAccepts a JSON body with `zodiac_sign` (English or Sanskrit) and optional\n`year` (defaults to the current year). The detailed yearly forecast is\nflattened into the standard horoscope shape for the card.","operationId":"get_yearly_horoscope_api_v1_horoscope_yearly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/horoscope/multi-year":{"post":{"tags":["Horoscope"],"summary":"Get Multi Year Horoscope","description":"Get a consistent 2–10 year outlook for a sign or birth profile.","operationId":"get_multi_year_horoscope_api_v1_horoscope_multi_year_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoroscopeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/horoscope/all-yearly":{"get":{"tags":["Horoscope"],"summary":"Get All Yearly Horoscopes","description":"Get yearly horoscopes (Varshik Rashifal) for all 12 zodiac signs.\n\nThis provides comprehensive yearly forecasts for all signs including:\n- Overall yearly summary and rating for each sign\n- Quarter-by-quarter breakdowns\n- Life area forecasts\n- Major planetary transits\n- Lucky elements and remedies\n\nArgs:\n year: Year for the forecast (e.g., 2024, 2025)","operationId":"get_all_yearly_horoscopes_api_v1_horoscope_all_yearly_get","parameters":[{"required":true,"schema":{"type":"integer","title":"Year"},"name":"year","in":"query"},{"required":false,"schema":{"type":"string","title":"Ayanamsa"},"name":"ayanamsa","in":"query"},{"required":false,"schema":{"type":"string","title":"Language"},"name":"language","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/horoscope/all-weekly":{"get":{"tags":["Horoscope"],"summary":"Get All Weekly Horoscopes","description":"Get weekly horoscopes for all zodiac signs.\n\nArgs:\n date: Start date of the week (YYYY-MM-DD format)","operationId":"get_all_weekly_horoscopes_api_v1_horoscope_all_weekly_get","parameters":[{"required":true,"schema":{"type":"string","format":"date","title":"Date"},"name":"date","in":"query"},{"required":false,"schema":{"type":"string","title":"Ayanamsa"},"name":"ayanamsa","in":"query"},{"required":false,"schema":{"type":"string","title":"Language"},"name":"language","in":"query"},{"required":false,"schema":{"type":"string","title":"Timezone"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"number","title":"Latitude"},"name":"latitude","in":"query"},{"required":false,"schema":{"type":"number","title":"Longitude"},"name":"longitude","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/horoscope/all-monthly":{"get":{"tags":["Horoscope"],"summary":"Get All Monthly Horoscopes","description":"Get monthly horoscopes for all zodiac signs.\n\nArgs:\n date: Start date of the month (YYYY-MM-DD format)","operationId":"get_all_monthly_horoscopes_api_v1_horoscope_all_monthly_get","parameters":[{"required":true,"schema":{"type":"string","format":"date","title":"Date"},"name":"date","in":"query"},{"required":false,"schema":{"type":"string","title":"Ayanamsa"},"name":"ayanamsa","in":"query"},{"required":false,"schema":{"type":"string","title":"Language"},"name":"language","in":"query"},{"required":false,"schema":{"type":"string","title":"Timezone"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"number","title":"Latitude"},"name":"latitude","in":"query"},{"required":false,"schema":{"type":"number","title":"Longitude"},"name":"longitude","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/geo/search":{"get":{"tags":["Geo"],"summary":"Search Places","description":"Search places by name. Returns {results: [...]} with coordinates + timezone.","operationId":"search_places_api_v1_geo_search_get","parameters":[{"required":true,"schema":{"type":"string","maxLength":120,"minLength":2,"title":"Q"},"name":"q","in":"query"},{"required":false,"schema":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Count","default":6},"name":"count","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/geo/reverse":{"get":{"tags":["Geo"],"summary":"Reverse Geocode","description":"Name the place at these coordinates.\n\nCoordinates are what IP and GPS give us; a reader cannot recognise\n`12.97°N 77.59°E` as their own city. Returns `{place: null}` rather than a\nguess when the lookup fails — the caller then prints the coordinates, which\nare at least honest.","operationId":"reverse_geocode_api_v1_geo_reverse_get","parameters":[{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/geo/timezone":{"get":{"tags":["Geo"],"summary":"Lookup Timezone","description":"Resolve IANA timezone from birth-place coordinates.","operationId":"lookup_timezone_api_v1_geo_timezone_get","parameters":[{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"required":false,"schema":{"type":"string","maxLength":8,"title":"Country Code"},"name":"country_code","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/panchang/positions":{"get":{"tags":["Panchang"],"summary":"Planet Positions","description":"Planetary positions (graha + Ascendant) at sunrise for a date/location.\n\nReuses the same chart computation as /kundali/birth-chart (so it stays\nconsistent with the app's charts) but is public, like the rest of panchang.\nReturns sign / longitude / nakshatra / pada per body; names are resolved\nclient-side. Degrades to an empty list on any CALCULATION failure -- bad input\nis rejected with a 400 instead, see below.","operationId":"planet_positions_api_v1_panchang_positions_get","parameters":[{"description":"YYYY-MM-DD","required":true,"schema":{"type":"string","title":"Date","description":"YYYY-MM-DD"},"name":"date","in":"query"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/panchang/calculate":{"post":{"tags":["Panchang"],"summary":"Calculate Panchang","description":"Calculate detailed Panchang (daily astrological information) for a given date and location.\n \n Panchang includes:\n - Tithi (Lunar day)\n - Nakshatra (Lunar mansion)\n - Yoga (Planetary combination)\n - Karana (Half of a Tithi)\n - Sunrise and Sunset times\n - Moonrise and Moonset times\n - Rahu Kaal\n - Gulika Kaal\n - Yamaganda Kaal\n - Abhijit Muhurat\n - Brahma Muhurat","operationId":"calculate_panchang_api_v1_panchang_calculate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangRequest"},"example":{"date":"2024-03-20","latitude":12.9716,"longitude":77.5946,"timezone":"Asia/Kolkata"}}},"required":true},"responses":{"200":{"description":"Detailed Panchang information for the specified date and location","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangResponse"}}}},"404":{"description":"Not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/panchang/location-based":{"post":{"tags":["Panchang"],"summary":"Calculate Location-based Panchang","description":"Calculate Panchang based on user's location (GPS or IP geolocation).\n \n This endpoint automatically detects the user's location based on their IP address\n or uses provided coordinates if IP geolocation is disabled.","operationId":"calculate_location_based_panchang_api_v1_panchang_location_based_post","parameters":[{"description":"Optional: Client IP for geolocation (X-Forwarded-For)","required":false,"schema":{"type":"string","title":"X-Forwarded-For","description":"Optional: Client IP for geolocation (X-Forwarded-For)"},"name":"x-forwarded-for","in":"header"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationBasedPanchangRequest"},"example":{"date":"2024-03-20","use_ip_geolocation":true}}},"required":true},"responses":{"200":{"description":"Panchang information based on user's location","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangResponse"}}}},"404":{"description":"Not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/panchang/auspicious-times":{"get":{"tags":["Panchang"],"summary":"Get Auspicious Times","description":"Get auspicious time periods for a given date.\n \n Auspicious times include:\n - Abhijit Muhurat\n - Brahma Muhurat\n - Amrit Kaal\n - Vijaya Muhurat\n - Godhuli Muhurat","operationId":"get_auspicious_times_api_v1_panchang_auspicious_times_get","parameters":[{"description":"Date in YYYY-MM-DD format","required":true,"schema":{"type":"string","title":"Date","description":"Date in YYYY-MM-DD format"},"example":"2024-03-20","name":"date","in":"query"},{"description":"Location latitude (-90 to 90)","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude (-90 to 90)"},"example":12.9716,"name":"latitude","in":"query"},{"description":"Location longitude (-180 to 180)","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude (-180 to 180)"},"example":77.5946,"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude"},"example":"Asia/Kolkata","name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"List of auspicious time periods with their significance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuspiciousTimesResponse"}}}},"404":{"description":"Not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/panchang/inauspicious-times":{"get":{"tags":["Panchang"],"summary":"Get Inauspicious Times","description":"Get inauspicious time periods for a given date.\n \n Inauspicious times include:\n - Rahu Kaal\n - Gulika Kaal\n - Yamaganda Kaal\n - Varjyam\n - Bhadra","operationId":"get_inauspicious_times_api_v1_panchang_inauspicious_times_get","parameters":[{"description":"Date in YYYY-MM-DD format","required":true,"schema":{"type":"string","title":"Date","description":"Date in YYYY-MM-DD format"},"example":"2024-03-20","name":"date","in":"query"},{"description":"Location latitude (-90 to 90)","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude (-90 to 90)"},"example":12.9716,"name":"latitude","in":"query"},{"description":"Location longitude (-180 to 180)","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude (-180 to 180)"},"example":77.5946,"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude"},"example":"Asia/Kolkata","name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"List of inauspicious time periods with their significance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InauspiciousTimesResponse"}}}},"404":{"description":"Not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/panchang/range":{"get":{"tags":["Panchang"],"summary":"Panchang range (compact daily summaries)","description":"Compute compact panchang summaries + festival overlay for every day in\n [start, end] inclusive.\n\n Designed for the calendar surfaces in the Aaj ka Panchang sheet — Week,\n Month, and Year tabs — where a full panchang per cell would be overkill.\n\n Implementation notes:\n • Uses `panchang.get_batch_panchang(...)`, which computes a full Panchang\n per day. `bulk_mode` used to select a \"precomputed\" path that this note\n claimed was materially faster; it called `get_panchang` for every day\n regardless and then replaced the five limbs with values read at local\n midnight rather than at sunrise, so it cost more and disagreed with the\n single-day endpoint. The flag is now inert.\n • Festival names come from the curated Amanta `festivals_for` engine,\n named lunar observances, and (when `system=` is set) regional festivals.\n • Each summary names the limb reading at that day's sunrise, which is the\n first of two or three on most days. `include_spans=true` adds a `spans`\n object with the full list for all four limbs — already computed for every\n day here, so it costs nothing but the bytes.\n\n Limits:\n • The inclusive range is capped at 400 days; exceeding this returns 400.\n • Latitude/longitude are required (no IP geolocation here — callers\n should pass the observer's stored location).","operationId":"panchang_range_api_v1_panchang_range_get","parameters":[{"description":"Start date YYYY-MM-DD (inclusive)","required":true,"schema":{"type":"string","title":"Start","description":"Start date YYYY-MM-DD (inclusive)"},"name":"start","in":"query"},{"description":"End date YYYY-MM-DD (inclusive)","required":true,"schema":{"type":"string","title":"End","description":"End date YYYY-MM-DD (inclusive)"},"name":"end","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude"},"name":"timezone","in":"query"},{"description":"Regional calendar system to frame each day in: vikram, saka, gujarati, marathi, kannada, telugu, tamil, malayalam, bengali, odia, sindhi. When set, each summary also carries era_year, masa/solar month and paksha.","required":false,"schema":{"type":"string","title":"System","description":"Regional calendar system to frame each day in: vikram, saka, gujarati, marathi, kannada, telugu, tamil, malayalam, bengali, odia, sindhi. When set, each summary also carries era_year, masa/solar month and paksha."},"name":"system","in":"query"},{"description":"Optional lunar framing override: amanta or purnimanta.","required":false,"schema":{"type":"string","title":"Lunar Month System","description":"Optional lunar framing override: amanta or purnimanta."},"name":"lunar_month_system","in":"query"},{"description":"Publish every span of all four limbs per day, as `spans`, instead of only the sunrise reading in `tithi_name` and friends. Off by default because the four lists are about 1.1 kB against a 578-byte summary, and the calendar grids this endpoint feeds want the day's first reading and nothing else.","required":false,"schema":{"type":"boolean","title":"Include Spans","description":"Publish every span of all four limbs per day, as `spans`, instead of only the sunrise reading in `tithi_name` and friends. Off by default because the four lists are about 1.1 kB against a 578-byte summary, and the calendar grids this endpoint feeds want the day's first reading and nothing else.","default":false},"name":"include_spans","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"List of compact daily panchang summaries with festivals","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/panchang/calendar-systems":{"get":{"tags":["Panchang"],"summary":"List supported regional calendar systems","description":"Static metadata for the supported regional Hindu calendar systems that can frame the /range calendar surfaces (era, reckoning, month-start, new-year).","operationId":"calendar_systems_metadata_api_v1_panchang_calendar_systems_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/panchang/export/calendar":{"get":{"tags":["Panchang"],"summary":"Export Panchang as an importable calendar file","description":"Export Panchang events for a date range as iCalendar (`ics`), Google\n Calendar-compatible `csv`, or structured `json`.\n\n The comma-separated `details` parameter controls how much is included:\n `solar`, `panchang`, `observances`, `auspicious`, and `inauspicious`.\n Calendar clients can import the resulting ICS or CSV file directly.","operationId":"export_panchang_calendar_api_v1_panchang_export_calendar_get","parameters":[{"description":"Start date YYYY-MM-DD (inclusive)","required":true,"schema":{"type":"string","title":"Start Date","description":"Start date YYYY-MM-DD (inclusive)"},"name":"start_date","in":"query"},{"description":"End date YYYY-MM-DD (inclusive)","required":true,"schema":{"type":"string","title":"End Date","description":"End date YYYY-MM-DD (inclusive)"},"name":"end_date","in":"query"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude"},"name":"timezone","in":"query"},{"description":"ics, csv, or json","required":false,"schema":{"type":"string","title":"Format","description":"ics, csv, or json","default":"ics"},"name":"format","in":"query"},{"description":"Comma-separated detail categories","required":false,"schema":{"type":"string","title":"Details","description":"Comma-separated detail categories","default":"solar,panchang,observances"},"name":"details","in":"query"},{"description":"Optional regional calendar system used to name observances","required":false,"schema":{"type":"string","title":"System","description":"Optional regional calendar system used to name observances"},"name":"system","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/panchang/export/pdf":{"get":{"tags":["Panchang"],"summary":"Export Panchang Calendar as PDF","description":"Export Panchang calendar as a PDF file. Supports table and month grid styles.","operationId":"export_panchang_pdf_api_v1_panchang_export_pdf_get","parameters":[{"description":"Start date in YYYY-MM-DD format","required":true,"schema":{"type":"string","title":"Start Date","description":"Start date in YYYY-MM-DD format"},"name":"start_date","in":"query"},{"description":"End date in YYYY-MM-DD format","required":true,"schema":{"type":"string","title":"End Date","description":"End date in YYYY-MM-DD format"},"name":"end_date","in":"query"},{"description":"Location latitude (-90 to 90)","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude (-90 to 90)"},"name":"latitude","in":"query"},{"description":"Location longitude (-180 to 180)","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude (-180 to 180)"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude"},"name":"timezone","in":"query"},{"description":"PDF style: 'table' or 'month_grid'","required":false,"schema":{"type":"string","title":"Style","description":"PDF style: 'table' or 'month_grid'","default":"table"},"name":"style","in":"query"},{"description":"Regional calendar system (optional)","required":false,"schema":{"type":"string","title":"Regional Calendar","description":"Regional calendar system (optional)"},"name":"regional_calendar","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"PDF Panchang calendar file","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Internal server error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/kundali/birth-chart":{"post":{"tags":["Kundali"],"summary":"Calculate Birth Chart","description":"Calculate birth chart based on date, time and location.\n\n**FREE tier** - Tracks usage against daily limits.","operationId":"calculate_birth_chart_api_v1_kundali_birth_chart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthChartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthChartResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kundali/compatibility":{"post":{"tags":["Kundali"],"summary":"Calculate Compatibility","description":"Calculate compatibility between two birth charts.","operationId":"calculate_compatibility_api_v1_kundali_compatibility_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatibilityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatibilityResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kundali/divisional-charts":{"post":{"tags":["Kundali"],"summary":"Calculate Divisional Charts","description":"Calculate divisional charts (Varga charts) for given birth details.\n\nDivisional charts provide deeper insights into specific life areas:\n\n**Phase 1 Charts (Implemented):**\n- **D1 (Rashi)**: Birth chart, physical body, overall life\n- **D2 (Hora)**: Wealth and finances\n- **D3 (Drekkana)**: Siblings, courage, co-borns\n- **D7 (Saptamsa)**: Children and progeny\n- **D9 (Navamsa)**: Spouse, dharma, inner self (most important after D1)\n- **D10 (Dasamsa)**: Career, profession, public status\n- **D12 (Dwadasamsa)**: Parents and ancestors\n\n**Additional Charts:**\n- D4 (Chaturthamsa): Fortune, fixed assets\n- D16 (Shodasamsa): Vehicles, comforts\n- D20 (Vimsamsa): Spiritual progress\n- D24 (Siddhamsa): Education, learning\n- D27 (Bhamsa): Physical strength\n- D30 (Trimsamsa): Misfortunes (for females)\n- D40 (Khavedamsa): Matrilineal karma\n- D45 (Akshavedamsa): Patrilineal karma\n- D60 (Shashtiamsa): Past life karma (most detailed)\n\n**Response includes:**\n- Planetary positions in each requested divisional chart\n- Vargottama planets (same sign in D1 and D9)\n- Pushkara Navamsa planets (auspicious D9 positions)\n- Dignity analysis in each chart\n- Overall strength assessment across vargas\n- Special combinations and interpretations\n\n**Request Parameters:**\n- `birth_details`: Date, time, location for calculation\n- `chart_types`: List of charts to calculate (default: [\"D9\", \"D10\"])\n- `include_all_charts`: Set to true to calculate all available charts","operationId":"calculate_divisional_charts_api_v1_kundali_divisional_charts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DivisionalChartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DivisionalChartsResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kundali/ashtakavarga":{"post":{"tags":["Kundali"],"summary":"Calculate Ashtakavarga","description":"Calculate Ashtakavarga for a birth chart.\n\nAshtakavarga is a powerful predictive technique that calculates benefic\npoints (bindus) for each planet in each sign. It consists of:\n\n- **Bhinnashtakavarga (BAV)**: Individual bindu chart for each planet,\n showing how many benefic points (0-8) each sign has for that planet.\n\n- **Sarvashtakavarga (SAV)**: Combined total of all BAV charts,\n showing the overall strength of each sign (typically 25-35 bindus).\n\nUses:\n- Transit predictions: Planets transiting signs with more bindus give better results\n- Identifying strong/weak areas in the chart\n- Timing of events during planetary periods\n\nInterpretation thresholds:\n- Signs with 28+ SAV bindus are considered strong (favorable)\n- Signs with less than 25 SAV bindus are considered weak (challenging)\n- Planet with 4+ bindus in a sign is well-placed\n- Planet with less than 3 bindus is poorly placed","operationId":"calculate_ashtakavarga_api_v1_kundali_ashtakavarga_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__kundali__AshtakavargaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__kundali__AshtakavargaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kundali/shadbala":{"post":{"tags":["Kundali"],"summary":"Calculate Shadbala","description":"Calculate Shadbala (Six-fold Strength) for all planets.\n\nShadbala is a comprehensive system for calculating planetary strength\nbased on six main factors:\n\n**1. Sthana Bala (Positional Strength)**\n- Uchcha Bala: Exaltation/debilitation strength\n- Saptavargaja Bala: Strength in divisional charts\n- Ojayugmarasyamsa Bala: Odd/even sign strength\n- Kendradi Bala: Angular house strength (Kendra > Panapara > Apoklima)\n- Drekkana Bala: Decanate strength\n\n**2. Dig Bala (Directional Strength)**\n- Sun/Mars strong in 10th (South)\n- Moon/Venus strong in 4th (North)\n- Mercury/Jupiter strong in 1st (East)\n- Saturn strong in 7th (West)\n\n**3. Kala Bala (Temporal Strength)**\n- Natonnata: Day/Night strength\n- Paksha: Lunar phase strength\n- Tribhaga: Day/Night third strength\n- Vara/Hora: Weekday and hour lord strength\n- Ayana: Declination strength\n\n**4. Chesta Bala (Motional Strength)**\n- Based on planetary motion (retrograde = strongest)\n\n**5. Naisargika Bala (Natural Strength)**\n- Inherent strength: Sun > Moon > Venus > Jupiter > Mercury > Mars > Saturn\n\n**6. Drik Bala (Aspectual Strength)**\n- Benefic aspects add, malefic aspects subtract\n\n**Interpretation:**\nEach planet has a minimum required Shadbala:\n- Sun: 5 Rupas (300 Shashtiamsas)\n- Moon: 6 Rupas (360 Shashtiamsas)\n- Mars: 5 Rupas (300 Shashtiamsas)\n- Mercury: 7 Rupas (420 Shashtiamsas)\n- Jupiter: 6.5 Rupas (390 Shashtiamsas)\n- Venus: 5.5 Rupas (330 Shashtiamsas)\n- Saturn: 5 Rupas (300 Shashtiamsas)\n\nPlanets meeting their minimum give good results in their dasha/transits.","operationId":"calculate_shadbala_api_v1_kundali_shadbala_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__kundali__ShadbalaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__kundali__ShadbalaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kundali/prashna":{"post":{"tags":["Kundali"],"summary":"Calculate Prashna","description":"Calculate Prashna (Horary Astrology) chart analysis.\n\nPrashna is a branch of Vedic astrology that answers specific questions\nbased on the chart cast at the moment of asking. It's particularly useful\nwhen exact birth details are unknown.\n\n**Question Categories:**\n- `marriage`: Marriage, relationships, partnerships\n- `career`: Job, profession, business\n- `wealth`: Finances, money matters\n- `health`: Physical and mental health\n- `children`: Progeny, fertility\n- `education`: Studies, exams, knowledge\n- `travel`: Journeys, relocation\n- `litigation`: Legal matters, disputes\n- `property`: Real estate, land, vehicles\n- `lost_item`: Finding lost objects\n\n**Key Factors Analyzed:**\n1. **Prashna Lagna**: The ascendant at question time indicates the nature of outcome\n2. **Moon Position**: Represents the mind of the querent and essence of question\n3. **Significator House**: The house related to the question category\n4. **Muhurta**: Current timing quality (auspicious/inauspicious)\n5. **Prashna Yogas**: Special combinations indicating success or obstacles\n\n**Answer Types:**\n- `Favorable`: Positive indications, proceed with confidence\n- `Unfavorable`: Negative indications, reconsider or delay\n- `Mixed`: Uncertain outcome, success possible with effort\n\n**Special Analysis:**\nFor lost item questions, additional analysis includes likely direction,\ndistance, location type, and recovery probability.","operationId":"calculate_prashna_api_v1_kundali_prashna_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kundali/chart-style":{"post":{"tags":["Kundali"],"summary":"Generate Chart Style","description":"Generate birth chart in a specific regional style.\n\nVedic astrology charts can be displayed in different regional styles,\neach with its own layout and conventions:\n\n**North Indian Style (Diamond)**\n- Houses are FIXED in position (diamond shape)\n- Signs rotate based on ascendant\n- Ascendant (House 1) always at top center\n- Popular in: North India, Punjab, UP, MP, Rajasthan\n\n**South Indian Style (Square Grid)**\n- Signs are FIXED in position (Aries always top-left area)\n- Houses rotate based on ascendant\n- House 1 is where the ascendant sign is located\n- Popular in: Tamil Nadu, Karnataka, Kerala, Andhra Pradesh\n\n**East Indian Style (Bengali)**\n- Signs are FIXED (similar to South Indian)\n- Different grid arrangement with diagonal divisions\n- Popular in: Bengal, Odisha, Assam, Bihar\n\n**Request Options:**\n- `chart_style`: \"north_indian\", \"south_indian\", \"east_indian\"\n- `language`: \"english\", \"sanskrit\", \"hindi\" for labels\n- `color_scheme`: \"traditional\", \"modern\", \"dark\"\n- `include_aspects`: Include planetary aspects in data\n- `include_nakshatras`: Include nakshatra info in cells\n\n**Response:**\nReturns complete layout data including:\n- Cell grid with house/sign assignments\n- Planet positions in each cell\n- Rendering hints for frontend display\n- Color scheme values","operationId":"generate_chart_style_api_v1_kundali_chart_style_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartStyleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartStyleResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kundali/chart-styles":{"post":{"tags":["Kundali"],"summary":"Generate Multi Style Charts","description":"Generate birth chart in multiple regional styles simultaneously.\n\nThis endpoint calculates the birth chart once and returns layout data\nformatted for multiple regional styles. Useful for:\n- Displaying charts side-by-side for comparison\n- Users who want to see their chart in different formats\n- Educational purposes showing the same data in different traditions\n\n**Request:**\n- `styles`: List of styles to generate (e.g., [\"south_indian\", \"north_indian\"])\n- `language`: Language for labels\n- `include_divisional`: Whether to include divisional charts\n- `divisional_charts`: Which divisional charts to include (if enabled)\n\n**Response:**\nReturns a dictionary mapping each requested style to its layout data,\nplus common planetary data that applies to all styles.\n\n**Example Use Cases:**\n1. Compare how a chart looks in South vs North Indian style\n2. Generate printable charts in preferred regional format\n3. Learn differences between chart traditions","operationId":"generate_multi_style_charts_api_v1_kundali_chart_styles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiStyleChartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiStyleChartResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kundali/sudarshana-inference":{"post":{"tags":["Kundali"],"summary":"Generate Sudarshana Inference","description":"Return an auditable three-reference Sudarshana synthesis.\n\nThe caller supplies an already-computed D1 layout, avoiding a duplicate\nephemeris calculation. The response ranks repeated house occupation and\ngraha drishti without making unsupported event or quality predictions.","operationId":"generate_sudarshana_inference_api_v1_kundali_sudarshana_inference_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SudarshanaInferenceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SudarshanaInferenceResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kundali/planet-positions":{"get":{"tags":["Kundali"],"summary":"Get Sidereal Planet Positions","description":"Lightweight sidereal (Vedic) positions of the nine grahas for a given\ninstant and place. Unmetered (rate-limited only) — meant for the astronomy\npositions report, so it does not consume the kundali usage quota.","operationId":"get_sidereal_planet_positions_api_v1_kundali_planet_positions_get","parameters":[{"description":"ISO datetime, e.g. 2026-06-01T12:00:00","required":true,"schema":{"type":"string","title":"When","description":"ISO datetime, e.g. 2026-06-01T12:00:00"},"name":"when","in":"query"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Sidereal ayanamsa (default Lahiri)","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa (default Lahiri)"},"name":"ayanamsa","in":"query"},{"description":"Rahu/Ketu node model: 'mean' (default) or 'true'","required":false,"schema":{"type":"string","title":"Node Type","description":"Rahu/Ketu node model: 'mean' (default) or 'true'"},"name":"node_type","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/kundali/yogas":{"post":{"tags":["Kundali"],"summary":"Calculate Yogas","description":"Calculate all Yogas (planetary combinations) in a birth chart.\n\nYogas are special planetary combinations that indicate specific life results.\nThey are one of the most important predictive tools in Vedic astrology.\n\n**Yoga Categories:**\n\n**1. Pancha Mahapurusha Yogas (5 Great Person Yogas)**\nFormed when Mars, Mercury, Jupiter, Venus, or Saturn is in own/exalted sign in Kendra:\n- `Ruchaka`: Mars - Courage, military, leadership\n- `Bhadra`: Mercury - Intelligence, business acumen\n- `Hamsa`: Jupiter - Wisdom, righteousness, teaching\n- `Malavya`: Venus - Beauty, arts, luxury\n- `Shasha`: Saturn - Authority, discipline, organization\n\n**2. Raj Yogas (Power/Authority Combinations)**\n- Kendra-Trikona connections\n- Dharma-Karmadhipati Yoga (9th-10th lords)\n- Gajakesari Yoga (Jupiter-Moon)\n- Budhaditya Yoga (Sun-Mercury)\n- Neechabhanga Raja Yoga\n\n**3. Dhana Yogas (Wealth Combinations)**\n- 2nd-11th lord connections\n- 5th-9th lord connections (Lakshmi Yoga)\n- Jupiter in wealth houses\n- Chandra-Mangal Yoga\n\n**4. Chandra Yogas (Moon-Based)**\n- Sunafa, Anafa, Durudhara (planets around Moon)\n- Kemadruma (isolated Moon) - challenging\n- Gajakesari (Jupiter in Kendra from Moon)\n\n**5. Nabhas Yogas (Pattern-Based)**\nBased on planetary distribution patterns\n\n**6. Special Yogas**\n- Kala Sarpa (all planets between Rahu-Ketu)\n- Guru Chandal (Jupiter with Rahu/Ketu)\n- Grahan Yoga (Sun/Moon with nodes)\n- Manglik Yoga (Mars in specific houses)\n- Saraswati Yoga (benefics in good houses)\n\n**7. Neechabhanga (Debilitation Cancellation)**\nAnalysis of whether debilitated planets have their weakness cancelled.\n\n**Request Options:**\n- `include_pancha_mahapurusha`: Include 5 great person yogas (default: true)\n- `include_raj_yogas`: Include power yogas (default: true)\n- `include_dhana_yogas`: Include wealth yogas (default: true)\n- `include_chandra_yogas`: Include Moon yogas (default: true)\n- `include_nabhas_yogas`: Include pattern yogas (default: true)\n- `include_special_yogas`: Include special combinations (default: true)\n- `include_neechabhanga`: Analyze debilitation cancellation (default: true)\n- `minimum_strength`: Filter yogas by minimum strength 0-100 (default: 0)\n\n**Response includes:**\n- Complete analysis of all yoga categories\n- Strength assessment for each yoga\n- Overall chart yoga strength\n- Life predictions based on yogas\n- Timing indications for yoga manifestation\n- Remedial suggestions","operationId":"calculate_yogas_api_v1_kundali_yogas_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YogaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/YogaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/muhurat/griha-pravesh":{"get":{"tags":["Muhurat"],"summary":"Classical Griha Pravesh / Bhoomi Pujan date finder","description":"Days in the window whose daylight holds an approved tithi, nakshatra and\nvara outside Rahu Kaal and Yamaganda, after the regional calendar vetoes --\nand, when a karta is named, their Tara and Chandra Bala (and the spouse's).","operationId":"griha_pravesh_dates_api_v1_muhurat_griha_pravesh_get","parameters":[{"description":"Window start (default: today)","required":false,"schema":{"type":"string","format":"date","title":"Start Date","description":"Window start (default: today)"},"name":"start_date","in":"query"},{"description":"Days to scan","required":false,"schema":{"type":"integer","maximum":120.0,"minimum":7.0,"title":"Days","description":"Days to scan","default":60},"name":"days","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Place latitude (required)","required":false,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Place latitude (required)"},"name":"latitude","in":"query"},{"description":"Place longitude","required":false,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Place longitude"},"name":"longitude","in":"query"},{"description":"Regional calendar system (vikram, tamil, telugu, ...)","required":false,"schema":{"type":"string","title":"System","description":"Regional calendar system (vikram, tamil, telugu, ...)"},"name":"system","in":"query"},{"description":"Kind of entry","required":false,"schema":{"type":"string","enum":["new","return","renovation"],"title":"Entry Type","description":"Kind of entry","default":"new"},"name":"entry_type","in":"query"},{"description":"griha_pravesh | bhoomi_pujan","required":false,"schema":{"type":"string","title":"Event","description":"griha_pravesh | bhoomi_pujan","default":"griha_pravesh"},"name":"event","in":"query"},{"description":"Deprecated; returns nothing extra","required":false,"schema":{"type":"boolean","title":"Include Marginal","description":"Deprecated; returns nothing extra","default":false},"name":"include_marginal","in":"query"},{"description":"Household of the karta (sign-in required)","required":false,"schema":{"type":"string","format":"uuid","title":"Household Id","description":"Household of the karta (sign-in required)"},"name":"household_id","in":"query"},{"description":"The karta: whose house it is","required":false,"schema":{"type":"string","format":"uuid","title":"Person Id","description":"The karta: whose house it is"},"name":"person_id","in":"query"},{"description":"Also check the karta's spouse","required":false,"schema":{"type":"boolean","title":"Include Spouse","description":"Also check the karta's spouse","default":true},"name":"include_spouse","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/muhurat/find":{"post":{"tags":["Muhurat"],"summary":"Find auspicious times for an event","description":"Find auspicious times for a specific event type on a given date.\n\nThis endpoint calculates the most auspicious and inauspicious time periods for various types of events\nbased on astrological factors such as planetary positions, lunar phases, and other celestial influences.\n\nParameters:\n- date: The date for which to find Muhurat\n- latitude: Latitude of the location\n- longitude: Longitude of the location\n- timezone: Timezone of the location\n- event_type: Type of event (marriage, business, travel, etc.)\n- duration_hours: Duration of the event in hours\n\nReturns:\n- A list of auspicious and inauspicious time periods with their scores","operationId":"find_muhurat_api_v1_muhurat_find_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MuhuratRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MuhuratResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/muhurat/event-types":{"get":{"tags":["Muhurat"],"summary":"Get available event types","description":"Get a list of all available event types for Muhurat calculation.\n\nReturns:\n- A list of event types","operationId":"get_event_types_api_v1_muhurat_event_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get Event Types Api V1 Muhurat Event Types Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/vrat-calendar":{"get":{"tags":["Festivals"],"summary":"Get Vrat Calendar","description":"Get Vrat calendar for a specified date range.\n\nArgs:\n start_date: Start date for the calendar\n end_date: End date for the calendar\n latitude: Latitude of the location\n longitude: Longitude of the location\n timezone: Timezone of the location (default: UTC)\n current_user: Current authenticated user\n \nReturns:\n List of Vrat events for the specified date range","operationId":"get_vrat_calendar_api_v1_vrat_calendar_get","parameters":[{"description":"Start date for the calendar","required":true,"schema":{"type":"string","format":"date-time","title":"Start Date","description":"Start date for the calendar"},"name":"start_date","in":"query"},{"description":"End date for the calendar","required":true,"schema":{"type":"string","format":"date-time","title":"End Date","description":"End date for the calendar"},"name":"end_date","in":"query"},{"description":"Latitude of the location","required":true,"schema":{"type":"number","title":"Latitude","description":"Latitude of the location"},"name":"latitude","in":"query"},{"description":"Longitude of the location","required":true,"schema":{"type":"number","title":"Longitude","description":"Longitude of the location"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VratCalendarResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/vrat-today":{"get":{"tags":["Festivals"],"summary":"Get Vrat Today","description":"Get Vrat events for today.\n\nArgs:\n latitude: Latitude of the location\n longitude: Longitude of the location\n timezone: Timezone of the location (default: UTC)\n current_user: Current authenticated user\n \nReturns:\n Vrat event for today, if any","operationId":"get_vrat_today_api_v1_vrat_today_get","parameters":[{"description":"Latitude of the location","required":true,"schema":{"type":"number","title":"Latitude","description":"Latitude of the location"},"name":"latitude","in":"query"},{"description":"Longitude of the location","required":true,"schema":{"type":"number","title":"Longitude","description":"Longitude of the location"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VratEvent"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/vrat-week":{"get":{"tags":["Festivals"],"summary":"Get Vrat Week","description":"Get Vrat events for the current week.\n\nArgs:\n latitude: Latitude of the location\n longitude: Longitude of the location\n timezone: Timezone of the location (default: UTC)\n current_user: Current authenticated user\n \nReturns:\n List of Vrat events for the current week","operationId":"get_vrat_week_api_v1_vrat_week_get","parameters":[{"description":"Latitude of the location","required":true,"schema":{"type":"number","title":"Latitude","description":"Latitude of the location"},"name":"latitude","in":"query"},{"description":"Longitude of the location","required":true,"schema":{"type":"number","title":"Longitude","description":"Longitude of the location"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VratCalendarResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/vrat-month":{"get":{"tags":["Festivals"],"summary":"Get Vrat Month","description":"Get Vrat events for a specific month.\n\nArgs:\n month: Month (1-12)\n year: Year\n latitude: Latitude of the location\n longitude: Longitude of the location\n timezone: Timezone of the location (default: UTC)\n current_user: Current authenticated user\n \nReturns:\n List of Vrat events for the specified month","operationId":"get_vrat_month_api_v1_vrat_month_get","parameters":[{"description":"Month (1-12)","required":true,"schema":{"type":"integer","title":"Month","description":"Month (1-12)"},"name":"month","in":"query"},{"description":"Year","required":true,"schema":{"type":"integer","title":"Year","description":"Year"},"name":"year","in":"query"},{"description":"Latitude of the location","required":true,"schema":{"type":"number","title":"Latitude","description":"Latitude of the location"},"name":"latitude","in":"query"},{"description":"Longitude of the location","required":true,"schema":{"type":"number","title":"Longitude","description":"Longitude of the location"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VratCalendarResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/festival-feed/today":{"get":{"tags":["Festivals"],"summary":"Get Today Feed","description":"Generate user's personalized daily spiritual feed based on Tithi, festivals, Dasha, and Kundali.","operationId":"get_today_feed_api_v1_festival_feed_today_get","parameters":[{"description":"User ID","required":true,"schema":{"type":"integer","title":"User Id","description":"User ID"},"name":"user_id","in":"query"},{"description":"Location for Panchang calculations","required":false,"schema":{"type":"string","title":"Location","description":"Location for Panchang calculations"},"name":"location","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FestivalFeedResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/festival-feed/date/{feed_date}":{"get":{"tags":["Festivals"],"summary":"Get Date Feed","description":"Generate user's personalized spiritual feed for a specific date.","operationId":"get_date_feed_api_v1_festival_feed_date__feed_date__get","parameters":[{"required":true,"schema":{"type":"string","format":"date","title":"Feed Date"},"name":"feed_date","in":"path"},{"description":"User ID","required":true,"schema":{"type":"integer","title":"User Id","description":"User ID"},"name":"user_id","in":"query"},{"description":"Location for Panchang calculations","required":false,"schema":{"type":"string","title":"Location","description":"Location for Panchang calculations"},"name":"location","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FestivalFeedResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/festival-feed/week":{"get":{"tags":["Festivals"],"summary":"Get Week Feed","description":"Generate user's personalized spiritual feed for the next 7 days.","operationId":"get_week_feed_api_v1_festival_feed_week_get","parameters":[{"description":"User ID","required":true,"schema":{"type":"integer","title":"User Id","description":"User ID"},"name":"user_id","in":"query"},{"description":"Location for Panchang calculations","required":false,"schema":{"type":"string","title":"Location","description":"Location for Panchang calculations"},"name":"location","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FestivalFeedResponse"},"type":"array","title":"Response Get Week Feed Api V1 Festival Feed Week Get"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/festival-feed/month":{"get":{"tags":["Festivals"],"summary":"Get Month Feed","description":"Generate user's personalized spiritual feed for the current month.\nOptionally filter by specific festival.","operationId":"get_month_feed_api_v1_festival_feed_month_get","parameters":[{"description":"User ID","required":true,"schema":{"type":"integer","title":"User Id","description":"User ID"},"name":"user_id","in":"query"},{"description":"Location for Panchang calculations","required":false,"schema":{"type":"string","title":"Location","description":"Location for Panchang calculations"},"name":"location","in":"query"},{"description":"Filter by specific festival","required":false,"schema":{"type":"string","title":"Festival","description":"Filter by specific festival"},"name":"festival","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FestivalFeedResponse"},"type":"array","title":"Response Get Month Feed Api V1 Festival Feed Month Get"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/calendar/{region}":{"get":{"tags":["Festivals"],"summary":"Get Regional Calendar","description":"Get regional festival calendar for a specific region.\n\nReturns all festivals celebrated in the specified region for the given year.\n\nAvailable regions:\n- tamil_nadu, andhra_pradesh, telangana, karnataka, kerala\n- west_bengal, maharashtra, gujarat, punjab, odisha, assam\n- And more...\n\nExample: /regional-festivals/calendar/tamil_nadu?year=2025&language=tamil","operationId":"get_regional_calendar_api_v1_regional_festivals_calendar__region__get","parameters":[{"required":true,"schema":{"type":"string","title":"Region"},"name":"region","in":"path"},{"description":"Year (defaults to current year)","required":false,"schema":{"type":"integer","title":"Year","description":"Year (defaults to current year)"},"name":"year","in":"query"},{"description":"Start month","required":false,"schema":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Start Month","description":"Start month","default":1},"name":"start_month","in":"query"},{"description":"End month","required":false,"schema":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"End Month","description":"End month","default":12},"name":"end_month","in":"query"},{"description":"Include pan-Indian festivals","required":false,"schema":{"type":"boolean","title":"Include Pan Indian","description":"Include pan-Indian festivals","default":true},"name":"include_pan_indian","in":"query"},{"description":"Comma-separated types: harvest,religious,cultural","required":false,"schema":{"type":"string","title":"Festival Types","description":"Comma-separated types: harvest,religious,cultural"},"name":"festival_types","in":"query"},{"description":"Preferred language for names","required":false,"schema":{"type":"string","title":"Language","description":"Preferred language for names","default":"hindi"},"name":"language","in":"query"},{"description":"Place latitude (required: festival days follow the place)","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Place latitude (required: festival days follow the place)"},"name":"latitude","in":"query"},{"description":"Place longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Place longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Regional Calendar Api V1 Regional Festivals Calendar Region Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/festival/{festival_id}":{"get":{"tags":["Festivals"],"summary":"Get Festival Details","description":"Get detailed information about a specific festival.\n\nReturns comprehensive details including:\n- Description and mythology\n- Rituals and traditions\n- Special foods and attire\n- Regional variations\n- Dates for the specified year\n\nExample: /regional-festivals/festival/pongal?year=2025®ion=tamil_nadu","operationId":"get_festival_details_api_v1_regional_festivals_festival__festival_id__get","parameters":[{"required":true,"schema":{"type":"string","title":"Festival Id"},"name":"festival_id","in":"path"},{"description":"Year for date calculation","required":false,"schema":{"type":"integer","title":"Year","description":"Year for date calculation"},"name":"year","in":"query"},{"description":"Region for specific variation","required":false,"schema":{"type":"string","title":"Region","description":"Region for specific variation"},"name":"region","in":"query"},{"description":"Place latitude (required: festival days follow the place)","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Place latitude (required: festival days follow the place)"},"name":"latitude","in":"query"},{"description":"Place longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Place longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Festival Details Api V1 Regional Festivals Festival Festival Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/compare/{festival_id}":{"get":{"tags":["Festivals"],"summary":"Compare Festival Across Regions","description":"Compare how a festival is celebrated in different regions.\n\nShows the common elements and unique variations across regions.\n\nExample: /regional-festivals/compare/ugadi_telugu?regions=andhra_pradesh,karnataka,telangana","operationId":"compare_festival_across_regions_api_v1_regional_festivals_compare__festival_id__get","parameters":[{"required":true,"schema":{"type":"string","title":"Festival Id"},"name":"festival_id","in":"path"},{"description":"Comma-separated regions to compare","required":true,"schema":{"type":"string","title":"Regions","description":"Comma-separated regions to compare"},"name":"regions","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Compare Festival Across Regions Api V1 Regional Festivals Compare Festival Id Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/search":{"get":{"tags":["Festivals"],"summary":"Search Festivals","description":"Search for festivals by name or keywords.\n\nSearches festival names, descriptions, and tags.\n\nExample: /regional-festivals/search?query=harvest®ion=tamil_nadu","operationId":"search_festivals_api_v1_regional_festivals_search_get","parameters":[{"description":"Search query","required":true,"schema":{"type":"string","minLength":2,"title":"Query","description":"Search query"},"name":"query","in":"query"},{"description":"Filter by region","required":false,"schema":{"type":"string","title":"Region","description":"Filter by region"},"name":"region","in":"query"},{"description":"Filter by type","required":false,"schema":{"type":"string","title":"Festival Type","description":"Filter by type"},"name":"festival_type","in":"query"},{"description":"Year for dates","required":false,"schema":{"type":"integer","title":"Year","description":"Year for dates"},"name":"year","in":"query"},{"description":"Place latitude (required: festival days follow the place)","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Place latitude (required: festival days follow the place)"},"name":"latitude","in":"query"},{"description":"Place longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Place longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Search Festivals Api V1 Regional Festivals Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/upcoming/{region}":{"get":{"tags":["Festivals"],"summary":"Get Upcoming Festivals","description":"Get upcoming festivals for a region.\n\nReturns festivals happening within the specified number of days.\n\nExample: /regional-festivals/upcoming/kerala?days=60","operationId":"get_upcoming_festivals_api_v1_regional_festivals_upcoming__region__get","parameters":[{"required":true,"schema":{"type":"string","title":"Region"},"name":"region","in":"path"},{"description":"Days to look ahead","required":false,"schema":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Days","description":"Days to look ahead","default":30},"name":"days","in":"query"},{"description":"Include pan-Indian festivals","required":false,"schema":{"type":"boolean","title":"Include Pan Indian","description":"Include pan-Indian festivals","default":true},"name":"include_pan_indian","in":"query"},{"description":"Place latitude (required: festival days follow the place)","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Place latitude (required: festival days follow the place)"},"name":"latitude","in":"query"},{"description":"Place longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Place longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Upcoming Festivals Api V1 Regional Festivals Upcoming Region Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/summary/{region}":{"get":{"tags":["Festivals"],"summary":"Get Region Summary","description":"Get festival summary statistics for a region.\n\nProvides counts by type, month, and lists major/unique festivals.\n\nExample: /regional-festivals/summary/maharashtra","operationId":"get_region_summary_api_v1_regional_festivals_summary__region__get","parameters":[{"required":true,"schema":{"type":"string","title":"Region"},"name":"region","in":"path"},{"description":"Year for statistics","required":false,"schema":{"type":"integer","title":"Year","description":"Year for statistics"},"name":"year","in":"query"},{"description":"Place latitude (required: festival days follow the place)","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Place latitude (required: festival days follow the place)"},"name":"latitude","in":"query"},{"description":"Place longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Place longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Region Summary Api V1 Regional Festivals Summary Region Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/regions":{"get":{"tags":["Festivals"],"summary":"Get Available Regions","description":"Get list of all available regions.\n\nReturns all supported regions with their display names.","operationId":"get_available_regions_api_v1_regional_festivals_regions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Available Regions Api V1 Regional Festivals Regions Get"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/languages":{"get":{"tags":["Festivals"],"summary":"Get Available Languages","description":"Get list of all available languages.\n\nReturns all supported languages for festival names.","operationId":"get_available_languages_api_v1_regional_festivals_languages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Available Languages Api V1 Regional Festivals Languages Get"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/types":{"get":{"tags":["Festivals"],"summary":"Get Festival Types","description":"Get list of all festival types.\n\nReturns all festival types with descriptions.","operationId":"get_festival_types_api_v1_regional_festivals_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Festival Types Api V1 Regional Festivals Types Get"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/regional-festivals/month/{region}/{year}/{month}":{"get":{"tags":["Festivals"],"summary":"Get Festivals By Month","description":"Get all festivals for a specific month.\n\nExample: /regional-festivals/month/tamil_nadu/2025/1","operationId":"get_festivals_by_month_api_v1_regional_festivals_month__region___year___month__get","parameters":[{"required":true,"schema":{"type":"string","title":"Region"},"name":"region","in":"path"},{"required":true,"schema":{"type":"integer","maximum":9999.0,"minimum":1.0,"title":"Year"},"name":"year","in":"path"},{"required":true,"schema":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month"},"name":"month","in":"path"},{"description":"Place latitude (required: festival days follow the place)","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Place latitude (required: festival days follow the place)"},"name":"latitude","in":"query"},{"description":"Place longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Place longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Festivals By Month Api V1 Regional Festivals Month Region Year Month Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/festivals/catalog":{"get":{"tags":["Festivals"],"summary":"Get Festival Catalog","description":"Rule catalog metadata (counts by reckoning / system). Not year-bound.","operationId":"get_festival_catalog_api_v1_festivals_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/festivals/year/{year}":{"get":{"tags":["Festivals"],"summary":"Get Festivals For Year","description":"Complete festival list for a Gregorian year at a location.\n\nDates are computed from astronomical rules (any past/future year), not\nhardcoded tables. Pass `system` to include regional variants and local names.","operationId":"get_festivals_for_year_api_v1_festivals_year__year__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Year"},"name":"year","in":"path"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Calendar system: vikram, saka, gujarati, marathi, kannada, telugu, tamil, malayalam, bengali, odia, sindhi","required":false,"schema":{"type":"string","title":"System","description":"Calendar system: vikram, saka, gujarati, marathi, kannada, telugu, tamil, malayalam, bengali, odia, sindhi"},"name":"system","in":"query"},{"description":"Optional Region enum value","required":false,"schema":{"type":"string","title":"Region","description":"Optional Region enum value"},"name":"region","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/festivals/on/{day}":{"get":{"tags":["Festivals"],"summary":"Get Festivals On Day","description":"Festivals falling on a single civil date.","operationId":"get_festivals_on_day_api_v1_festivals_on__day__get","parameters":[{"required":true,"schema":{"type":"string","format":"date","title":"Day"},"name":"day","in":"path"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"string","title":"System"},"name":"system","in":"query"},{"required":false,"schema":{"type":"string","title":"Region"},"name":"region","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/festivals/name/{festival_id}":{"get":{"tags":["Festivals"],"summary":"Resolve Festival Across Years","description":"Resolve one catalog rule across a year range (max 50 years).","operationId":"resolve_festival_across_years_api_v1_festivals_name__festival_id__get","parameters":[{"required":true,"schema":{"type":"string","title":"Festival Id"},"name":"festival_id","in":"path"},{"required":true,"schema":{"type":"integer","maximum":2200.0,"minimum":1800.0,"title":"Start Year"},"name":"start_year","in":"query"},{"required":true,"schema":{"type":"integer","maximum":2200.0,"minimum":1800.0,"title":"End Year"},"name":"end_year","in":"query"},{"required":true,"schema":{"type":"number","title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","title":"Longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"string","title":"System"},"name":"system","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/remedies/comprehensive":{"post":{"tags":["Remedies"],"summary":"Get Comprehensive Remedies","description":"Get comprehensive Vedic remedies based on birth chart analysis.\n\nThis provides a complete remedy package including:\n- Gemstone recommendations (primary and alternatives)\n- Mantra prescriptions with counts and timings\n- Puja recommendations (home and temple)\n- Charity suggestions for each day\n- Fasting schedules\n- Yantra recommendations\n- Color therapy\n- Rudraksha prescriptions\n- Temple visit recommendations\n- Lifestyle and dietary modifications\n\nAll remedies are personalized based on:\n- Current running Dasha period\n- Planetary strengths and weaknesses\n- Specific life problems (if provided)\n\nArgs:\n request: Birth details and optional specific problems\n\nReturns:\n Complete remedy package with priority rankings","operationId":"get_comprehensive_remedies_api_v1_remedies_comprehensive_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemedyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComprehensiveRemedyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/remedies/quick":{"get":{"tags":["Remedies"],"summary":"Get Quick Remedies","description":"Get quick remedy suggestions for immediate implementation.\n\nReturns the most essential remedies that can be started today.\nUse /comprehensive for detailed remedy package.","operationId":"get_quick_remedies_api_v1_remedies_quick_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/remedies/gemstones":{"get":{"tags":["Remedies"],"summary":"Get Gemstone Recommendations","description":"Get gemstone recommendations based on birth chart.\n\nIncludes:\n- Primary gemstone recommendation\n- Alternative affordable options\n- Wearing instructions (day, time, finger, metal)\n- Activation mantra\n- Precautions and contraindications\n- Gemstones to avoid","operationId":"get_gemstone_recommendations_api_v1_remedies_gemstones_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/remedies/mantras":{"get":{"tags":["Remedies"],"summary":"Get Mantra Recommendations","description":"Get mantra recommendations based on birth chart.\n\nIncludes:\n- Primary mantra with text and meaning\n- Chanting counts (daily and for siddhi)\n- Best timing and days\n- Practice guidelines\n- Supporting mantras for weak planets","operationId":"get_mantra_recommendations_api_v1_remedies_mantras_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/remedies/fasting":{"get":{"tags":["Remedies"],"summary":"Get Fasting Recommendations","description":"Get fasting (Vrat) recommendations based on birth chart.\n\nIncludes:\n- Primary fasts for dasha lord\n- Ekadashi and other universal fasts\n- Foods allowed and prohibited\n- Duration and timings\n- Associated pujas and mantras","operationId":"get_fasting_recommendations_api_v1_remedies_fasting_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/remedies/charity":{"get":{"tags":["Remedies"],"summary":"Get Charity Recommendations","description":"Get charity (Dana) recommendations based on birth chart.\n\nIncludes:\n- Items to donate for each planet\n- Best days and times\n- Recommended recipients\n- Weekly and monthly charity schedule","operationId":"get_charity_recommendations_api_v1_remedies_charity_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/remedies/rudraksha":{"get":{"tags":["Remedies"],"summary":"Get Rudraksha Recommendations","description":"Get Rudraksha recommendations based on birth chart.\n\nIncludes:\n- Primary Rudraksha mukhi based on dasha\n- Wearing instructions\n- Activation mantra\n- Care instructions\n- Combination mala suggestions","operationId":"get_rudraksha_recommendations_api_v1_remedies_rudraksha_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/remedies/colors":{"get":{"tags":["Remedies"],"summary":"Get Color Recommendations","description":"Get color therapy recommendations based on birth chart.\n\nIncludes:\n- Colors to wear\n- Colors for home/office environment\n- Colors to avoid\n- Day-wise color recommendations","operationId":"get_color_recommendations_api_v1_remedies_colors_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/remedies/guide":{"get":{"tags":["Remedies"],"summary":"Get Remedies Guide","description":"Get comprehensive guide to Vedic remedies.","operationId":"get_remedies_guide_api_v1_remedies_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/remedies/planet-remedies/{planet}":{"get":{"tags":["Remedies"],"summary":"Get Planet Specific Remedies","description":"Get all remedies for a specific planet.\n\nArgs:\n planet: Planet name (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu)","operationId":"get_planet_specific_remedies_api_v1_remedies_planet_remedies__planet__get","parameters":[{"required":true,"schema":{"type":"string","title":"Planet"},"name":"planet","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/rituals/callback-requests":{"get":{"tags":["Remedies"],"summary":"List Purohit callback requests (admin)","operationId":"list_callback_requests_api_v1_rituals_callback_requests_get","parameters":[{"required":false,"schema":{"type":"string","title":"Status"},"name":"status","in":"query"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Page Size","default":50},"name":"page_size","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualCallbackListResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"post":{"tags":["Remedies"],"summary":"Request a Purohit callback","description":"Public lead capture — a Purohit/astrologer follows up to confirm\nmuhurta, place and vidhi. Works for guests; links the user when signed in.","operationId":"create_callback_request_api_v1_rituals_callback_requests_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualCallbackCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualCallbackResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/callback-requests/mine":{"get":{"tags":["Remedies"],"summary":"Purohit work queue — my assigned callbacks + unclaimed pool","operationId":"my_callback_requests_api_v1_rituals_callback_requests_mine_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/rituals/seva-templates":{"get":{"tags":["Remedies"],"summary":"List active Seva Toolkit templates (provider)","operationId":"list_provider_seva_templates_api_v1_rituals_seva_templates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SevaTemplateResponse"},"type":"array","title":"Response List Provider Seva Templates Api V1 Rituals Seva Templates Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/rituals/seva-templates/admin":{"get":{"tags":["Remedies"],"summary":"List all Seva Toolkit templates (admin)","operationId":"list_admin_seva_templates_api_v1_rituals_seva_templates_admin_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SevaTemplateResponse"},"type":"array","title":"Response List Admin Seva Templates Api V1 Rituals Seva Templates Admin Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/rituals/seva-templates/{ritual_id}":{"put":{"tags":["Remedies"],"summary":"Create or update a Seva Toolkit template (admin)","operationId":"update_seva_template_api_v1_rituals_seva_templates__ritual_id__put","parameters":[{"required":true,"schema":{"type":"string","title":"Ritual Id"},"name":"ritual_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SevaTemplateUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SevaTemplateResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/seva-templates/{ritual_id}/history":{"get":{"tags":["Remedies"],"summary":"List immutable Seva template publication history (admin)","operationId":"seva_template_history_api_v1_rituals_seva_templates__ritual_id__history_get","parameters":[{"required":true,"schema":{"type":"string","title":"Ritual Id"},"name":"ritual_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SevaTemplateRevisionResponse"},"type":"array","title":"Response Seva Template History Api V1 Rituals Seva Templates Ritual Id History Get"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/rituals/seva-templates/{ritual_id}/rollback/{version}":{"post":{"tags":["Remedies"],"summary":"Republish a previous Seva template revision (admin)","operationId":"rollback_seva_template_api_v1_rituals_seva_templates__ritual_id__rollback__version__post","parameters":[{"required":true,"schema":{"type":"string","title":"Ritual Id"},"name":"ritual_id","in":"path"},{"required":true,"schema":{"type":"integer","title":"Version"},"name":"version","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SevaTemplateResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/provider-clients":{"get":{"tags":["Remedies"],"summary":"Customer Book for my own completed and upcoming work","description":"Return only customers reached through work assigned to this provider.","operationId":"provider_clients_api_v1_rituals_provider_clients_get","parameters":[{"required":false,"schema":{"type":"string","maxLength":100,"title":"Q"},"name":"q","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProviderClientSummary"},"type":"array","title":"Response Provider Clients Api V1 Rituals Provider Clients Get"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/rituals/callback-requests/{request_id}/claim":{"post":{"tags":["Remedies"],"summary":"Claim an unassigned callback request","operationId":"claim_callback_request_api_v1_rituals_callback_requests__request_id__claim_post","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualCallbackResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/callback-requests/{request_id}/provider-status":{"patch":{"tags":["Remedies"],"summary":"Update status of my assigned callback (provider)","operationId":"provider_update_callback_api_v1_rituals_callback_requests__request_id__provider_status_patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualCallbackUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualCallbackResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/callback-requests/{request_id}/provider-work":{"get":{"tags":["Remedies"],"summary":"Get my private ritual preparation","operationId":"get_provider_callback_work_api_v1_rituals_callback_requests__request_id__provider_work_get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualProviderWorkResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"patch":{"tags":["Remedies"],"summary":"Autosave my private ritual preparation","operationId":"update_provider_callback_work_api_v1_rituals_callback_requests__request_id__provider_work_patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderWorkState"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualProviderWorkResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/callback-requests/{request_id}/seva-day":{"get":{"tags":["Remedies"],"summary":"Open the large-touch Seva Day workspace (provider)","operationId":"get_seva_day_api_v1_rituals_callback_requests__request_id__seva_day_get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SevaDayProviderResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"patch":{"tags":["Remedies"],"summary":"Update my Seva Day progress (provider)","operationId":"update_seva_day_api_v1_rituals_callback_requests__request_id__seva_day_patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SevaDayUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SevaDayProviderResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/callback-requests/{request_id}/family-tracking":{"post":{"tags":["Remedies"],"summary":"Create or replace a private family progress link","operationId":"create_family_tracking_api_v1_rituals_callback_requests__request_id__family_tracking_post","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FamilyTrackingTokenResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"},"delete":{"tags":["Remedies"],"summary":"Revoke the private family progress link","operationId":"revoke_family_tracking_api_v1_rituals_callback_requests__request_id__family_tracking_delete","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/family-progress/{token}":{"get":{"tags":["Remedies"],"summary":"View sanitized family Seva progress","operationId":"family_seva_progress_api_v1_rituals_family_progress__token__get","parameters":[{"required":true,"schema":{"type":"string","title":"Token"},"name":"token","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FamilySevaProgress"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/rituals/operations/providers":{"get":{"tags":["Remedies"],"summary":"List verified providers for Admin assignment","operationId":"operations_providers_api_v1_rituals_operations_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OperationsProvider"},"type":"array","title":"Response Operations Providers Api V1 Rituals Operations Providers Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/rituals/callback-requests/{request_id}/assignment":{"put":{"tags":["Remedies"],"summary":"Assign or reassign a Seva (admin)","operationId":"assign_seva_api_v1_rituals_callback_requests__request_id__assignment_put","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SevaAssignmentUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualCallbackResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/callback-requests/{request_id}/seva-day/admin":{"patch":{"tags":["Remedies"],"summary":"Correct or advance Seva Day progress (admin)","operationId":"admin_update_seva_day_api_v1_rituals_callback_requests__request_id__seva_day_admin_patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SevaDayUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SevaDayProviderResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/rituals/callback-requests/{request_id}":{"patch":{"tags":["Remedies"],"summary":"Update a Purohit callback request (admin)","operationId":"update_callback_request_api_v1_rituals_callback_requests__request_id__patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"},"name":"request_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualCallbackUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RitualCallbackResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/shraddha/traditions":{"get":{"tags":["Shraddha Service"],"summary":"Traditions","operationId":"traditions_api_v1_shraddha_traditions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/shraddha/preview":{"post":{"tags":["Shraddha Service"],"summary":"Preview Shraddha Plan","description":"Calculate a no-storage preview; dates remain explicitly provisional.","operationId":"preview_shraddha_plan_api_v1_shraddha_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaCalculationInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/shraddha/plans":{"get":{"tags":["Shraddha Service"],"summary":"List Shraddha Plans","operationId":"list_shraddha_plans_api_v1_shraddha_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ShraddhaPlanSummary"},"type":"array","title":"Response List Shraddha Plans Api V1 Shraddha Plans Get"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"},"post":{"tags":["Shraddha Service"],"summary":"Create Shraddha Plan","operationId":"create_shraddha_plan_api_v1_shraddha_plans_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaCalculationInput"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/shraddha/plans/{plan_id}":{"get":{"tags":["Shraddha Service"],"summary":"Get Shraddha Plan","operationId":"get_shraddha_plan_api_v1_shraddha_plans__plan_id__get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"patch":{"tags":["Shraddha Service"],"summary":"Update Shraddha Plan","operationId":"update_shraddha_plan_api_v1_shraddha_plans__plan_id__patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaPlanUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/shraddha/plans/{plan_id}/events/{event_id}":{"patch":{"tags":["Shraddha Service"],"summary":"Update Shraddha Event","operationId":"update_shraddha_event_api_v1_shraddha_plans__plan_id__events__event_id__patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"},"name":"event_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaEventUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaEventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/shraddha/plans/{plan_id}/events/{event_id}/verify":{"post":{"tags":["Shraddha Service"],"summary":"Verify Shraddha Event","operationId":"verify_shraddha_event_api_v1_shraddha_plans__plan_id__events__event_id__verify_post","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"},"name":"event_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaEventVerifyInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShraddhaEventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/shraddha/plans/{plan_id}/calendar.ics":{"get":{"tags":["Shraddha Service"],"summary":"Shraddha Calendar","operationId":"shraddha_calendar_api_v1_shraddha_plans__plan_id__calendar_ics_get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/samskaras/traditions":{"get":{"tags":["Life Samskaras"],"summary":"Traditions","operationId":"traditions_api_v1_samskaras_traditions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/samskaras/registry":{"get":{"tags":["Life Samskaras"],"summary":"Samskara Registry","operationId":"samskara_registry_api_v1_samskaras_registry_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/samskaras/preview":{"post":{"tags":["Life Samskaras"],"summary":"Preview Samskara Journey","description":"Build a no-storage family lifecycle preview.","operationId":"preview_samskara_journey_api_v1_samskaras_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraJourneyInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraJourneyPreview"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/samskaras/candidates":{"post":{"tags":["Life Samskaras"],"summary":"Samskara Candidates","description":"Rank planning windows using Panchanga and optional natal Moon context.","operationId":"samskara_candidates_api_v1_samskaras_candidates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraCandidateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraCandidateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/samskaras/plans":{"get":{"tags":["Life Samskaras"],"summary":"List Samskara Plans","operationId":"list_samskara_plans_api_v1_samskaras_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SamskaraPlanSummary"},"type":"array","title":"Response List Samskara Plans Api V1 Samskaras Plans Get"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"},"post":{"tags":["Life Samskaras"],"summary":"Create Samskara Plan","operationId":"create_samskara_plan_api_v1_samskaras_plans_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraJourneyInput"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/samskaras/plans/{plan_id}":{"get":{"tags":["Life Samskaras"],"summary":"Get Samskara Plan","operationId":"get_samskara_plan_api_v1_samskaras_plans__plan_id__get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"patch":{"tags":["Life Samskaras"],"summary":"Update Samskara Plan","operationId":"update_samskara_plan_api_v1_samskaras_plans__plan_id__patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraPlanUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/samskaras/plans/{plan_id}/events/{event_id}":{"patch":{"tags":["Life Samskaras"],"summary":"Update Samskara Event","operationId":"update_samskara_event_api_v1_samskaras_plans__plan_id__events__event_id__patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"},"name":"event_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraEventUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraEventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/samskaras/plans/{plan_id}/events/{event_id}/verify":{"post":{"tags":["Life Samskaras"],"summary":"Verify Samskara Event","operationId":"verify_samskara_event_api_v1_samskaras_plans__plan_id__events__event_id__verify_post","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"},"name":"event_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraEventVerifyInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamskaraEventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/samskaras/plans/{plan_id}/calendar.ics":{"get":{"tags":["Life Samskaras"],"summary":"Samskara Calendar","operationId":"samskara_calendar_api_v1_samskaras_plans__plan_id__calendar_ics_get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Plan Id"},"name":"plan_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/mantra/today":{"get":{"tags":["Remedies"],"summary":"Fetch Today Mantras","description":"Return personalized mantra recommendations based on Dasha, transit, and dosha.\n\nThe reader is the signed-in user. This used to take a `user_id` integer off\nthe query string and look it up in a cache key nothing ever wrote, so it\nanswered 404 for everybody; the birth details come from the caller's own\nprofile row now.\n\nReturns:\n MantraResponse: Personalized mantra recommendations for today","operationId":"fetch_today_mantras_api_v1_mantra_today_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MantraResponse"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/mantra/reminder/set":{"post":{"tags":["Remedies"],"summary":"Set Mantra Reminder Endpoint","description":"Set a reminder for mantra chanting.\n\nKeyed to the signed-in user: the reminder has to belong to the same person\n/mantra/today serves, and a caller-supplied id let anyone write anyone's.\n\nArgs:\n time: Time in HH:MM format\n chant_count: Number of times to chant\n\nReturns:\n dict: Confirmation message","operationId":"set_mantra_reminder_endpoint_api_v1_mantra_reminder_set_post","parameters":[{"required":true,"schema":{"type":"string","title":"Time"},"name":"time","in":"query"},{"required":true,"schema":{"type":"integer","title":"Chant Count"},"name":"chant_count","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/mantra/track/progress":{"get":{"tags":["Remedies"],"summary":"Track Mantra Progress Endpoint","description":"Track the signed-in user's mantra chanting progress and streaks.\n\nReturns:\n dict: Progress information","operationId":"track_mantra_progress_endpoint_api_v1_mantra_track_progress_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/mantra/learn/{planet}":{"get":{"tags":["Remedies"],"summary":"Learn Planet Mantras","description":"Get learning module for a specific planet's mantras.\n\nArgs:\n planet: The planet to learn about\n \nReturns:\n dict: Learning materials for the planet's mantras","operationId":"learn_planet_mantras_api_v1_mantra_learn__planet__get","parameters":[{"required":true,"schema":{"type":"string","title":"Planet"},"name":"planet","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/compatibility/match":{"post":{"tags":["Compatibility"],"summary":"Calculate Matching","description":"Calculate comprehensive Kundali matching for marriage compatibility.\n\nThis is the most detailed matching analysis including:\n\n**Ashta Koota (8-fold) Matching:**\n- Varna (1 point) - Spiritual compatibility\n- Vashya (2 points) - Mutual control/attraction\n- Tara (3 points) - Destiny compatibility\n- Yoni (4 points) - Physical compatibility\n- Graha Maitri (5 points) - Mental compatibility\n- Gana (6 points) - Temperament compatibility\n- Bhakoot (7 points) - Emotional/Financial compatibility\n- Nadi (8 points) - Health/Genetic compatibility\n\n**Additional Analysis:**\n- Manglik Dosha for both partners\n- Nadi Dosha with exception rules\n- Bhakoot Dosha analysis\n- Overall compatibility score and recommendation\n\n**Scoring:**\n- 28+ points (78%+): Excellent match\n- 25-27 points (69-77%): Very good match\n- 21-24 points (58-68%): Good match\n- 18-20 points (50-57%): Moderate match\n- Below 18 points: Below average/Poor\n\n**Required:**\n- Complete birth details for both bride and groom\n- Including date, time, and location","operationId":"calculate_matching_api_v1_compatibility_match_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchingRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchingResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/compatibility/quick-match":{"post":{"tags":["Compatibility"],"summary":"Quick Match","description":"Quick compatibility check using just nakshatra information.\n\nUse this when complete birth details aren't available.\nProvides a quick estimate based on:\n- Nakshatra of both partners\n- Pada (quarter) of nakshatra\n\n**Input:**\n- Nakshatra name or number (1-27) for both\n- Pada (1-4) for both\n\n**Output:**\n- Total Guna score out of 36\n- Summary of each koota\n- Quick verdict on compatibility\n\n**Note:** For accurate analysis, use the full /match endpoint\nwith complete birth details.","operationId":"quick_match_api_v1_compatibility_quick_match_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickMatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickMatchResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/compatibility/by-nakshatra":{"get":{"tags":["Compatibility"],"summary":"Match By Nakshatra","description":"Quick compatibility check via URL parameters.\n\n**Example:**\n`/compatibility/by-nakshatra?bride_nakshatra=Rohini&groom_nakshatra=Hasta&bride_pada=2&groom_pada=1`\n\nOr using numbers:\n`/compatibility/by-nakshatra?bride_nakshatra=4&groom_nakshatra=13`","operationId":"match_by_nakshatra_api_v1_compatibility_by_nakshatra_get","parameters":[{"description":"Bride's nakshatra name or number (1-27)","required":true,"schema":{"type":"string","title":"Bride Nakshatra","description":"Bride's nakshatra name or number (1-27)"},"name":"bride_nakshatra","in":"query"},{"description":"Groom's nakshatra name or number (1-27)","required":true,"schema":{"type":"string","title":"Groom Nakshatra","description":"Groom's nakshatra name or number (1-27)"},"name":"groom_nakshatra","in":"query"},{"description":"Bride's nakshatra pada","required":false,"schema":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Bride Pada","description":"Bride's nakshatra pada","default":1},"name":"bride_pada","in":"query"},{"description":"Groom's nakshatra pada","required":false,"schema":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Groom Pada","description":"Groom's nakshatra pada","default":1},"name":"groom_pada","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/compatibility/koota-reference":{"get":{"tags":["Compatibility"],"summary":"Get Koota Reference","description":"Get detailed reference information for all 8 Kootas.\n\nExplains what each Koota measures, how it's calculated,\nand why it's important for marriage compatibility.\n\n**The 8 Kootas (Ashta Koota):**\n1. Varna - Spiritual/ego compatibility\n2. Vashya - Mutual attraction/control\n3. Tara - Destiny compatibility\n4. Yoni - Physical compatibility\n5. Graha Maitri - Mental compatibility\n6. Gana - Temperament compatibility\n7. Bhakoot - Emotional/financial compatibility\n8. Nadi - Health/genetic compatibility","operationId":"get_koota_reference_api_v1_compatibility_koota_reference_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/compatibility/manglik-check":{"get":{"tags":["Compatibility"],"summary":"Check Manglik","description":"Quick Manglik Dosha check for a single person.\n\nChecks Mars placement from:\n- Ascendant (Lagna)\n- Moon\n- Venus\n\nMars in houses 1, 2, 4, 7, 8, or 12 from these references\ncreates Manglik Dosha.\n\n**Returns:**\n- Whether person is Manglik\n- Intensity level (None, Low, Moderate, High, Severe)\n- Cancellation rules that apply\n- Suggested remedies if Manglik\n\n**Important:** Both partners being Manglik cancels the dosha.","operationId":"check_manglik_api_v1_compatibility_manglik_check_get","parameters":[{"description":"Birth date and time","required":true,"schema":{"type":"string","format":"date-time","title":"Birth Datetime","description":"Birth date and time"},"name":"birth_datetime","in":"query"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Sidereal frame (default Lahiri). Mars's house is measured from the ascendant, which moves with the frame.","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal frame (default Lahiri). Mars's house is measured from the ascendant, which moves with the frame."},"name":"ayanamsa","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/compatibility/doshas":{"get":{"tags":["Compatibility"],"summary":"List Doshas","description":"Information about major doshas checked in matching.\n\nExplains:\n- Nadi Dosha\n- Bhakoot Dosha\n- Manglik Dosha\n- Gana Dosha\n\nIncluding effects, exception rules, and remedies.","operationId":"list_doshas_api_v1_compatibility_doshas_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/compatibility/nakshatra-compatibility-table":{"get":{"tags":["Compatibility"],"summary":"Get Nakshatra Table","description":"Get the complete nakshatra compatibility reference table.\n\nShows for each nakshatra:\n- Varna, Vashya, Yoni, Gana, Nadi values\n- Compatible nakshatras\n- Challenging matches","operationId":"get_nakshatra_table_api_v1_compatibility_nakshatra_compatibility_table_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/compatibility/guide":{"get":{"tags":["Compatibility"],"summary":"Compatibility Guide","description":"Complete guide to Vedic marriage compatibility (Kundali Milan).\n\nEducational endpoint explaining:\n- What is Kundali matching\n- How the 36-point system works\n- Importance of each koota\n- Common doshas and remedies\n- When to proceed despite low scores","operationId":"compatibility_guide_api_v1_compatibility_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Core Astrology","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/transit/calculate":{"post":{"tags":["Transit"],"summary":"Calculate Transit","description":"Calculate transit effects for a birth chart.\n\nThis endpoint calculates the effects of planetary transits on a birth chart,\nincluding daily, weekly, monthly, and yearly transits.\n\nArgs:\n request: TransitRequest containing birth details and transit parameters\n background_tasks: FastAPI background tasks\n \nReturns:\n TransitResponse containing transit effects and recommendations\n \nRaises:\n HTTPException: If the calculation fails or rate limit is exceeded","operationId":"calculate_transit_api_v1_transit_calculate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/transit/types":{"get":{"tags":["Transit"],"summary":"Get Transit Types","description":"Get available transit types.\n\nThis endpoint returns a list of available transit types that can be used\nfor transit calculations.\n\nReturns:\n List of available transit types\n \nRaises:\n HTTPException: If the request fails","operationId":"get_transit_types_api_v1_transit_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get Transit Types Api V1 Transit Types Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dasha/calculate":{"post":{"tags":["Dasha"],"summary":"Calculate Dasha","description":"Calculate planetary periods (dasha) for a birth chart.\n\nSupports multiple dasha systems:\n- **vimshottari**: 120-year Nakshatra-based system (default, most common)\n- **yogini**: 36-year system based on 8 Yoginis\n- **ashtottari**: 108-year system (when specific yogas present)\n- **kalachakra**: Wheel of Time system\n- **moola**: Root nakshatra based system","operationId":"calculate_dasha_api_v1_dasha_calculate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__dasha__DashaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__dasha__DashaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/interpret":{"post":{"tags":["Dasha"],"summary":"Interpret Vimshottari Dasha","description":"Return an auditable, person-specific Vimshottari interpretation.\n\nThe response identifies the active Maha/Antar/Pratyantar lords, places each\nlord in the native's whole-sign natal house, lists its ruled houses, and\nderives life themes from those placements. Other dasha systems are excluded\nuntil their calculation timelines complete external worked-chart validation.","operationId":"interpret_vimshottari_dasha_api_v1_dasha_interpret_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashaInterpretationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashaInterpretationResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/interpret/timeline":{"post":{"tags":["Dasha"],"summary":"Interpret Vimshottari Timeline","description":"Interpret each Vimshottari Maha/Antardasha in a requested date window.","operationId":"interpret_vimshottari_timeline_api_v1_dasha_interpret_timeline_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashaTimelineInterpretationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashaTimelineInterpretationResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/chara":{"post":{"tags":["Dasha"],"summary":"Calculate Chara Dasha","description":"Calculate Chara Dasha (Jaimini system).\n\nChara Dasha is the primary dasha system in Jaimini astrology:\n- Sign-based rather than planet-based\n- Uses Karakamsha (Navamsa of Atmakaraka) as reference\n- Duration varies based on sign lord's position\n- Excellent for timing major life events\n\nReturns:\n- Jaimini Karakas (7 significators)\n- Karakamsha sign\n- Sign-based periods with predictions\n- Current and upcoming periods","operationId":"calculate_chara_dasha_api_v1_dasha_chara_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedDashaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CharaDashaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/narayana":{"post":{"tags":["Dasha"],"summary":"Calculate Narayana Dasha","description":"Calculate Narayana Dasha (Material Prosperity).\n\nNarayana Dasha is a Jaimini system focused on:\n- Material life and worldly success\n- Uses Arudha Lagna (AL) as reference\n- Excellent for timing financial and career matters\n- Indicates periods of material gains/losses\n\nReturns:\n- Arudha Lagna calculation\n- Sign-based periods with prosperity levels\n- Material prosperity timeline","operationId":"calculate_narayana_dasha_api_v1_dasha_narayana_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedDashaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NarayanaDashaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/sudharshana":{"post":{"tags":["Dasha"],"summary":"Calculate Sudharshana Dasha","description":"Calculate Sudharshana Chakra Dasha (Three-fold Analysis).\n\nUnique system that analyzes each year from three perspectives:\n- **Lagna**: Physical matters, environment, health\n- **Sun**: Soul purpose, authority, father, career\n- **Moon**: Mind, emotions, mother, public image\n\nEach year, all three progress one sign forward, creating a\nthree-dimensional view of the year's influences.\n\nReturns:\n- Yearly breakdown with all three perspectives\n- Combined influence analysis\n- Overall quality rating for each year","operationId":"calculate_sudharshana_dasha_api_v1_dasha_sudharshana_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedDashaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SudharshanaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/compare":{"post":{"tags":["Dasha"],"summary":"Compare Dasha Systems","description":"Compare multiple dasha systems simultaneously.\n\nAnalyzes birth chart using multiple dasha systems and provides:\n- Current period in each system\n- Combined analysis and recommendations\n- Key upcoming periods across all systems\n- Cross-system timing guidance\n\nBest used for:\n- Important life decisions requiring multiple confirmations\n- Understanding different aspects of life timing\n- Professional astrological analysis","operationId":"compare_dasha_systems_api_v1_dasha_compare_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashaComparisonRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiDashaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/systems":{"get":{"tags":["Dasha"],"summary":"List Dasha Systems","description":"List all available dasha systems with descriptions.\n\nReturns detailed information about each supported dasha system\nincluding cycle duration, basis of calculation, and best use cases.","operationId":"list_dasha_systems_api_v1_dasha_systems_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dasha/current/{birth_date}":{"get":{"tags":["Dasha"],"summary":"Get Current Periods","description":"Get current dasha periods across all major systems.\n\nQuick endpoint to see what periods are active right now\nin each major dasha system.","operationId":"get_current_periods_api_v1_dasha_current__birth_date__get","parameters":[{"required":true,"schema":{"type":"string","format":"date-time","title":"Birth Date"},"name":"birth_date","in":"path"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"name":"birth_latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"name":"birth_longitude","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Birth Timezone","description":"Derived from the birth place's coordinates; a zone sent is replaced","example":"Asia/Kolkata"},"name":"birth_timezone","in":"query"},{"description":"Sidereal ayanamsa (default Lahiri)","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa (default Lahiri)"},"name":"ayanamsa","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/dosha/analyze":{"post":{"tags":["Dosha"],"summary":"Analyze All Doshas","description":"Perform comprehensive dosha analysis.\n\nAnalyzes all major doshas including:\n- **Grahan Dosha** - Eclipse affliction (Rahu/Ketu with Sun/Moon)\n- **Gandmool Dosha** - Birth in Gandanta nakshatras\n- **Pitra Dosha** - Ancestral karma affliction\n- **Kaal Sarp Dosha** - All planets between Rahu-Ketu\n- **Manglik Dosha** - Mars placement affliction\n- **Shani Dosha** - Saturn afflictions\n- **Kemdrum Dosha** - Moon without benefic support","operationId":"analyze_all_doshas_api_v1_dosha_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Analyze All Doshas Api V1 Dosha Analyze Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dosha/grahan":{"post":{"tags":["Dosha"],"summary":"Analyze Grahan Dosha","description":"Analyze Grahan Dosha (Eclipse affliction).\n\nGrahan Dosha occurs when:\n- Sun is conjunct with Rahu (Surya Grahan)\n- Sun is conjunct with Ketu\n- Moon is conjunct with Rahu (Chandra Grahan)\n- Moon is conjunct with Ketu\n\nThis dosha can cause obstacles related to the affected luminary.","operationId":"analyze_grahan_dosha_api_v1_dosha_grahan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dosha/gandmool":{"post":{"tags":["Dosha"],"summary":"Analyze Gandmool Dosha","description":"Analyze Gandmool Dosha.\n\nGandmool Dosha occurs when Moon is in Gandanta nakshatras:\n- Ashlesha (end of Cancer)\n- Magha (start of Leo)\n- Jyeshtha (end of Scorpio)\n- Mula (start of Sagittarius)\n- Revati (end of Pisces)\n- Ashwini (start of Aries)\n\nThese are junction points between water and fire signs.","operationId":"analyze_gandmool_dosha_api_v1_dosha_gandmool_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dosha/pitra":{"post":{"tags":["Dosha"],"summary":"Analyze Pitra Dosha","description":"Analyze Pitra Dosha (Ancestral karma).\n\nPitra Dosha is indicated by:\n- Sun conjunct Rahu or Ketu\n- Sun conjunct Saturn\n- Rahu in 9th house\n- Affliction to 9th house or its lord\n\nThis represents unresolved ancestral karma.","operationId":"analyze_pitra_dosha_api_v1_dosha_pitra_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dosha/kaal-sarp":{"post":{"tags":["Dosha"],"summary":"Analyze Kaal Sarp Dosha","description":"Analyze Kaal Sarp Dosha.\n\nKaal Sarp Dosha occurs when all seven planets\nare hemmed between Rahu and Ketu axis.\n\n**Types based on Rahu's position:**\n- Anant, Kulik, Vasuki, Shankhpal, Padma, Mahapadma\n- Takshak, Karkotak, Shankhchur, Ghatak, Vishdhar, Sheshnag","operationId":"analyze_kaal_sarp_dosha_api_v1_dosha_kaal_sarp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dosha/manglik":{"post":{"tags":["Dosha"],"summary":"Analyze Manglik Dosha","description":"Analyze Manglik (Kuja) Dosha.\n\nManglik Dosha occurs when Mars is in houses 1, 4, 7, 8, or 12\nfrom Lagna or Moon.\n\n**Cancellation factors:**\n- Mars in own sign (Aries, Scorpio)\n- Mars exalted (Capricorn)\n- Jupiter's aspect on Mars\n- Both partners being Manglik","operationId":"analyze_manglik_dosha_api_v1_dosha_manglik_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dosha/shani":{"post":{"tags":["Dosha"],"summary":"Analyze Shani Dosha","description":"Analyze Shani (Saturn) Dosha.\n\nSaturn afflictions include:\n- Saturn conjunct Moon (emotional challenges)\n- Saturn conjunct Sun (authority issues)\n- Saturn in debilitation or inimical signs\n- Saturn in 8th house","operationId":"analyze_shani_dosha_api_v1_dosha_shani_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dosha/kemdrum":{"post":{"tags":["Dosha"],"summary":"Analyze Kemdrum Dosha","description":"Analyze Kemdrum Dosha.\n\nKemdrum Dosha occurs when Moon has no benefic planets\nin the 2nd and 12th houses from it.\n\nThis can cause mental stress and financial fluctuations.\n\n**Cancellation factors:**\n- Jupiter's aspect on Moon\n- Moon in Kendra position\n- Venus or Jupiter in Kendra from Moon","operationId":"analyze_kemdrum_dosha_api_v1_dosha_kemdrum_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dosha/nadi":{"post":{"tags":["Dosha"],"summary":"Check Nadi Dosha","description":"Check Nadi Dosha for compatibility.\n\nNadi represents the constitutional type (Vata, Pitta, Kapha).\nSame Nadi between partners is considered inauspicious\nfor health and progeny.\n\nThis is one of the most important factors in Ashta Koota matching.","operationId":"check_nadi_dosha_api_v1_dosha_nadi_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatibilityDoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DoshaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dosha/types":{"get":{"tags":["Dosha"],"summary":"Get Dosha Types","description":"Get information about all dosha types.\n\nReturns descriptions and significance of each dosha.","operationId":"get_dosha_types_api_v1_dosha_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dosha/remedies/{dosha_type}":{"get":{"tags":["Dosha"],"summary":"Get Dosha Remedies","description":"Get detailed remedies for a specific dosha.\n\nReturns comprehensive remedial measures including mantras,\nrituals, donations, and lifestyle recommendations.","operationId":"get_dosha_remedies_api_v1_dosha_remedies__dosha_type__get","parameters":[{"required":true,"schema":{"type":"string","title":"Dosha Type"},"name":"dosha_type","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/moon-journal/entries":{"get":{"tags":["Moon Journal"],"summary":"Get journal entries","description":"Get the caller's journal entries, with the summaries over that window.","operationId":"get_entries_api_v1_moon_journal_entries_get","parameters":[{"description":"Defaults to 30 days ago","required":false,"schema":{"type":"string","format":"date-time","title":"Start Date","description":"Defaults to 30 days ago"},"name":"start_date","in":"query"},{"description":"Defaults to now","required":false,"schema":{"type":"string","format":"date-time","title":"End Date","description":"Defaults to now"},"name":"end_date","in":"query"},{"required":false,"schema":{"$ref":"#/components/schemas/MoonPhase"},"name":"moon_phase","in":"query"},{"required":false,"schema":{"$ref":"#/components/schemas/MoonSign"},"name":"moon_sign","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoonJournalHistoryResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"post":{"tags":["Moon Journal"],"summary":"Create a new journal entry","description":"Record a moon journal entry for a day, defaulting to today.","operationId":"create_entry_api_v1_moon_journal_entries_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoonJournalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoonJournalResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/moon-journal/entries/{entry_date}":{"get":{"tags":["Moon Journal"],"summary":"Get one day's entry","description":"Get the caller's entry for one day.\n\nA day they have not written on comes back as a blank entry for that date,\nalongside the day's prompt, affirmation and recommended rituals.","operationId":"get_entry_api_v1_moon_journal_entries__entry_date__get","parameters":[{"description":"The day the entry is for, YYYY-MM-DD","required":true,"schema":{"type":"string","format":"date","title":"Entry Date","description":"The day the entry is for, YYYY-MM-DD"},"name":"entry_date","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoonJournalResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"delete":{"tags":["Moon Journal"],"summary":"Delete one day's entry","description":"Delete the caller's journal entry for a day, leaving mood pings intact.","operationId":"delete_entry_api_v1_moon_journal_entries__entry_date__delete","parameters":[{"description":"The day the entry is for, YYYY-MM-DD","required":true,"schema":{"type":"string","format":"date","title":"Entry Date","description":"The day the entry is for, YYYY-MM-DD"},"name":"entry_date","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/moon-journal/prompts":{"get":{"tags":["Moon Journal"],"summary":"Get journal prompts","description":"Get the journal prompts for a moon sign. Five per sign.","operationId":"get_prompts_api_v1_moon_journal_prompts_get","parameters":[{"description":"Defaults to today's moon sign","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/MoonSign"}],"description":"Defaults to today's moon sign"},"name":"moon_sign","in":"query"},{"required":false,"schema":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":5},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/JournalPrompt"},"type":"array","title":"Response Get Prompts Api V1 Moon Journal Prompts Get"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/moon-journal/insights":{"get":{"tags":["Moon Journal"],"summary":"Get journal insights","description":"Get the insights the caller recorded in their entries, most recent first.","operationId":"get_insights_api_v1_moon_journal_insights_get","parameters":[{"description":"Defaults to 30 days ago","required":false,"schema":{"type":"string","format":"date-time","title":"Start Date","description":"Defaults to 30 days ago"},"name":"start_date","in":"query"},{"description":"Defaults to now","required":false,"schema":{"type":"string","format":"date-time","title":"End Date","description":"Defaults to now"},"name":"end_date","in":"query"},{"required":false,"schema":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":5},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/JournalInsight"},"type":"array","title":"Response Get Insights Api V1 Moon Journal Insights Get"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/moon-journal/stats":{"get":{"tags":["Moon Journal"],"summary":"Get journal statistics","description":"Get counts over the caller's entries in a window.","operationId":"get_stats_api_v1_moon_journal_stats_get","parameters":[{"description":"Defaults to 30 days ago","required":false,"schema":{"type":"string","format":"date-time","title":"Start Date","description":"Defaults to 30 days ago"},"name":"start_date","in":"query"},{"description":"Defaults to now","required":false,"schema":{"type":"string","format":"date-time","title":"End Date","description":"Defaults to now"},"name":"end_date","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JournalStats"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/reading/{text_id}":{"get":{"tags":["Library Reader"],"summary":"Get Text Reading Data","operationId":"get_text_reading_data_api_v1_reading__text_id__get","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextReadingPayload"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/reading/{text_id}/state":{"put":{"tags":["Library Reader"],"summary":"Put Reading State","operationId":"put_reading_state_api_v1_reading__text_id__state_put","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadingState"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadingState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/reading/{text_id}/bookmarks":{"get":{"tags":["Library Reader"],"summary":"List Bookmarks","operationId":"list_bookmarks_api_v1_reading__text_id__bookmarks_get","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Bookmark"},"type":"array","title":"Response List Bookmarks Api V1 Reading Text Id Bookmarks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"post":{"tags":["Library Reader"],"summary":"Add Bookmark","operationId":"add_bookmark_api_v1_reading__text_id__bookmarks_post","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookmarkCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bookmark"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/reading/{text_id}/bookmarks/{bookmark_id}":{"put":{"tags":["Library Reader"],"summary":"Update Bookmark","operationId":"update_bookmark_api_v1_reading__text_id__bookmarks__bookmark_id__put","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"required":true,"schema":{"type":"string","title":"Bookmark Id"},"name":"bookmark_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookmarkUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bookmark"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"},"delete":{"tags":["Library Reader"],"summary":"Delete Bookmark","operationId":"delete_bookmark_api_v1_reading__text_id__bookmarks__bookmark_id__delete","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"required":true,"schema":{"type":"string","title":"Bookmark Id"},"name":"bookmark_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/reading/{text_id}/highlights":{"get":{"tags":["Library Reader"],"summary":"List Highlights","operationId":"list_highlights_api_v1_reading__text_id__highlights_get","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Highlight"},"type":"array","title":"Response List Highlights Api V1 Reading Text Id Highlights Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"post":{"tags":["Library Reader"],"summary":"Add Highlight","operationId":"add_highlight_api_v1_reading__text_id__highlights_post","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HighlightCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Highlight"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/reading/{text_id}/highlights/{highlight_id}":{"put":{"tags":["Library Reader"],"summary":"Update Highlight","operationId":"update_highlight_api_v1_reading__text_id__highlights__highlight_id__put","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"required":true,"schema":{"type":"string","title":"Highlight Id"},"name":"highlight_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HighlightUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Highlight"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"},"delete":{"tags":["Library Reader"],"summary":"Delete Highlight","operationId":"delete_highlight_api_v1_reading__text_id__highlights__highlight_id__delete","parameters":[{"required":true,"schema":{"type":"string","title":"Text Id"},"name":"text_id","in":"path"},{"required":true,"schema":{"type":"string","title":"Highlight Id"},"name":"highlight_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/reading/":{"get":{"tags":["Library Reader"],"summary":"Library Summary","operationId":"library_summary_api_v1_reading__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/LibrarySummaryEntry"},"type":"array","title":"Response Library Summary Api V1 Reading Get"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/horoscope-preference":{"get":{"tags":["Horoscope Preference"],"summary":"Get Preference","description":"Return the user's daily-horoscope preference (creates a default row if absent).","operationId":"get_preference_api_v1_horoscope_preference_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreferenceOut"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"},"put":{"tags":["Horoscope Preference"],"summary":"Update Preference","description":"Partial update — only fields present in the body are written. The row is\nupserted: an absent row is created with sensible defaults and then\npatched. The send dispatcher reads `enabled`, `send_hour_local`,\n`timezone`, `channels`, and `last_sent_date`.","operationId":"update_preference_api_v1_horoscope_preference_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreferenceUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreferenceOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"},"delete":{"tags":["Horoscope Preference"],"summary":"Delete Preference","description":"Remove the user's preference entirely (effectively unsubscribing).","operationId":"delete_preference_api_v1_horoscope_preference_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/push/public-key":{"get":{"tags":["Web Push"],"summary":"Get Public Key","description":"Return the VAPID public key for the frontend's subscribe call.","operationId":"get_public_key_api_v1_push_public_key_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/push/subscribe":{"post":{"tags":["Web Push"],"summary":"Subscribe","description":"Store or refresh a push subscription. Idempotent — same endpoint URL is\nupserted with the latest keys + user binding.","operationId":"subscribe_api_v1_push_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushSubscriptionPayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Subscribe Api V1 Push Subscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/push/unsubscribe":{"post":{"tags":["Web Push"],"summary":"Unsubscribe","description":"Drop a subscription by endpoint URL (no auth — endpoint URL is the secret).","operationId":"unsubscribe_api_v1_push_unsubscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnsubscribePayload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/export/chart":{"post":{"tags":["Chart Export"],"summary":"Export Chart","description":"Export an astrological chart.\n\nGenerates chart in specified format (SVG, HTML).\n\nReturns:\n Chart file content with appropriate headers","operationId":"export_chart_api_v1_export_chart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartExportRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/export/chart/svg":{"post":{"tags":["Chart Export"],"summary":"Export Chart Svg","description":"Export chart as SVG (inline response).\n\nReturns SVG content directly for embedding.","operationId":"export_chart_svg_api_v1_export_chart_svg_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartExportRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/export/chart/base64":{"post":{"tags":["Chart Export"],"summary":"Export Chart Base64","description":"Export chart as base64-encoded string.\n\nUseful for embedding in JSON responses or emails.","operationId":"export_chart_base64_api_v1_export_chart_base64_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartExportRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/export/styles":{"get":{"tags":["Chart Export"],"summary":"Get Available Styles","description":"Get available chart styles.\n\nReturns list of supported chart visualization styles.","operationId":"get_available_styles_api_v1_export_styles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/export/formats":{"get":{"tags":["Chart Export"],"summary":"Get Available Formats","description":"Get available export formats.\n\nReturns list of supported export file formats.","operationId":"get_available_formats_api_v1_export_formats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/export/kundli-snapshot":{"post":{"tags":["Chart Export"],"summary":"Export Kundli Snapshot","operationId":"export_kundli_snapshot_api_v1_export_kundli_snapshot_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KundliSnapshotRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KundliSnapshotResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/export/life-blueprint":{"post":{"tags":["Chart Export"],"summary":"Export Life Blueprint","operationId":"export_life_blueprint_api_v1_export_life_blueprint_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KundliSnapshotRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KundliSnapshotResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/export/birth-report":{"post":{"tags":["Chart Export"],"summary":"Export Detailed Birth Report","operationId":"export_detailed_birth_report_api_v1_export_birth_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetailedBirthReportRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/export/consultation-summary":{"post":{"tags":["Chart Export"],"summary":"Export Consultation Summary","operationId":"export_consultation_summary_api_v1_export_consultation_summary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsultationSummaryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/export/kundli-match":{"post":{"tags":["Chart Export"],"summary":"Export Kundli Match","operationId":"export_kundli_match_api_v1_export_kundli_match_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchingReportRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KundliSnapshotResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/export/saved-reports":{"get":{"tags":["Chart Export"],"summary":"List Saved Reports","operationId":"list_saved_reports_api_v1_export_saved_reports_get","parameters":[{"required":false,"schema":{"type":"integer","minimum":0.0,"title":"Offset","default":0},"name":"offset","in":"query"},{"required":false,"schema":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Limit","default":20},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/export/saved-reports/{report_id}/download":{"get":{"tags":["Chart Export"],"summary":"Download Saved Report","operationId":"download_saved_report_api_v1_export_saved_reports__report_id__download_get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Report Id"},"name":"report_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/ashtakavarga/analyze":{"post":{"tags":["Advanced"],"summary":"Get Ashtakavarga Analysis","description":"Get complete Ashtakavarga analysis.\n\nCalculates:\n- Bhinnashtakavarga for all 7 planets (Sun to Saturn)\n- Sarvashtakavarga (combined strength chart)\n- House strength analysis\n- Current transit analysis\n- Upcoming transit predictions\n\nAshtakavarga is a unique Vedic system for determining planetary\nstrength by calculating benefic points (bindus) from 8 reference\npoints (Ascendant + 7 planets).","operationId":"get_ashtakavarga_analysis_api_v1_ashtakavarga_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__ashtakavarga__AshtakavargaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__ashtakavarga__AshtakavargaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/ashtakavarga/simple":{"get":{"tags":["Advanced"],"summary":"Get Simple Ashtakavarga","description":"Get simplified Ashtakavarga analysis using query parameters.","operationId":"get_simple_ashtakavarga_api_v1_ashtakavarga_simple_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/ashtakavarga/planet/{planet}":{"get":{"tags":["Advanced"],"summary":"Get Planet Ashtakavarga","description":"Get Bhinnashtakavarga for a specific planet.\n\nShows the detailed bindu contribution from each reference point\nand analysis for each sign.\n\nArgs:\n planet: Planet name (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn)","operationId":"get_planet_ashtakavarga_api_v1_ashtakavarga_planet__planet__get","parameters":[{"required":true,"schema":{"type":"string","title":"Planet"},"name":"planet","in":"path"},{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/ashtakavarga/transits":{"get":{"tags":["Advanced"],"summary":"Get Transit Ashtakavarga","description":"Get transit analysis using Ashtakavarga.\n\nAnalyzes current planetary transits based on their Ashtakavarga\nbindu counts in the transit signs.","operationId":"get_transit_ashtakavarga_api_v1_ashtakavarga_transits_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"description":"Transit date (YYYY-MM-DD)","required":false,"schema":{"type":"string","title":"Transit Date","description":"Transit date (YYYY-MM-DD)"},"name":"transit_date","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/ashtakavarga/transit-calendar":{"get":{"tags":["Advanced"],"summary":"Get Transit Calendar","description":"Ashtakavarga transit calendar for the slow grahas (Jupiter, Saturn, Rahu,\nKetu): real sidereal sign-ingress dates over the next `years`, each annotated\nwith the transited sign's bindus (the planet's own BAV + the SAV) and a quality\nverdict — the most-used Ashtakavarga timing tool.","operationId":"get_transit_calendar_api_v1_ashtakavarga_transit_calendar_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"description":"Calendar span in years","required":false,"schema":{"type":"number","maximum":10.0,"minimum":0.5,"title":"Years","description":"Calendar span in years","default":3.0},"name":"years","in":"query"},{"description":"Calendar start date (YYYY-MM-DD); defaults to today","required":false,"schema":{"type":"string","title":"Start","description":"Calendar start date (YYYY-MM-DD); defaults to today"},"name":"start","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/ashtakavarga/guide":{"get":{"tags":["Advanced"],"summary":"Get Ashtakavarga Guide","description":"Get guide to understanding Ashtakavarga.","operationId":"get_ashtakavarga_guide_api_v1_ashtakavarga_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/shadbala/dashboard":{"post":{"tags":["Advanced"],"summary":"Get Strength Dashboard","description":"Return Shadbala, Bhava Bala and all four Vimsopaka groups together.","operationId":"get_strength_dashboard_api_v1_shadbala_dashboard_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__shadbala__ShadbalaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrengthDashboardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/shadbala/analyze":{"post":{"tags":["Advanced"],"summary":"Get Shadbala Analysis","description":"Get complete Shadbala (Six-Fold Strength) analysis.\n\nCalculates all six types of planetary strength:\n- Sthana Bala (Positional Strength)\n- Dig Bala (Directional Strength)\n- Kala Bala (Temporal Strength)\n- Chesta Bala (Motional Strength)\n- Naisargika Bala (Natural Strength)\n- Drik Bala (Aspectual Strength)\n\nReturns comprehensive strength analysis for all seven planets with\ninterpretive safeguards for dignity, functional lordship and dasha context.","operationId":"get_shadbala_analysis_api_v1_shadbala_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__shadbala__ShadbalaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__schemas__shadbala__ShadbalaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/shadbala/simple":{"get":{"tags":["Advanced"],"summary":"Get Simple Shadbala","description":"Get simplified Shadbala analysis using query parameters.\n\nReturns a condensed view of planetary strengths suitable for\nquick reference and basic analysis.","operationId":"get_simple_shadbala_api_v1_shadbala_simple_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/shadbala/planet/{planet}":{"get":{"tags":["Advanced"],"summary":"Get Planet Shadbala","description":"Get detailed Shadbala for a specific planet.\n\nShows all six bala components with their individual values\nand detailed breakdown of each strength type.\n\nArgs:\n planet: Planet name (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn)","operationId":"get_planet_shadbala_api_v1_shadbala_planet__planet__get","parameters":[{"required":true,"schema":{"type":"string","title":"Planet"},"name":"planet","in":"path"},{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/shadbala/bhava-bala":{"get":{"tags":["Advanced"],"summary":"Get Bhava Bala","description":"Get Bhava Bala (house strength) analysis.\n\nAnalyzes the strength of all 12 houses based on:\n- Bhava Dig Bala (directional strength)\n- Bhava Drishti Bala (aspectual strength)\n- Bhava Adhipati Bala (lord's strength)","operationId":"get_bhava_bala_api_v1_shadbala_bhava_bala_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/shadbala/comparison":{"get":{"tags":["Advanced"],"summary":"Get Shadbala Comparison","description":"Get comparative Shadbala analysis for all planets.\n\nProvides a ranked comparison of planetary strengths,\nidentifying strong benefics, malefics, and overall balance.","operationId":"get_shadbala_comparison_api_v1_shadbala_comparison_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/shadbala/guide":{"get":{"tags":["Advanced"],"summary":"Get Shadbala Guide","description":"Get guide to understanding Shadbala.","operationId":"get_shadbala_guide_api_v1_shadbala_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/divisional-charts/calculate":{"post":{"tags":["Advanced"],"summary":"Calculate Divisional Charts","description":"Calculate specified divisional charts for a birth chart.\n\nCalculates planetary positions in the requested divisional charts.\nDefault calculates D9 (Navamsa) and D10 (Dasamsa).\n\n**Available Charts:**\n- D1 (Rashi), D2 (Hora), D3 (Drekkana), D4 (Chaturthamsa)\n- D7 (Saptamsa), D9 (Navamsa), D10 (Dasamsa), D12 (Dwadasamsa)\n- D16 (Shodasamsa), D20 (Vimsamsa), D24 (Siddhamsa), D27 (Bhamsa)\n- D30 (Trimshamsa), D40 (Khavedamsa), D45 (Akshavedamsa), D60 (Shashtiamsa)\n\n**Note:** Higher division charts (D40, D45, D60) require very precise\nbirth times. D60 requires birth time accurate to within 30 seconds.","operationId":"calculate_divisional_charts_api_v1_divisional_charts_calculate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DivisionalChartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DivisionalChartsResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/divisional-charts/calculate/{chart_type}":{"get":{"tags":["Advanced"],"summary":"Calculate Single Chart","description":"Calculate a single divisional chart.\n\nQuick endpoint for calculating one specific divisional chart.\n\n**Path Parameters:**\n- chart_type: D1, D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45, D60","operationId":"calculate_single_chart_api_v1_divisional_charts_calculate__chart_type__get","parameters":[{"required":true,"schema":{"type":"string","title":"Chart Type"},"name":"chart_type","in":"path"},{"description":"Birth date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Date","description":"Birth date (YYYY-MM-DD)"},"name":"date","in":"query"},{"description":"Birth time (HH:MM:SS)","required":true,"schema":{"type":"string","title":"Time","description":"Birth time (HH:MM:SS)"},"name":"time","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Birth latitude"},"name":"latitude","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Birth longitude"},"name":"longitude","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Derived from the birth place's coordinates; a zone sent is replaced","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/divisional-charts/shodasha-varga":{"get":{"tags":["Advanced"],"summary":"Calculate Shodasha Varga","description":"Calculate all 16 Shodasha Varga charts.\n\nReturns complete analysis of all 16 primary divisional charts.\n\n**Warning:** This is computationally intensive and higher division charts\n(D40, D45, D60) require very precise birth times.","operationId":"calculate_shodasha_varga_api_v1_divisional_charts_shodasha_varga_get","parameters":[{"description":"Birth date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Date","description":"Birth date (YYYY-MM-DD)"},"name":"date","in":"query"},{"description":"Birth time (HH:MM:SS)","required":true,"schema":{"type":"string","title":"Time","description":"Birth time (HH:MM:SS)"},"name":"time","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Birth latitude"},"name":"latitude","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Birth longitude"},"name":"longitude","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Derived from the birth place's coordinates; a zone sent is replaced","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/divisional-charts/varga-strength":{"get":{"tags":["Advanced"],"summary":"Calculate Varga Strength","description":"Calculate Vargottama and Varga strength for a planet.\n\nAnalyzes a planet's placement across multiple divisional charts to\ndetermine its overall strength (Vargaja Bala).\n\n**Key Concepts:**\n- **Vargottama**: Planet in same sign in D1 and D9 (very strong)\n- **Vargaja Bala**: Strength gained from favorable Varga placements\n\n**Strength Classifications:**\n- 2 Vargas favorable: Bhedaka\n- 3 Vargas favorable: Kusum\n- 4 Vargas favorable: Nag Pushpa\n- 5 Vargas favorable: Kanduk\n- 6 Vargas favorable: Kerala\n- 7 Vargas favorable: Kalpavriksha","operationId":"calculate_varga_strength_api_v1_divisional_charts_varga_strength_get","parameters":[{"description":"Birth date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Date","description":"Birth date (YYYY-MM-DD)"},"name":"date","in":"query"},{"description":"Birth time (HH:MM:SS)","required":true,"schema":{"type":"string","title":"Time","description":"Birth time (HH:MM:SS)"},"name":"time","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Birth latitude"},"name":"latitude","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Birth longitude"},"name":"longitude","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Derived from the birth place's coordinates; a zone sent is replaced","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Planet name (Sun, Moon, Mars, etc.)","required":true,"schema":{"type":"string","title":"Planet","description":"Planet name (Sun, Moon, Mars, etc.)"},"name":"planet","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/divisional-charts/charts":{"get":{"tags":["Advanced"],"summary":"List Divisional Charts","description":"List all available divisional charts with metadata.\n\nReturns detailed information about each supported divisional chart\nincluding significance, division, and accuracy requirements.","operationId":"list_divisional_charts_api_v1_divisional_charts_charts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/divisional-charts/significance/{chart_type}":{"get":{"tags":["Advanced"],"summary":"Get Chart Significance","description":"Get detailed significance and interpretation guide for a chart.\n\nReturns comprehensive information about what a specific divisional\nchart represents and how to interpret it.","operationId":"get_chart_significance_api_v1_divisional_charts_significance__chart_type__get","parameters":[{"required":true,"schema":{"type":"string","title":"Chart Type"},"name":"chart_type","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/varshaphal/analyze":{"post":{"tags":["Advanced"],"summary":"Analyze Varshaphal","description":"Calculate complete Varshaphal (Annual Chart) analysis.\n\nVarshaphal is the Tajika system for annual predictions based on the\nSolar Return - the moment when the Sun returns to its exact birth position.\n\n**Key Components Analyzed:**\n\n**1. Solar Return Chart**\nThe chart cast for the exact moment of Sun's return provides the foundation\nfor the year's predictions. All planetary positions and houses are calculated.\n\n**2. Muntha (Progressed Ascendant)**\nMuntha moves one sign per year from the birth ascendant. Its house position\nand lord determine overall fortune for the year:\n- Houses 1, 5, 9, 10, 11: Excellent results\n- Houses 2, 4, 7: Good results\n- Houses 6, 8, 12: Challenging (need remedies)\n\n**3. Year Lord (Varshesha)**\nSelected using Pancha Vargeeya Bala (five-fold strength):\n- Dina Bala (day strength)\n- Hora Bala (hour strength)\n- Masa Bala (month strength)\n- Varsha Bala (year strength)\n- Weekday lord consideration\n\n**4. Tajika Yogas (16 Annual Combinations)**\n- Ithasala: Applying aspect (success)\n- Ishrafa: Separating aspect (past events)\n- Nakta: Transfer of light\n- Yamaya: Mutual reception with aspect\n- Kamboola: Moon applying to both significators\n- And 11 more specialized yogas\n\n**5. Sahams (Arabic Parts/Lots)**\n16 sensitive points calculated from planetary positions:\n- Punya Saham (Fortune)\n- Karma Saham (Career)\n- Vivaha Saham (Marriage)\n- And 13 more life areas\n\n**6. Mudda Dasha (Annual Periods)**\nThe year divided among planets based on their strength.\nSimilar to Vimshottari but for one year.\n\n**Response includes:**\n- Complete Solar Return chart\n- Muntha analysis with favorable months\n- Year Lord with activities\n- All Sahams with interpretations\n- Tajika Yogas present\n- Month-by-month predictions\n- Life area forecasts\n- Overall year summary and score","operationId":"analyze_varshaphal_api_v1_varshaphal_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VarshaphalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VarshaphalResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/varshaphal/muntha":{"post":{"tags":["Advanced"],"summary":"Calculate Muntha","description":"Calculate Muntha (progressed ascendant) for a specific year.\n\n**What is Muntha?**\nMuntha is a progressed point that moves one sign per year from the\nbirth ascendant. It's one of the most important factors in Varshaphal.\n\n**Calculation:**\nMuntha Sign = Birth Ascendant Sign + (Current Age in years)\nThe degree remains the same as the birth ascendant.\n\n**Interpretation:**\nThe house position of Muntha in the Solar Return chart determines\nthe overall fortune and focus areas for the year:\n\n- **1st House**: Self-improvement, new beginnings, personal projects\n- **2nd House**: Finances, family, speech, food habits\n- **3rd House**: Courage, siblings, short travels, communication\n- **4th House**: Home, mother, property, emotional peace\n- **5th House**: Children, creativity, romance, education\n- **6th House**: Health challenges, enemies, service, debts\n- **7th House**: Marriage, partnerships, business relationships\n- **8th House**: Transformation, inheritance, occult matters\n- **9th House**: Fortune, spirituality, higher learning, travel\n- **10th House**: Career peak, recognition, authority\n- **11th House**: Gains, friendships, goal fulfillment\n- **12th House**: Expenses, foreign lands, spiritual growth\n\n**Muntha Lord:**\nThe strength and placement of the Muntha lord significantly modifies results.\nA strong Muntha lord can elevate challenging placements.","operationId":"calculate_muntha_api_v1_varshaphal_muntha_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MunthaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MunthaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/varshaphal/sahams":{"post":{"tags":["Advanced"],"summary":"Calculate Sahams","description":"Calculate Sahams (Arabic Parts/Lots) for the annual chart.\n\n**What are Sahams?**\nSahams are sensitive mathematical points derived from three factors:\nSaham = Ascendant + Planet A - Planet B\n\nThey indicate specific life areas and their fortune for the year.\n\n**Main Sahams (16):**\n\n| Saham | Meaning | Formula |\n|-------|---------|---------|\n| Punya | Fortune/Luck | Asc + Moon - Sun |\n| Vidya | Education | Asc + Mercury - Sun |\n| Yashas | Fame | Asc + Jupiter - Sun |\n| Mitra | Friends | Asc + Jupiter - Moon |\n| Karma | Career | Asc + Mars - Mercury |\n| Vivaha | Marriage | Asc + Venus - Saturn |\n| Putra | Children | Asc + Jupiter - Moon |\n| Matri | Mother | Asc + Moon - Venus |\n| Pitri | Father | Asc + Saturn - Sun |\n| Bhratri | Siblings | Asc + Jupiter - Saturn |\n| Roga | Disease | Asc + Saturn - Mars |\n| Rajya | Authority | Asc + Mars - Moon |\n| Gaurav | Honor | Asc + Jupiter - Sun |\n| Samartha | Power | Asc + Mars - Saturn |\n| Asha | Desires | Asc + Saturn - Venus |\n| Mahatmya | Greatness | Asc + Jupiter - Saturn |\n\n**Interpretation:**\n- House position: Indicates area of activation\n- Lord strength: Determines quality of results\n- Aspects: Modify the outcomes","operationId":"calculate_sahams_api_v1_varshaphal_sahams_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SahamRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SahamResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/varshaphal/tajika-yogas":{"post":{"tags":["Advanced"],"summary":"Calculate Tajika Yogas","description":"Calculate Tajika Yogas for the annual chart.\n\nTajika Yogas describe how annual matters unfold through planetary\napplications, separations, transfers of light, and mutual receptions.","operationId":"calculate_tajika_yogas_api_v1_varshaphal_tajika_yogas_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TajikaYogaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TajikaYogaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/varshaphal/year-lord":{"post":{"tags":["Advanced"],"summary":"Calculate Year Lord","description":"Determine the Year Lord (Varshesha) for a specific annual chart.\n\nThe response includes Muntha context because Muntha lord strength is part\nof the annual judgment used alongside the selected Varsha Lord.","operationId":"calculate_year_lord_api_v1_varshaphal_year_lord_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearLordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearLordResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/varshaphal/compare":{"post":{"tags":["Advanced"],"summary":"Compare Years","description":"Compare multiple years for trends and patterns.\n\n**Use Cases:**\n- Planning major life decisions across years\n- Identifying best year for specific activities\n- Understanding cyclical patterns in your chart\n\n**Analysis Includes:**\n- Year-by-year scores and themes\n- Overall trend direction (improving/declining/stable)\n- Best years for different activities (career, relationships, etc.)\n- Cyclical patterns (Jupiter 12-year, Saturn 7-year)\n\n**Recommendations:**\nCompare at least 3-5 years for meaningful trend analysis.\nFor cyclical patterns, compare 7-12 years.","operationId":"compare_years_api_v1_varshaphal_compare_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearComparisonRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearComparisonResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/varshaphal/guide":{"get":{"tags":["Advanced"],"summary":"Varshaphal Guide","description":"Educational guide to Varshaphal (Annual Chart) system.\n\nReturns comprehensive information about the Tajika/Varshaphal system\nused for annual predictions in Vedic astrology.","operationId":"varshaphal_guide_api_v1_varshaphal_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/varshaphal/tajika-yogas-list":{"get":{"tags":["Advanced"],"summary":"List Tajika Yogas","description":"List all 16 Tajika Yogas with descriptions.\n\nProvides detailed information about each of the 16 traditional\nTajika yogas used in annual chart analysis.","operationId":"list_tajika_yogas_api_v1_varshaphal_tajika_yogas_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/gochara/analyze":{"post":{"tags":["Advanced"],"summary":"Analyze Gochara","description":"Complete Gochara (Transit) Analysis.\n\nGochara is the Vedic system for analyzing planetary transits and their\neffects on the natal chart. Transit effects are primarily judged from\nthe natal Moon sign (Janma Rashi).\n\n**Key Components:**\n\n**1. Transit Positions**\nAll planets' current positions analyzed from natal Moon sign.\nHouses 3, 6, 10, 11 are generally favorable for most planets.\n\n**2. Vedha (Obstruction) System**\nVedha points can nullify otherwise good transits:\n- Each planet has specific vedha points\n- If another planet occupies the vedha house, benefic transit is obstructed\n- Example: Sun's benefic transit in 3rd is nullified if vedha in 9th\n\n**3. Sade Sati Analysis**\nSaturn's 7.5 year transit over natal Moon:\n- Rising (12th from Moon): Beginning phase\n- Peak (over Moon): Most intense\n- Setting (2nd from Moon): Final phase\n\n**4. Dhaiya (Small Panoti)**\nSaturn in 4th or 8th from Moon:\n- 4th house: Affects home, mother, comfort\n- 8th house: Affects health, obstacles\n\n**5. Major Transit Analysis**\nDetailed analysis of Jupiter, Saturn, Rahu, Ketu transits.\n\n**6. House-wise Effects**\nCombined transit effects for all 12 houses.\n\n**7. Transit Timeline**\nUpcoming significant transit events.","operationId":"analyze_gochara_api_v1_gochara_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GocharaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GocharaResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/gochara/sade-sati":{"post":{"tags":["Advanced"],"summary":"Analyze Sade Sati","description":"Analyze Sade Sati and Dhaiya status.\n\n**Sade Sati (Seven and a Half Years)**\n\nThe most significant Saturn transit period, lasting approximately 7.5 years\nwhen Saturn transits through 12th, 1st, and 2nd houses from natal Moon.\n\n**Three Phases:**\n\n1. **Rising Phase (Dhayya)** - Saturn in 12th from Moon\n - Duration: ~2.5 years\n - Effects: Increased expenses, sleep issues, hidden enemies active\n - Intensity: Moderate (building up)\n\n2. **Peak Phase** - Saturn over natal Moon\n - Duration: ~2.5 years\n - Effects: Mental stress, health issues, career obstacles\n - Intensity: Maximum (most challenging)\n\n3. **Setting Phase** - Saturn in 2nd from Moon\n - Duration: ~2.5 years\n - Effects: Financial strain, family issues, speech problems\n - Intensity: Moderate (winding down)\n\n**Dhaiya (Small Panoti)**\n\nShorter challenging periods when Saturn transits 4th or 8th from Moon:\n\n- **4th House Transit**: Affects domestic happiness, mother, property\n- **8th House Transit**: Affects longevity, sudden events, inheritance\n\n**Important Note:**\nSade Sati effects vary based on Saturn's role in the birth chart.\nFor some Moon signs, Saturn is a yoga karaka (beneficial).","operationId":"analyze_sade_sati_api_v1_gochara_sade_sati_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SadeSatiRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SadeSatiResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/gochara/timeline":{"post":{"tags":["Advanced"],"summary":"Get Transit Timeline","description":"Get upcoming transit timeline.\n\nReturns every sidereal sign ingress of the Sun, Mars, Mercury, Venus,\nJupiter, Saturn, Rahu and Ketu between `start_date` and `days_ahead`\ndays later, computed in the requested ayanamsa. The Moon is omitted.\n\nEach row is structured, not prose: `planet`, `event_type`\n(`sign_change`), `sign` / `from_sign` with their numbers, the ingress\ninstant in the birth timezone, `is_retrograde` (entered moving\nbackwards) and `house_from_moon`. `major_events` is the subset for\nJupiter, Saturn, Rahu and Ketu.\n\n**Significance Levels:**\n- Major: Jupiter, Saturn, Rahu/Ketu events\n- Moderate: Sun, Mars, Venus events\n- Minor: Moon, Mercury events","operationId":"get_transit_timeline_api_v1_gochara_timeline_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitTimelineRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitTimelineResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/gochara/predictions":{"post":{"tags":["Advanced"],"summary":"Get Gochara Predictions","description":"Get transit-based predictions for a specific period.\n\nCombines transit analysis with life area predictions for\ndaily, weekly, or monthly periods.\n\n**Period Types:**\n- `daily`: Single day prediction\n- `weekly`: 7-day prediction\n- `monthly`: 30-day prediction\n\n**Prediction Areas:**\n- Career and profession\n- Finance and wealth\n- Health and vitality\n- Relationships and family\n- Spirituality and growth","operationId":"get_gochara_predictions_api_v1_gochara_predictions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GocharaPredictionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GocharaPredictionResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/gochara/guide":{"get":{"tags":["Advanced"],"summary":"Gochara Guide","description":"Educational guide to Gochara (Transit) Analysis.\n\nReturns comprehensive information about the Vedic transit system.","operationId":"gochara_guide_api_v1_gochara_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/sarvatobhadra/analyze":{"post":{"tags":["Advanced"],"summary":"Analyze Sarvatobhadra","description":"Complete Sarvatobhadra Chakra Analysis.\n\nThe Sarvatobhadra Chakra is a 9x9 grid used for:\n- Transit vedha analysis\n- Muhurta (auspicious timing) selection\n- Predictive analysis\n\n**Chakra Components:**\n- 27 Nakshatras on the edges\n- 12 Rashis (Signs)\n- 7 Varas (Weekdays)\n- Vowels (Swaras) and Consonants (Vyanjanas)\n\n**Vedha System:**\nVedha means obstruction. When a transiting planet is in a nakshatra\nthat has a diagonal, horizontal, or vertical alignment with your\nbirth nakshatra in the chakra, it creates vedha.\n\n- **Malefic planets causing vedha**: Saturn, Mars, Rahu, Ketu\n create obstacles and challenges\n- **Benefic planets causing vedha**: Jupiter, Venus, Mercury\n create positive influences even through vedha\n\n**Uses:**\n1. Predicting effects of current transits\n2. Selecting auspicious muhurtas\n3. Understanding vedha patterns\n4. Timing important activities","operationId":"analyze_sarvatobhadra_api_v1_sarvatobhadra_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SarvatobhadraRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SarvatobhadraResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/sarvatobhadra/check-vedha":{"post":{"tags":["Advanced"],"summary":"Check Vedha","description":"Check if a specific transit causes vedha to birth nakshatra.\n\nQuick check for whether a transiting planet in a specific nakshatra\ncreates vedha to the birth nakshatra.\n\n**Vedha Patterns:**\nEach nakshatra has specific other nakshatras that cause vedha to it.\nThis is based on the geometric alignment in the Sarvatobhadra Chakra.","operationId":"check_vedha_api_v1_sarvatobhadra_check_vedha_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VedhaCheckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VedhaCheckResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/sarvatobhadra/guide":{"get":{"tags":["Advanced"],"summary":"Sarvatobhadra Guide","description":"Educational guide to Sarvatobhadra Chakra.","operationId":"sarvatobhadra_guide_api_v1_sarvatobhadra_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/special-lagnas/calculate":{"post":{"tags":["Advanced"],"summary":"Calculate Special Lagnas","description":"Calculate all special lagnas for a birth chart.\n\nSpecial lagnas are sensitive points that provide insights into:\n- Hora Lagna: Wealth and financial potential\n- Ghati Lagna: Success and achievements\n- Varnada Lagna: Social status and position\n- Bhava Lagna: Alternative house reference\n- Indu Lagna: Prosperity and abundance\n- Sree Lagna: Overall fortune\n- Pranapada Lagna: Vitality and life force","operationId":"calculate_special_lagnas_api_v1_special_lagnas_calculate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthDataRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpecialLagnasResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/special-lagnas/hora-lagna":{"post":{"tags":["Advanced"],"summary":"Calculate Hora Lagna","description":"Calculate only Hora Lagna (wealth indicator).\n\nHora Lagna is one of the most important special lagnas for\nanalyzing wealth and financial potential in a chart.","operationId":"calculate_hora_lagna_api_v1_special_lagnas_hora_lagna_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthDataRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/special-lagnas/indu-lagna":{"post":{"tags":["Advanced"],"summary":"Calculate Indu Lagna","description":"Calculate only Indu Lagna (prosperity indicator).\n\nIndu Lagna uses Kala values of 9th lords to determine\nwealth and prosperity potential.","operationId":"calculate_indu_lagna_api_v1_special_lagnas_indu_lagna_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthDataRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/special-lagnas/varnada-lagna":{"post":{"tags":["Advanced"],"summary":"Calculate Varnada Lagna","description":"Calculate only Varnada Lagna (social status indicator).\n\nVarnada Lagna indicates one's social position and status in society.","operationId":"calculate_varnada_lagna_api_v1_special_lagnas_varnada_lagna_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthDataRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/special-lagnas/types":{"get":{"tags":["Advanced"],"summary":"Get Lagna Types","description":"Get information about all special lagna types.\n\nReturns descriptions and significance of each special lagna.","operationId":"get_lagna_types_api_v1_special_lagnas_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/special-lagnas/kala-values":{"get":{"tags":["Advanced"],"summary":"Get Kala Values","description":"Get Kala values used in Indu Lagna calculation.\n\nThese values are assigned to planets for calculating Indu Lagna.","operationId":"get_kala_values_api_v1_special_lagnas_kala_values_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dasha/extended/ashtottari":{"post":{"tags":["Advanced"],"summary":"Calculate Ashtottari Dasha","description":"Calculate Ashtottari Dasha (108-year cycle).\n\nAshtottari Dasha uses 8 planets (Sun, Moon, Mars, Mercury,\nSaturn, Jupiter, Rahu, Venus - excludes Ketu).\n\n**Applicability:**\nTraditionally used when Rahu is in a kendra or trikona\nfrom the Lagna lord.\n\n**Planet Years:**\n- Sun: 6 years\n- Moon: 15 years\n- Mars: 8 years\n- Mercury: 17 years\n- Saturn: 10 years\n- Jupiter: 19 years\n- Rahu: 12 years\n- Venus: 21 years","operationId":"calculate_ashtottari_dasha_api_v1_dasha_extended_ashtottari_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__routers__extended_dasha__DashaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__routers__extended_dasha__DashaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/extended/kalachakra":{"post":{"tags":["Advanced"],"summary":"Calculate Kalachakra Dasha","description":"Calculate Kalachakra Dasha.\n\nKalachakra is a unique dasha system based on nakshatra groups\nthat uses zodiac signs (rashis) for periods instead of planets.\n\n**Key Features:**\n- Based on nakshatra padas\n- Uses signs instead of planets\n- Direction varies by nakshatra group (savya/apsavya)\n\n**Sign Years:**\nAries: 7, Taurus: 16, Gemini: 21, Cancer: 9,\nLeo: 5, Virgo: 9, Libra: 7, Scorpio: 10,\nSagittarius: 4, Capricorn: 4, Aquarius: 10, Pisces: 4","operationId":"calculate_kalachakra_dasha_api_v1_dasha_extended_kalachakra_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__routers__extended_dasha__DashaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__routers__extended_dasha__DashaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/extended/comparison":{"post":{"tags":["Advanced"],"summary":"Compare Dasha Systems","description":"Compare current periods across different dasha systems.\n\nReturns a side-by-side comparison of Ashtottari and Kalachakra\ndashas, showing how different systems interpret the same chart.","operationId":"compare_dasha_systems_api_v1_dasha_extended_comparison_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__routers__extended_dasha__DashaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/extended/applicability":{"post":{"tags":["Advanced"],"summary":"Check Dasha Applicability","description":"Check which dasha system is most applicable for a chart.\n\nDifferent dasha systems have different conditions for applicability:\n- **Ashtottari**: Rahu in kendra/trikona from Lagna lord\n- **Kalachakra**: Universal applicability\n- **Vimshottari**: Universal applicability (reference)","operationId":"check_dasha_applicability_api_v1_dasha_extended_applicability_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicabilityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/dasha/extended/systems":{"get":{"tags":["Advanced"],"summary":"Get Dasha Systems","description":"Get information about all available dasha systems.\n\nReturns descriptions, planet/sign years, and usage guidelines\nfor each dasha system.","operationId":"get_dasha_systems_api_v1_dasha_extended_systems_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dasha/extended/ashtottari/planets":{"get":{"tags":["Advanced"],"summary":"Get Ashtottari Planet Info","description":"Get detailed information about Ashtottari planet periods.\n\nReturns years, themes, and interpretive guidelines for each planet.","operationId":"get_ashtottari_planet_info_api_v1_dasha_extended_ashtottari_planets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dasha/extended/kalachakra/signs":{"get":{"tags":["Advanced"],"summary":"Get Kalachakra Sign Info","description":"Get detailed information about Kalachakra sign periods.\n\nReturns years, themes, and directions for each sign.","operationId":"get_kalachakra_sign_info_api_v1_dasha_extended_kalachakra_signs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/prashna/feedback":{"post":{"tags":["Prashna"],"summary":"Provide Feedback","description":"Provide feedback on a Prashna answer.\n\nThis endpoint allows users to provide feedback on the answers they received,\nwhich helps improve the system through reinforcement learning.\n\nParameters:\n- question_id: ID of the question\n- answer_helpful: Whether the answer was helpful\n- correct_answer: Correct answer (if known)\n- feedback_text: Additional feedback text\n\nReturns:\n- JSONResponse: Confirmation of feedback receipt","operationId":"provide_feedback_api_v1_prashna_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/prashna/categories":{"get":{"tags":["Prashna"],"summary":"Get Categories","description":"Get list of available question categories.\n\nReturns:\n- List[str]: List of question categories","operationId":"get_categories_api_v1_prashna_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get Categories Api V1 Prashna Categories Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/prashna/types":{"get":{"tags":["Prashna"],"summary":"Get Types","description":"Get list of available question types.\n\nReturns:\n- List[str]: List of question types","operationId":"get_types_api_v1_prashna_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get Types Api V1 Prashna Types Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/prashna/query":{"post":{"tags":["Prashna Inquiries"],"summary":"Classify and answer a Panchang, Rashiphal or Jyotish question","description":"Canonical cross-application question gateway.\n\nPublic Panchang and explicit-Rashi general Rashiphal are answered directly.\nOther Jyotish asks return a machine-readable gate for anonymous/incomplete\nusers; with a valid user and complete DOB/TOB/POB the same request creates\nand returns the persisted inquiry. Clients should retain ``asked_at`` and\n``location`` when retrying after authentication/profile completion.","operationId":"query_gateway_api_v1_prashna_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaGatewayRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaGatewayResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/prashna/suggest":{"post":{"tags":["Prashna Inquiries"],"summary":"Suggest Question","description":"Google-like Prashna omnibox: completion, category, rewrites, clarifying.\n\nPublic — used on the homepage before login. Rule-based + continuously\nlearns from real asks (no LLM).","operationId":"suggest_question_api_v1_prashna_suggest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaSuggestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaSuggestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/prashna/panchang-query":{"post":{"tags":["Prashna Inquiries"],"summary":"Panchang Query","description":"Answer a natural-language Panchang question directly.\n\nPublic and stateless. An almanac lookup — \"what is today's tithi?\" — has a\nsingle correct answer that does not depend on the querent, so it is served\nwithout auth and without the demographics the horary inquiry flow needs.\nSigned-in users additionally get these persisted via ``POST /inquiries``.","operationId":"panchang_query_api_v1_prashna_panchang_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangQueryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchangQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/prashna/querent-status":{"get":{"tags":["Prashna Inquiries"],"summary":"Querent Status","description":"Whether the signed-in user has complete DOB, TOB and geocoded POB.","operationId":"querent_status_api_v1_prashna_querent_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuerentStatusOut"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/prashna/inquiries":{"post":{"tags":["Prashna Inquiries"],"summary":"Create Inquiry","description":"Create a Prashna inquiry for the authenticated user.\n\nCasts the horary chart at ``question.asked_at``, snapshots the profile,\nthe full result artifact, and a denormalized answer for the UI.\nOmit ``querent`` when the user already has a complete profile.","operationId":"create_inquiry_api_v1_prashna_inquiries_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePrashnaInquiryRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaInquiryOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/prashna/inquiries/mine":{"get":{"tags":["Prashna Inquiries"],"summary":"List My Inquiries","description":"List the current user's past Prashna inquiries (newest first).","operationId":"list_my_inquiries_api_v1_prashna_inquiries_mine_get","parameters":[{"required":false,"schema":{"type":"integer","minimum":0.0,"title":"Skip","default":0},"name":"skip","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":50},"name":"limit","in":"query"},{"required":false,"schema":{"type":"boolean","title":"Archived","default":false},"name":"archived","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PrashnaInquiryOut"},"type":"array","title":"Response List My Inquiries Api V1 Prashna Inquiries Mine Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/prashna/inquiries/{inquiry_id}":{"get":{"tags":["Prashna Inquiries"],"summary":"Get Inquiry","description":"Fetch one inquiry owned by the current user.","operationId":"get_inquiry_api_v1_prashna_inquiries__inquiry_id__get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Inquiry Id"},"name":"inquiry_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaInquiryOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"delete":{"tags":["Prashna Inquiries"],"summary":"Delete Inquiry","operationId":"delete_inquiry_api_v1_prashna_inquiries__inquiry_id__delete","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Inquiry Id"},"name":"inquiry_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"},"patch":{"tags":["Prashna Inquiries"],"summary":"Update Inquiry","operationId":"update_inquiry_api_v1_prashna_inquiries__inquiry_id__patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Inquiry Id"},"name":"inquiry_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePrashnaInquiryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaInquiryOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/prashna/inquiries/{inquiry_id}/consultation":{"patch":{"tags":["Prashna Inquiries"],"summary":"Request Consultation","description":"Record that the user wants WhatsApp / phone / video consultation.","operationId":"request_consultation_api_v1_prashna_inquiries__inquiry_id__consultation_patch","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"Inquiry Id"},"name":"inquiry_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsultationRequestBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrashnaInquiryOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/advanced-muhurta/find":{"get":{"tags":["Muhurat"],"summary":"Find Advanced Muhurta","description":"Find advanced muhurta windows for a specific activity.\n\nThis endpoint uses comprehensive Vedic electional astrology rules including:\n- Nakshatra suitability for the activity\n- Tithi (lunar day) compatibility\n- Weekday analysis\n- Tarabala (if birth nakshatra provided)\n- Chandrabala (if birth rashi provided)\n- Inauspicious period avoidance (Rahu Kaal, etc.)\n- Special yoga bonuses\n\nThe full list of activities is the `activity` enum in the schema below, and\n`GET /advanced-muhurta/activities` returns each one with its name,\ndescription and recommended minimum score. This docstring used to name nine\nof them, which was the entire discoverable set even though thirty are\naccepted.","operationId":"find_advanced_muhurta_api_v1_advanced_muhurta_find_get","parameters":[{"description":"Date to search (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Search Date","description":"Date to search (YYYY-MM-DD)"},"name":"search_date","in":"query"},{"description":"Activity to elect a time for","required":true,"schema":{"allOf":[{"$ref":"#/components/schemas/ActivityCategory"}],"description":"Activity to elect a time for"},"name":"activity","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Birth nakshatra for Tarabala","required":false,"schema":{"type":"string","title":"Birth Nakshatra","description":"Birth nakshatra for Tarabala"},"name":"birth_nakshatra","in":"query"},{"description":"Birth Moon sign for Chandrabala","required":false,"schema":{"type":"string","title":"Birth Rashi","description":"Birth Moon sign for Chandrabala"},"name":"birth_rashi","in":"query"},{"description":"Minimum score threshold","required":false,"schema":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Min Score","description":"Minimum score threshold","default":60.0},"name":"min_score","in":"query"},{"description":"Maximum results","required":false,"schema":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Max Results","description":"Maximum results","default":10},"name":"max_results","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindMuhurtaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/favorable-days":{"get":{"tags":["Muhurat"],"summary":"Find Favorable Days","description":"Rank the days in a range by how well they suit one activity.\n\n`/find` picks the hour within a day; this picks the day. Both score a day\nfrom its tithi, nakshatra and weekday against the same activity rules, so a\ndate's score is the same number in both -- ask this first, then ask `/find`\nfor the chosen date's windows.\n\nThe activity vocabulary is the `activity` enum below, the same thirty\nsamskaras `/find` accepts; `GET /advanced-muhurta/activities` lists each with\nits recommended minimum score, which is what `meets_recommended_score`\ncompares against.\n\nCoordinates and timezone are not optional decoration: the score is read at\nlocal sunrise, so the wrong place reads the wrong day.","operationId":"find_favorable_days_api_v1_advanced_muhurta_favorable_days_get","parameters":[{"description":"Activity to rank days for","required":true,"schema":{"allOf":[{"$ref":"#/components/schemas/ActivityCategory"}],"description":"Activity to rank days for"},"name":"activity","in":"query"},{"description":"First day of the range (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Start Date","description":"First day of the range (YYYY-MM-DD)"},"name":"start_date","in":"query"},{"description":"Last day of the range (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"End Date","description":"Last day of the range (YYYY-MM-DD)"},"name":"end_date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone the local day is reckoned in; must match the coordinates","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone the local day is reckoned in; must match the coordinates","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"How many of the best days to return","required":false,"schema":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Limit","description":"How many of the best days to return","default":10},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindFavorableDaysResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/daily-analysis":{"get":{"tags":["Muhurat"],"summary":"Get Daily Muhurta Analysis","description":"Get complete daily muhurta analysis.\n\nReturns:\n- All 24 planetary horas\n- All choghadiyas (day and night)\n- Abhijit Muhurta (most auspicious mid-day period)\n- Brahma Muhurta (pre-dawn spiritual time)\n- Rahu Kaal, Gulika Kaal, Yamaganda\n- Durmuhurtas (inauspicious muhurtas)\n- Special yogas active on the day\n- Activity suitability scores","operationId":"get_daily_muhurta_analysis_api_v1_advanced_muhurta_daily_analysis_get","parameters":[{"description":"Date to analyze (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Analysis Date","description":"Date to analyze (YYYY-MM-DD)"},"name":"analysis_date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyMuhurtaAnalysisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/tarabala":{"get":{"tags":["Muhurat"],"summary":"Calculate Tarabala","description":"Calculate Tarabala (nakshatra compatibility).\n\nTarabala determines the compatibility between a person's birth nakshatra\nand the current/muhurta nakshatra. It divides into 9 Taras:\n\n1. Janma (Birth) - Mixed; best kept to routine or inward work\n2. Sampat (Wealth) - Favorable\n3. Vipat (Danger) - Unfavorable\n4. Kshema (Well-being) - Favorable\n5. Pratyari (Obstacle) - Unfavorable\n6. Sadhaka (Achievement) - Favorable\n7. Vadha (Death-like) - Unfavorable\n8. Mitra (Friend) - Favorable\n9. Parama Mitra (Best Friend) - Highly Favorable","operationId":"calculate_tarabala_api_v1_advanced_muhurta_tarabala_get","parameters":[{"description":"Birth nakshatra (e.g., Ashwini, Rohini)","required":true,"schema":{"type":"string","title":"Birth Nakshatra","description":"Birth nakshatra (e.g., Ashwini, Rohini)"},"name":"birth_nakshatra","in":"query"},{"description":"Transit/muhurta nakshatra","required":true,"schema":{"type":"string","title":"Transit Nakshatra","description":"Transit/muhurta nakshatra"},"name":"transit_nakshatra","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TarabalaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/chandrabala":{"get":{"tags":["Muhurat"],"summary":"Calculate Chandrabala","description":"Calculate Chandrabala (Moon's house strength).\n\nChandrabala shows the Moon's transit position relative to your birth Moon sign.\n\nFavourable houses from the birth Moon: 1, 3, 6, 7, 10 and 11.\nHard houses: 4, 8 and 12. Houses 2, 5 and 9 are returned as mixed when\nPaksha is unknown and favourable when ``paksha=Shukla``.\n\nThis is crucial for timing important activities as the Moon's position\nsignificantly affects the outcome.","operationId":"calculate_chandrabala_api_v1_advanced_muhurta_chandrabala_get","parameters":[{"description":"Birth Moon sign (e.g., Mesha, Vrishabha)","required":true,"schema":{"type":"string","title":"Birth Rashi","description":"Birth Moon sign (e.g., Mesha, Vrishabha)"},"name":"birth_rashi","in":"query"},{"description":"Transit Moon sign","required":true,"schema":{"type":"string","title":"Transit Moon Rashi","description":"Transit Moon sign"},"name":"transit_moon_rashi","in":"query"},{"description":"Optional lunar fortnight; enables the Shukla rule for houses 2, 5 and 9","required":false,"schema":{"type":"string","pattern":"^(Shukla|Krishna)$","title":"Paksha","description":"Optional lunar fortnight; enables the Shukla rule for houses 2, 5 and 9"},"name":"paksha","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChandrabalaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/day-bala":{"get":{"tags":["Muhurat"],"summary":"Get Day Bala","description":"Tara Bala and Chandra Bala for every birth nakshatra and rashi on one day.\n\n/tarabala and /chandrabala are per-person: you bring a birth star and get\none verdict. This is the inverse -- bring a date and a place, get the whole\ntable -- which is what a panchang page needs to answer \"today favours these\nbirth stars\". Both rules, the transiting Moon and the paksha are all\nresolved here, so the caller needs only a date and a place.\n\n``tarabala`` holds 27 entries in nakshatra order, ``chandrabala`` 12 in\nrashi order; ``quality`` is one of favourable / mixed / unfavourable.\n\nThose two grade the day at local sunrise. ``tarabala_bands`` and\n``chandrabala_bands`` grade each stretch of the day separately and tile it\nfrom sunrise to the next sunrise, because both verdicts turn over inside the\nday: the Tara with the Moon's nakshatra, the Chandra Bala with its rashi and\nwith the paksha. A day where nothing turns has one band. Either list is\nempty when its boundaries would not solve, and the flat table is then the\nonly answer -- so a caller reads the bands when they are there and the flat\nlist when they are not.","operationId":"get_day_bala_api_v1_advanced_muhurta_day_bala_get","parameters":[{"description":"Date to evaluate (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Analysis Date","description":"Date to evaluate (YYYY-MM-DD)"},"name":"analysis_date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DayBalaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/panchaka":{"get":{"tags":["Muhurat"],"summary":"Check Panchaka","description":"Check for Panchaka (five-fold affliction).\n\nPanchaka occurs when the Moon transits the last 5 nakshatras\n(Dhanishta to Revati). Each nakshatra represents a different affliction:\n\n- Mrityu Panchaka (Death)\n- Agni Panchaka (Fire)\n- Raja Panchaka (Authority problems)\n- Chora Panchaka (Theft)\n- Roga Panchaka (Disease)\n\nActivities like construction, traveling south, and cremation-related\nwork should be avoided during Panchaka.","operationId":"check_panchaka_api_v1_advanced_muhurta_panchaka_get","parameters":[{"description":"Date to check (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Check Date","description":"Date to check (YYYY-MM-DD)"},"name":"check_date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanchakaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/special-yoga-dates":{"get":{"tags":["Muhurat"],"summary":"Find Special Yoga Dates","description":"Find dates when a special auspicious yoga occurs.\n\nAvailable yoga types:\n- amrit_siddhi: Specific weekday + nakshatra combinations\n- ravi_pushya: Sunday + Pushya nakshatra (very rare, excellent for gold/business)\n- guru_pushya: Thursday + Pushya nakshatra (excellent for education/spiritual)\n- sarvartha_siddhi: Specific weekday + nakshatra combinations (all activities succeed)","operationId":"find_special_yoga_dates_api_v1_advanced_muhurta_special_yoga_dates_get","parameters":[{"description":"Special yoga to search for","required":true,"schema":{"allOf":[{"$ref":"#/components/schemas/SpecialYogaType"}],"description":"Special yoga to search for"},"name":"yoga_type","in":"query"},{"description":"Start date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Start Date","description":"Start date (YYYY-MM-DD)"},"name":"start_date","in":"query"},{"description":"End date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"End Date","description":"End date (YYYY-MM-DD)"},"name":"end_date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone the local day is reckoned in; must match the coordinates","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone the local day is reckoned in; must match the coordinates","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpecialYogaDatesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/activities":{"get":{"tags":["Muhurat"],"summary":"Get Available Activities","description":"Get list of available activity types for muhurta selection.","operationId":"get_available_activities_api_v1_advanced_muhurta_activities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivitiesResponse"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/nakshatra-guide":{"get":{"tags":["Muhurat"],"summary":"Get Nakshatra Guide","description":"Get nakshatra categories and their suitable activities.\n\nNakshatra categories:\n- Dhruva (Fixed): Permanent activities, construction\n- Chara (Movable): Travel, change, movement\n- Mridu (Soft): Arts, marriage, friendship\n- Tikshna (Sharp): Surgery, tantric, destructive activities\n- Ugra (Fierce): Battles, arguments, confrontation\n- Mishra (Mixed): General activities\n- Kshipra (Swift): Quick activities, emergency work","operationId":"get_nakshatra_guide_api_v1_advanced_muhurta_nakshatra_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NakshatraGuideResponse"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/advanced-muhurta/hora-guide":{"get":{"tags":["Muhurat"],"summary":"Get Hora Guide","description":"Get planetary hora (hour) guide with suitable activities.\n\nEach day is divided into 24 horas (12 day + 12 night), each ruled\nby a planet. Activities aligned with the hora lord are more successful.","operationId":"get_hora_guide_api_v1_advanced_muhurta_hora_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoraGuideResponse"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/gemstone/recommendations":{"post":{"tags":["Remedies"],"summary":"Get Gemstone Recommendations","description":"Get gemstone recommendations based on birth chart analysis.\n\nThis endpoint analyzes the birth chart and provides detailed recommendations for:\n- Primary gemstones to wear\n- Alternative gemstone options\n- Metal recommendations\n- Wearing instructions and precautions\n\nThe recommendations are based on:\n- Planetary positions and strengths\n- Aspects and dignities\n- Current planetary periods (dashas)","operationId":"get_gemstone_recommendations_api_v1_gemstone_recommendations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GemstoneRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GemstoneResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/gemstone/types":{"get":{"tags":["Remedies"],"summary":"Get Gemstone Types","description":"Get a list of available gemstone types.\n\nReturns a list of all gemstone types that can be recommended, including:\n- Ruby (Sun)\n- Pearl (Moon)\n- Red Coral (Mars)\n- Emerald (Mercury)\n- Yellow Sapphire (Jupiter)\n- Diamond (Venus)\n- Blue Sapphire (Saturn)\n- Hessonite (Rahu)\n- Cat's Eye (Ketu)","operationId":"get_gemstone_types_api_v1_gemstone_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get Gemstone Types Api V1 Gemstone Types Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/eclipse/search":{"get":{"tags":["Astronomical"],"summary":"Search Eclipses","description":"Search for eclipses within a date range.\n\nReturns solar and/or lunar eclipses with timing, visibility, and astrological details.\n\nArgs:\n start_date: Start of search period (YYYY-MM-DD)\n end_date: End of search period (YYYY-MM-DD)\n category: Filter by 'solar' or 'lunar' (optional)\n latitude: Observer latitude for visibility calculations (optional)\n longitude: Observer longitude for visibility calculations (optional)\n visible_only: If True, only return eclipses visible from the location\n timezone: IANA zone the per-eclipse `visibility_map[\"observer\"]` contact\n times are stamped in. Without it they come back in UTC, which reads\n as an eclipse on the wrong side of midnight for most of Asia.","operationId":"search_eclipses_api_v1_eclipse_search_get","parameters":[{"description":"Start date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Start Date","description":"Start date (YYYY-MM-DD)"},"name":"start_date","in":"query"},{"description":"End date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"End Date","description":"End date (YYYY-MM-DD)"},"name":"end_date","in":"query"},{"description":"Filter: 'solar' or 'lunar'","required":false,"schema":{"type":"string","title":"Category","description":"Filter: 'solar' or 'lunar'"},"name":"category","in":"query"},{"description":"Observer latitude","required":false,"schema":{"type":"number","title":"Latitude","description":"Observer latitude"},"name":"latitude","in":"query"},{"description":"Observer longitude","required":false,"schema":{"type":"number","title":"Longitude","description":"Observer longitude"},"name":"longitude","in":"query"},{"description":"Only return visible eclipses","required":false,"schema":{"type":"boolean","title":"Visible Only","description":"Only return visible eclipses","default":false},"name":"visible_only","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Search Eclipses Api V1 Eclipse Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/eclipse/next":{"get":{"tags":["Astronomical"],"summary":"Get Next Eclipse","description":"Get the next upcoming eclipse.\n\nReturns the next solar or lunar eclipse with complete details.\n\nFor a place-aware client, prefer `/eclipse/local/next`: it returns the local\ncontact times and the local sutak window together, rather than leaving the\ncaller to fetch sutak separately and risk pairing a local maximum with a\nglobal observance.\n\nArgs:\n category: Filter by 'solar' or 'lunar' (optional)\n latitude: Observer latitude for visibility calculations (optional)\n longitude: Observer longitude for visibility calculations (optional)\n visible_only: If True, only return if eclipse is visible from the location\n timezone: IANA zone the observer's local contact times are stamped in","operationId":"get_next_eclipse_api_v1_eclipse_next_get","parameters":[{"description":"Filter: 'solar' or 'lunar'","required":false,"schema":{"type":"string","title":"Category","description":"Filter: 'solar' or 'lunar'"},"name":"category","in":"query"},{"description":"Observer latitude","required":false,"schema":{"type":"number","title":"Latitude","description":"Observer latitude"},"name":"latitude","in":"query"},{"description":"Observer longitude","required":false,"schema":{"type":"number","title":"Longitude","description":"Observer longitude"},"name":"longitude","in":"query"},{"description":"Only return if visible from location","required":false,"schema":{"type":"boolean","title":"Visible Only","description":"Only return if visible from location","default":false},"name":"visible_only","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/eclipse/local/next":{"get":{"tags":["Astronomical"],"summary":"Get Next Local Eclipse","description":"The next eclipse, answered for one place.\n\nLocal first contact, maximum and last contact as seen from these\ncoordinates, the obscuration and altitude reached here, and the sutak window\nmeasured from this place's own contacts -- in one response, stamped in one\nzone.\n\nTHE LOCATION IS REQUIRED, INCLUDING THE ZONE. Every value here is a claim\nabout a specific place, and there is no defensible default: falling back to a\ncountry centroid publishes contact times for somewhere the reader is not, and\nfalling back to UTC dates the eclipse to the wrong day across most of Asia.\nA caller without a resolved place should say so rather than call this.\n\n`visible_only=False` (the default) returns the next eclipse whichever way,\nwith `is_visible: false` where it cannot be seen here. That is deliberate: a\nreader whose neighbours are discussing a grahan is owed \"not visible from\nhere, no sutak\" rather than silence, and silence is all `visible_only=True`\ncan offer. Use the filter only when the question really is \"the next one I\ncan watch\".\n\nArgs:\n latitude: Observer latitude (-90 to 90)\n longitude: Observer longitude (-180 to 180)\n timezone: IANA zone every returned time is stamped in\n category: Restrict to 'solar' or 'lunar' (optional)\n visible_only: Skip eclipses not visible from here\n rashi: Reader's janma rashi; adds `personal`\n language: Language of the `personal` prose, 'en' or 'hi'\n ayanamsa: Sidereal frame, Lahiri by default\n\nA RASHI THIS SERVICE CANNOT PLACE IS A 400, NOT A MISSING BLOCK. Returning\nthe report without `personal` would be indistinguishable from not having\nasked, so a client that misspelled the sign, or holds one in a script this\ndoes not read, would silently stop showing the reader their own reading.","operationId":"get_next_local_eclipse_api_v1_eclipse_local_next_get","parameters":[{"description":"Observer latitude","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Observer latitude"},"name":"latitude","in":"query"},{"description":"Observer longitude","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Observer longitude"},"name":"longitude","in":"query"},{"description":"IANA zone of the observer's place","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA zone of the observer's place","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Filter: 'solar' or 'lunar'","required":false,"schema":{"type":"string","title":"Category","description":"Filter: 'solar' or 'lunar'"},"name":"category","in":"query"},{"description":"Skip to the next eclipse actually visible here","required":false,"schema":{"type":"boolean","title":"Visible Only","description":"Skip to the next eclipse actually visible here","default":false},"name":"visible_only","in":"query"},{"description":"Reader's janma rashi, Sanskrit or English (Mesha/Aries ... Meena/Pisces). Adds the `personal` block.","required":false,"schema":{"type":"string","title":"Rashi","description":"Reader's janma rashi, Sanskrit or English (Mesha/Aries ... Meena/Pisces). Adds the `personal` block."},"name":"rashi","in":"query"},{"description":"Sidereal frame for the eclipse's rashi and nakshatra","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal frame for the eclipse's rashi and nakshatra","default":"Lahiri"},"name":"ayanamsa","in":"query"},{"description":"Language of the `personal` reading's prose. The reading is built server-side in this language; xmukha falls back to English silently, so a Hindi reader given English prose would look translated rather than untranslated.","required":false,"schema":{"type":"string","pattern":"^(en|hi)$","title":"Language","description":"Language of the `personal` reading's prose. The reading is built server-side in this language; xmukha falls back to English silently, so a Hindi reader given English prose would look translated rather than untranslated.","default":"en"},"name":"language","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocalEclipseReport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/eclipse/yearly/{year}":{"get":{"tags":["Astronomical"],"summary":"Get Yearly Calendar","description":"Get all eclipses for a specific year.\n\nReturns complete eclipse calendar with solar and lunar eclipses,\neclipse seasons, and astrological summary.\n\nArgs:\n year: Year to get eclipse calendar for (e.g., 2024)","operationId":"get_yearly_calendar_api_v1_eclipse_yearly__year__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Year"},"name":"year","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Yearly Calendar Api V1 Eclipse Yearly Year Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/eclipse/visibility":{"get":{"tags":["Astronomical"],"summary":"Get Eclipse Visibility","description":"Calculate eclipse visibility from a specific location.\n\nReturns detailed visibility information including local timing,\nobscuration percentage, and viewing notes.\n\nArgs:\n date: Date of the eclipse (YYYY-MM-DD)\n category: 'solar' or 'lunar'\n latitude: Observer latitude (-90 to 90)\n longitude: Observer longitude (-180 to 180)\n timezone: Timezone string (default: UTC)","operationId":"get_eclipse_visibility_api_v1_eclipse_visibility_get","parameters":[{"description":"Eclipse date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Date","description":"Eclipse date (YYYY-MM-DD)"},"name":"date","in":"query"},{"description":"'solar' or 'lunar'","required":true,"schema":{"type":"string","title":"Category","description":"'solar' or 'lunar'"},"name":"category","in":"query"},{"description":"Observer latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Observer latitude"},"name":"latitude","in":"query"},{"description":"Observer longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Observer longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/eclipse/local/personal":{"post":{"tags":["Astronomical"],"summary":"Get Next Local Eclipse For Chart","description":"The next eclipse for one place AND one birth chart. Phase 4.\n\nEverything `GET /eclipse/local/next` returns -- local contacts, obscuration,\nthe local sutak window, and the rashi-level `personal` reading -- plus\n`individual`: the same eclipse measured against the caller's own chart. The\nbhava counted from the LAGNA rather than the moon sign, which natal grahas the\neclipse degree falls on within five degrees, whether it stands in the reader's\nown janma nakshatra, and the Vimshottari lords running at maximum.\n\nA POST BECAUSE OF THE BODY. Birth date, time and coordinates identify a person\nclosely, and a query string is the part of a request that reaches access logs,\nbrowser history and `Referer` headers. The place-only reading stays a\ncacheable GET.\n\n`individual` IS NULL WHEN THE CHART COULD NOT BE READ, and that is a success,\nnot an error: the response still carries the eclipse, the local circumstances\nand the rashi reading. A chart-level reading assembled from a birth time that\ndid not parse, or coordinates the ephemeris will not answer for, is the one\noutput in this feature a reader cannot check -- it reads as MORE personal, not\nless. So it is withheld rather than approximated.\n\nTHE JANMA RASHI COMES FROM THE CHART unless `rashi` is sent. The natal Moon\nis a better source for it than the reader's own recollection, which is often a\ntropical sun sign; sending `rashi` overrides that for a reader who follows a\nspelling or a tradition this service does not derive.\n\nBoth blocks may be present and may report different house numbers --\n`personal.house_from_rashi` is counted from the moon sign and\n`individual.bhava_from_lagna` from the ascendant. Only a reader whose lagna\nand moon sign coincide sees the same number twice, and a client showing both\nmust label which is which.","operationId":"get_next_local_eclipse_for_chart_api_v1_eclipse_local_personal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocalEclipsePersonalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocalEclipseReport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/eclipse/grahan-dosha":{"post":{"tags":["Astronomical"],"summary":"Check Grahan Dosha","description":"Check if a person has Grahan Dosha (born during eclipse).\n\nGrahan Dosha occurs when a person is born during a solar or lunar eclipse.\nThis can have significant astrological implications that require remedies.\n\n``birth_date`` is interpreted as local civil time in ``timezone``.","operationId":"check_grahan_dosha_api_v1_eclipse_grahan_dosha_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrahanDoshaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/eclipse/sutak/{date}":{"get":{"tags":["Astronomical"],"summary":"Get Sutak Timing","description":"Get Sutak (inauspicious period) timing for an eclipse.\n\nSutak begins 12 hours before a solar eclipse and 9 hours before a lunar one,\nand is lifted at moksha -- last contact.\n\nBOTH OF THOSE ANCHORS ARE LOCAL. Pass a latitude and longitude to get the\nwindow as it applies at that place. Without one this can only return the\nGLOBAL window, measured from the first and last moments the eclipse is\nunder way anywhere on Earth, which overstates the observance -- for Delhi on\n26 Dec 2019 it ends at 13:35 IST instead of 10:57, keeping temples shut and a\nfast going for 2 h 38 min after the Sun was clear again -- and which cannot\ntell a location that there is no sutak at all because the grahan is not\nvisible there (adrshya-grahane na sutakam). `scope` in the response says\nwhich of the two you got.\n\nArgs:\n date: Eclipse date (YYYY-MM-DD)\n category: 'solar' or 'lunar'\n latitude: Observer latitude (optional; enables the local window)\n longitude: Observer longitude (optional; enables the local window)\n timezone: IANA timezone the returned times are stamped in\n\nReturns:\n Sutak start time, end time, and list of restrictions","operationId":"get_sutak_timing_api_v1_eclipse_sutak__date__get","parameters":[{"required":true,"schema":{"type":"string","title":"Date"},"name":"date","in":"path"},{"description":"'solar' or 'lunar'","required":true,"schema":{"type":"string","title":"Category","description":"'solar' or 'lunar'"},"name":"category","in":"query"},{"description":"Observer latitude","required":false,"schema":{"type":"number","title":"Latitude","description":"Observer latitude"},"name":"latitude","in":"query"},{"description":"Observer longitude","required":false,"schema":{"type":"number","title":"Longitude","description":"Observer longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/eclipse/astrology/{date}":{"get":{"tags":["Astronomical"],"summary":"Get Eclipse Astrology","description":"Get detailed astrological analysis for an eclipse.\n\nReturns nakshatra, rashi, affected signs, predictions by rashi,\nremedies, and mantras.\n\nArgs:\n date: Eclipse date (YYYY-MM-DD)\n category: 'solar' or 'lunar'","operationId":"get_eclipse_astrology_api_v1_eclipse_astrology__date__get","parameters":[{"required":true,"schema":{"type":"string","title":"Date"},"name":"date","in":"path"},{"description":"'solar' or 'lunar'","required":true,"schema":{"type":"string","title":"Category","description":"'solar' or 'lunar'"},"name":"category","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/samagama/search":{"get":{"tags":["Astronomical"],"summary":"Search Samagama","description":"Gatherings and wars, with what each says to a rashi and what to do about it.\n\nEvents OVERLAPPING the window are returned, not only those beginning inside it:\na yuti that started three weeks ago and runs another two is the most useful row\non the page, and ``in_force`` marks it.","operationId":"search_samagama_api_v1_samagama_search_get","parameters":[{"description":"month | year | three_years | rare. `rare` ignores dates and returns the next of each long-period event","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/SamagamaPeriod"}],"description":"month | year | three_years | rare. `rare` ignores dates and returns the next of each long-period event","default":"year"},"name":"period","in":"query"},{"description":"YYYY-MM-DD; overrides the period's start","required":false,"schema":{"type":"string","title":"Start Date","description":"YYYY-MM-DD; overrides the period's start"},"name":"start_date","in":"query"},{"description":"YYYY-MM-DD; overrides the period's end","required":false,"schema":{"type":"string","title":"End Date","description":"YYYY-MM-DD; overrides the period's end"},"name":"end_date","in":"query"},{"description":"Comma-separated: yuti, kutami, yuddha. Default all three","required":false,"schema":{"type":"string","title":"Categories","description":"Comma-separated: yuti, kutami, yuddha. Default all three"},"name":"categories","in":"query"},{"description":"The Moon conjoins something nearly every week; off by default so the list is news rather than traffic","required":false,"schema":{"type":"boolean","title":"Include Moon","description":"The Moon conjoins something nearly every week; off by default so the list is news rather than traffic","default":false},"name":"include_moon","in":"query"},{"description":"Read every event for this janma rashi","required":false,"schema":{"type":"string","title":"Rashi","description":"Read every event for this janma rashi"},"name":"rashi","in":"query"},{"description":"Include all twelve readings per event","required":false,"schema":{"type":"boolean","title":"All Rashis","description":"Include all twelve readings per event","default":false},"name":"all_rashis","in":"query"},{"description":"Sidereal frame; same-rashi membership depends on it","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal frame; same-rashi membership depends on it"},"name":"ayanamsa","in":"query"},{"description":"'mean' (default) or 'true' Rahu/Ketu","required":false,"schema":{"type":"string","title":"Node Type","description":"'mean' (default) or 'true' Rahu/Ketu"},"name":"node_type","in":"query"},{"description":"Zone the period is anchored to","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Zone the period is anchored to","default":"UTC","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Limit","default":60},"name":"limit","in":"query"},{"description":"'en' or 'hi'; both come from one phrase bank","required":false,"schema":{"type":"string","title":"Language","description":"'en' or 'hi'; both come from one phrase bank","default":"en"},"name":"language","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamagamaSearchResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/occultation/next":{"get":{"tags":["Astronomical"],"summary":"Next Occultations","description":"Occultations of the grahas by the Moon, with what each says to a rashi.\n\nEvery row carries the GLOBAL maximum. ``local`` and its contact times are\npresent only for the ones this place sees; for the rest ``why_not`` says so and\nthe central point says where they are seen instead. The classical readings are\nomens taken from the sight, so an occultation below this horizon is reported as\nastronomy and scored down rather than dressed as a prediction.","operationId":"next_occultations_api_v1_occultation_next_get","parameters":[{"description":"Observer latitude; without it only the global answer is given","required":false,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Observer latitude; without it only the global answer is given"},"name":"latitude","in":"query"},{"required":false,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"required":false,"schema":{"type":"number","maximum":9000.0,"minimum":-500.0,"title":"Altitude Metres","default":0.0},"name":"altitude_metres","in":"query"},{"description":"Years to search. From one city these are rare, so the default is years and not months","required":false,"schema":{"type":"integer","maximum":45.0,"minimum":1.0,"title":"Horizon Years","description":"Years to search. From one city these are rare, so the default is years and not months","default":15},"name":"horizon_years","in":"query"},{"description":"YYYY-MM-DD; defaults to now","required":false,"schema":{"type":"string","title":"Start Date","description":"YYYY-MM-DD; defaults to now"},"name":"start_date","in":"query"},{"description":"Comma-separated grahas: Mercury, Venus, Mars, Jupiter, Saturn","required":false,"schema":{"type":"string","title":"Bodies","description":"Comma-separated grahas: Mercury, Venus, Mars, Jupiter, Saturn"},"name":"bodies","in":"query"},{"description":"Nakshatra junction stars, where a catalogue for them exists; what is missing is listed in `notes`","required":false,"schema":{"type":"boolean","title":"Include Stars","description":"Nakshatra junction stars, where a catalogue for them exists; what is missing is listed in `notes`","default":true},"name":"include_stars","in":"query"},{"description":"Only what this place actually sees. Off by default: the ones it misses are why it misses them","required":false,"schema":{"type":"boolean","title":"Visible Only","description":"Only what this place actually sees. Off by default: the ones it misses are why it misses them","default":false},"name":"visible_only","in":"query"},{"description":"Read every graha occultation for this janma rashi","required":false,"schema":{"type":"string","title":"Rashi","description":"Read every graha occultation for this janma rashi"},"name":"rashi","in":"query"},{"description":"Include all twelve readings per event","required":false,"schema":{"type":"boolean","title":"All Rashis","description":"Include all twelve readings per event","default":false},"name":"all_rashis","in":"query"},{"description":"Sidereal frame the rashi is named in","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal frame the rashi is named in"},"name":"ayanamsa","in":"query"},{"description":"'mean' (default) or 'true' Rahu/Ketu","required":false,"schema":{"type":"string","title":"Node Type","description":"'mean' (default) or 'true' Rahu/Ketu"},"name":"node_type","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Limit","default":40},"name":"limit","in":"query"},{"description":"'en' or 'hi'; both come from one phrase bank","required":false,"schema":{"type":"string","title":"Language","description":"'en' or 'hi'; both come from one phrase bank","default":"en"},"name":"language","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OccultationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/sandhi/daily":{"get":{"tags":["Astronomical"],"summary":"Get Daily Sandhi Report","description":"Get complete Sandhi (transition period) report for a day.\n\nReturns all Tithi, Nakshatra, Rashi, Yoga, and Karana Sandhis for the day,\nincluding Gandanta and Abhukta Mula detection.\n\nArgs:\n date: Date to analyze (YYYY-MM-DD)\n latitude: Location latitude (-90 to 90)\n longitude: Location longitude (-180 to 180)\n timezone: Timezone string (default: UTC)","operationId":"get_daily_sandhi_report_api_v1_sandhi_daily_get","parameters":[{"description":"Date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Date","description":"Date (YYYY-MM-DD)"},"name":"date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Daily Sandhi Report Api V1 Sandhi Daily Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/sandhi/check":{"get":{"tags":["Astronomical"],"summary":"Check Sandhi At Time","description":"Check if a specific time falls within any Sandhi period.\n\nReturns active Sandhis, severity level, and recommendations.\n\nArgs:\n datetime: Date and time to check (YYYY-MM-DD HH:MM format)\n latitude: Location latitude (-90 to 90)\n longitude: Location longitude (-180 to 180)\n types: Optional comma-separated list of Sandhi types to check","operationId":"check_sandhi_at_time_api_v1_sandhi_check_get","parameters":[{"description":"Date and time (YYYY-MM-DD HH:MM)","required":true,"schema":{"type":"string","title":"Datetime","description":"Date and time (YYYY-MM-DD HH:MM)"},"name":"datetime","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Comma-separated Sandhi types to check (tithi,nakshatra,rashi,yoga,karana)","required":false,"schema":{"type":"string","title":"Types","description":"Comma-separated Sandhi types to check (tithi,nakshatra,rashi,yoga,karana)"},"name":"types","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/sandhi/gandanta":{"get":{"tags":["Astronomical"],"summary":"Find Gandanta Periods","description":"Find all Gandanta (water-fire sign junction) periods in a date range.\n\nGandanta is considered highly inauspicious as it represents the\njunction between water signs (Cancer, Scorpio, Pisces) and\nfire signs (Leo, Sagittarius, Aries).\n\nArgs:\n start_date: Start of search period (YYYY-MM-DD)\n end_date: End of search period (YYYY-MM-DD)\n latitude: Location latitude\n longitude: Location longitude","operationId":"find_gandanta_periods_api_v1_sandhi_gandanta_get","parameters":[{"description":"Start date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Start Date","description":"Start date (YYYY-MM-DD)"},"name":"start_date","in":"query"},{"description":"End date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"End Date","description":"End date (YYYY-MM-DD)"},"name":"end_date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/sandhi/tithi":{"get":{"tags":["Astronomical"],"summary":"Get Tithi Sandhis","description":"Get Tithi Sandhi (lunar day junction) periods for a specific date.\n\nTithi Sandhi occurs at the junction between two tithis (lunar days).\n\nArgs:\n date: Date to analyze (YYYY-MM-DD)\n latitude: Location latitude\n longitude: Location longitude\n timezone: Timezone the date is stated in (default: UTC)","operationId":"get_tithi_sandhis_api_v1_sandhi_tithi_get","parameters":[{"description":"Date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Date","description":"Date (YYYY-MM-DD)"},"name":"date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/sandhi/nakshatra":{"get":{"tags":["Astronomical"],"summary":"Get Nakshatra Sandhis","description":"Get Nakshatra Sandhi (lunar mansion junction) periods for a specific date.\n\nIncludes detection of Abhukta Mula - the most inauspicious nakshatra junction\noccurring at the Jyeshtha-Mula transition.\n\nArgs:\n date: Date to analyze (YYYY-MM-DD)\n latitude: Location latitude\n longitude: Location longitude\n timezone: Timezone the date is stated in (default: UTC)","operationId":"get_nakshatra_sandhis_api_v1_sandhi_nakshatra_get","parameters":[{"description":"Date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Date","description":"Date (YYYY-MM-DD)"},"name":"date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/sandhi/rashi":{"get":{"tags":["Astronomical"],"summary":"Get Rashi Sandhis","description":"Get Rashi Sandhi (sign junction) periods for a specific date.\n\nRashi Sandhi includes Gandanta - the highly inauspicious water-fire\nsign junctions (Pisces-Aries, Cancer-Leo, Scorpio-Sagittarius).\n\nArgs:\n date: Date to analyze (YYYY-MM-DD)\n latitude: Location latitude\n longitude: Location longitude\n timezone: Timezone the date is stated in (default: UTC)","operationId":"get_rashi_sandhis_api_v1_sandhi_rashi_get","parameters":[{"description":"Date (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Date","description":"Date (YYYY-MM-DD)"},"name":"date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/sandhi/types":{"get":{"tags":["Astronomical"],"summary":"Get Sandhi Types","description":"Get information about all Sandhi types.\n\nReturns descriptions, durations, and severity levels for each Sandhi type.","operationId":"get_sandhi_types_api_v1_sandhi_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/combustion/report":{"get":{"tags":["Astronomical"],"summary":"Get Combustion Report","description":"Get complete combustion analysis for a given local date/time.\n\nReturns all combust planets with their states, severities, and effects.\n\nCombustion occurs when a planet gets too close to the Sun:\n- Moon: within 12°\n- Mars: within 17°\n- Mercury: within 12-14° (depending on retrograde)\n- Jupiter: within 11°\n- Venus: within 8-10° (depending on retrograde)\n- Saturn: within 15°\n\nSpecial case - Cazimi: Within 17 arcminutes (0.283°), the planet\nis actually strengthened by being in the \"heart of the Sun\".\n\nArgs:\n datetime: Local date and time to analyze\n latitude: Location latitude\n longitude: Location longitude\n timezone: IANA timezone of that local civil time","operationId":"get_combustion_report_api_v1_combustion_report_get","parameters":[{"description":"Local date and time (YYYY-MM-DD HH:MM)","required":true,"schema":{"type":"string","title":"Datetime","description":"Local date and time (YYYY-MM-DD HH:MM)"},"name":"datetime","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Combustion Report Api V1 Combustion Report Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/combustion/check/{planet}":{"get":{"tags":["Astronomical"],"summary":"Check Planet Combustion","description":"Check combustion status of a specific planet.\n\nArgs:\n planet: Planet name (Moon, Mars, Mercury, Jupiter, Venus, Saturn)\n datetime: Local date and time to check\n latitude: Location latitude\n longitude: Location longitude\n timezone: IANA timezone of that local civil time","operationId":"check_planet_combustion_api_v1_combustion_check__planet__get","parameters":[{"required":true,"schema":{"type":"string","title":"Planet"},"name":"planet","in":"path"},{"description":"Local date and time (YYYY-MM-DD HH:MM)","required":true,"schema":{"type":"string","title":"Datetime","description":"Local date and time (YYYY-MM-DD HH:MM)"},"name":"datetime","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/combustion/periods/{planet}":{"get":{"tags":["Astronomical"],"summary":"Find Combustion Periods","description":"Find all combustion periods for a planet in a date range.\n\nReturns detailed information about each combustion period including\nstart, end, exact conjunction time, and duration.\n\nArgs:\n planet: Planet name (Moon, Mars, Mercury, Jupiter, Venus, Saturn)\n start_date: Start of search period (YYYY-MM-DD)\n end_date: End of search period (YYYY-MM-DD)\n latitude: Location latitude\n longitude: Location longitude\n timezone: IANA timezone of those local civil dates","operationId":"find_combustion_periods_api_v1_combustion_periods__planet__get","parameters":[{"required":true,"schema":{"type":"string","title":"Planet"},"name":"planet","in":"path"},{"description":"Start date (YYYY-MM-DD), local","required":true,"schema":{"type":"string","title":"Start Date","description":"Start date (YYYY-MM-DD), local"},"name":"start_date","in":"query"},{"description":"End date (YYYY-MM-DD), local","required":true,"schema":{"type":"string","title":"End Date","description":"End date (YYYY-MM-DD), local"},"name":"end_date","in":"query"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/combustion/yearly/{year}":{"get":{"tags":["Astronomical"],"summary":"Get Yearly Combustion Calendar","description":"Get yearly calendar of all combustion events.\n\nReturns combustion periods for all planets throughout the year,\ntotal days each planet is combust, and safe periods.\n\nArgs:\n year: Year to analyze (e.g., 2024)\n latitude: Location latitude\n longitude: Location longitude\n timezone: IANA timezone of the local calendar year","operationId":"get_yearly_combustion_calendar_api_v1_combustion_yearly__year__get","parameters":[{"required":true,"schema":{"type":"integer","title":"Year"},"name":"year","in":"path"},{"description":"Location latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Location latitude"},"name":"latitude","in":"query"},{"description":"Location longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Location longitude"},"name":"longitude","in":"query"},{"description":"Display zone; when omitted, the zone of latitude/longitude","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Display zone; when omitted, the zone of latitude/longitude","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/combustion/birth-chart":{"get":{"tags":["Astronomical"],"summary":"Analyze Birth Chart Combustion","description":"Analyze combustion in a birth chart context.\n\nProvides detailed analysis including house lord combustion,\nimpact on various life areas, dasha effects, and personalized remedies.\n\nArgs:\n datetime: Birth date and time (local civil)\n latitude: Birth latitude\n longitude: Birth longitude\n ascendant_degree: Ascendant degree in sidereal zodiac\n timezone: IANA timezone of the birth place","operationId":"analyze_birth_chart_combustion_api_v1_combustion_birth_chart_get","parameters":[{"description":"Birth date and time local (YYYY-MM-DD HH:MM)","required":true,"schema":{"type":"string","title":"Datetime","description":"Birth date and time local (YYYY-MM-DD HH:MM)"},"name":"datetime","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Latitude","description":"Birth latitude"},"name":"latitude","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Longitude","description":"Birth longitude"},"name":"longitude","in":"query"},{"description":"Ascendant degree (sidereal)","required":true,"schema":{"type":"number","title":"Ascendant Degree","description":"Ascendant degree (sidereal)"},"name":"ascendant_degree","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"Derived from the birth place's coordinates; a zone sent is replaced","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/combustion/current":{"get":{"tags":["Astronomical"],"summary":"Get Current Combustion Status","description":"Get current combustion status for all planets.\n\nQuick endpoint to check which planets are currently combust.","operationId":"get_current_combustion_status_api_v1_combustion_current_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/combustion/orbs":{"get":{"tags":["Astronomical"],"summary":"Get Combustion Orbs","description":"Get combustion orb information for all planets.\n\nReturns the degree thresholds for each planet to be considered combust.","operationId":"get_combustion_orbs_api_v1_combustion_orbs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/predictions/daily":{"post":{"tags":["Predictions"],"summary":"Get Personalized Daily Prediction","description":"Get personalized daily prediction based on birth chart.\n\nThis provides a comprehensive daily forecast that combines:\n- Current planetary transits over natal positions\n- Running Dasha/Antardasha influences\n- Yoga activations for the day\n- Life area specific predictions (career, finance, relationships, health)\n- Auspicious timing and lucky elements\n\nUnlike generic sign-based horoscopes, this uses your exact birth details\nfor truly personalized predictions.\n\nArgs:\n request: Birth details and optional prediction date\n\nReturns:\n Comprehensive personalized daily prediction","operationId":"get_personalized_daily_prediction_api_v1_predictions_daily_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedPredictionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedDailyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/predictions/daily/simple":{"get":{"tags":["Predictions"],"summary":"Get Simple Daily Prediction","description":"Get personalized daily prediction using query parameters.\n\nSimplified endpoint for easy integration. Use the POST endpoint\nfor full functionality.\n\nExample:\n /predictions/daily/simple?dob=1990-05-15&tob=10:30&lat=28.6139&lon=77.2090","operationId":"get_simple_daily_prediction_api_v1_predictions_daily_simple_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"description":"Date for prediction (YYYY-MM-DD)","required":false,"schema":{"type":"string","title":"Prediction Date","description":"Date for prediction (YYYY-MM-DD)"},"name":"prediction_date","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/predictions/weekly":{"post":{"tags":["Predictions"],"summary":"Get Personalized Weekly Prediction","description":"Get personalized weekly prediction based on birth chart.\n\nProvides comprehensive weekly forecast including:\n- Day-by-day rating breakdown\n- Best and challenging days identification\n- Weekly theme and summary\n- Life area predictions for the week\n- Important transits affecting the week\n\nArgs:\n request: Birth details and optional start date\n\nReturns:\n Comprehensive personalized weekly prediction","operationId":"get_personalized_weekly_prediction_api_v1_predictions_weekly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeeklyPredictionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedWeeklyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/predictions/weekly/simple":{"get":{"tags":["Predictions"],"summary":"Get Simple Weekly Prediction","description":"Get personalized weekly prediction using query parameters.","operationId":"get_simple_weekly_prediction_api_v1_predictions_weekly_simple_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"description":"Week start date (YYYY-MM-DD)","required":false,"schema":{"type":"string","title":"Start Date","description":"Week start date (YYYY-MM-DD)"},"name":"start_date","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/predictions/monthly":{"post":{"tags":["Predictions"],"summary":"Get Personalized Monthly Prediction","description":"Get personalized monthly prediction based on birth chart.\n\n**Requires: PREMIUM subscription tier**\n\nProvides comprehensive monthly forecast including:\n- Week-by-week breakdown\n- Auspicious and challenging dates\n- Moon phase effects\n- Detailed life area forecasts\n- Timing guidance for important activities\n- Monthly remedies\n\nArgs:\n request: Birth details, month, and year\n\nReturns:\n Comprehensive personalized monthly prediction","operationId":"get_personalized_monthly_prediction_api_v1_predictions_monthly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonthlyPredictionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedMonthlyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/predictions/monthly/simple":{"get":{"tags":["Predictions"],"summary":"Get Simple Monthly Prediction","description":"Get personalized monthly prediction using query parameters.","operationId":"get_simple_monthly_prediction_api_v1_predictions_monthly_simple_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"description":"Month (1-12)","required":false,"schema":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month","description":"Month (1-12)"},"name":"month","in":"query"},{"description":"Year","required":false,"schema":{"type":"integer","maximum":9999.0,"minimum":1.0,"title":"Year","description":"Year"},"name":"year","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/predictions/yearly":{"post":{"tags":["Predictions"],"summary":"Get Personalized Yearly Prediction","description":"Get personalized yearly prediction (Varshik Rashifal) based on birth chart.\n\n**Requires: PREMIUM subscription tier**\n\nProvides comprehensive yearly forecast including:\n- Overall year score and theme\n- Quarterly breakdown\n- Major planetary transit analysis (Saturn, Jupiter, Rahu-Ketu)\n- Eclipse impacts\n- Detailed life area forecasts for the year\n- Best and challenging months\n- Yoga activations\n- Lucky elements (numbers, colors, gemstones, days)\n- Comprehensive remedies and mantras\n\nThis is the most detailed prediction, personalized to your exact birth chart\nrather than just your sun/moon sign.\n\nArgs:\n request: Birth details and year\n\nReturns:\n Comprehensive personalized yearly prediction","operationId":"get_personalized_yearly_prediction_api_v1_predictions_yearly_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YearlyPredictionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedYearlyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/predictions/yearly/simple":{"get":{"tags":["Predictions"],"summary":"Get Simple Yearly Prediction","description":"Get personalized yearly prediction using query parameters.","operationId":"get_simple_yearly_prediction_api_v1_predictions_yearly_simple_get","parameters":[{"description":"Date of birth (YYYY-MM-DD)","required":true,"schema":{"type":"string","title":"Dob","description":"Date of birth (YYYY-MM-DD)"},"name":"dob","in":"query"},{"description":"Time of birth (HH:MM)","required":true,"schema":{"type":"string","title":"Tob","description":"Time of birth (HH:MM)"},"name":"tob","in":"query"},{"description":"Birth latitude","required":true,"schema":{"type":"number","title":"Lat","description":"Birth latitude"},"name":"lat","in":"query"},{"description":"Birth longitude","required":true,"schema":{"type":"number","title":"Lon","description":"Birth longitude"},"name":"lon","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","title":"Tz","description":"Derived from the birth place's coordinates; a zone sent is replaced"},"name":"tz","in":"query"},{"description":"Year for prediction","required":false,"schema":{"type":"integer","maximum":9999.0,"minimum":1.0,"title":"Year","description":"Year for prediction"},"name":"year","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/predictions/transit-analysis":{"post":{"tags":["Predictions"],"summary":"Get Transit Analysis","description":"Get detailed transit analysis for a specific date.\n\n**Requires: PREMIUM subscription tier**\n\nAnalyzes how current planetary transits affect your natal chart:\n- Transit positions of all planets\n- Aspects between transit and natal planets\n- House transits from Moon\n- Saturn transit analysis (Sade Sati, Ashtama Shani, etc.)\n- Jupiter transit analysis\n- Rahu-Ketu axis effects\n\nUseful for understanding current cosmic influences on your life.","operationId":"get_transit_analysis_api_v1_predictions_transit_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitAnalysisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/predictions/current-influences":{"post":{"tags":["Predictions"],"summary":"Get Current Influences","description":"Get all current astrological influences affecting you.\n\nA quick overview of:\n- Current running Dasha/Antardasha\n- Transit summary\n- Active yoga energies\n- Key influences at play\n- Overall energy assessment\n- Immediate actionable advice\n\nPerfect for a quick check of current cosmic weather affecting you.","operationId":"get_current_influences_api_v1_predictions_current_influences_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizedPredictionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrentInfluencesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/predictions/guide":{"get":{"tags":["Predictions"],"summary":"Get Predictions Guide","description":"Get guide for understanding personalized predictions.\n\nExplains the different components of the prediction system.","operationId":"get_predictions_guide_api_v1_predictions_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/predictions/dasha-info":{"get":{"tags":["Predictions"],"summary":"Get Dasha Information","description":"Get information about Vimshottari Dasha system.","operationId":"get_dasha_information_api_v1_predictions_dasha_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/chart/{user_id}":{"post":{"tags":["Voice"],"summary":"Set birth chart","description":"Set a user's birth chart for personalized audio horoscopes.\n\nPersonalized readings include Moon sign emotional needs\nand Ascendant approach guidance.","operationId":"set_chart_api_v1_voice_horoscope_chart__user_id__post","parameters":[{"required":true,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__routers__voice_horoscope__ChartInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/voice-horoscope/preferences/{user_id}":{"get":{"tags":["Voice"],"summary":"Get voice preferences","description":"Get user's current voice preferences.","operationId":"get_preferences_api_v1_voice_horoscope_preferences__user_id__get","parameters":[{"required":true,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"post":{"tags":["Voice"],"summary":"Set voice preferences","description":"Set user's voice preferences for audio readings.\n\nOptions include:\n- Voice type (female_calm, male_deep, etc.)\n- Language (en-US, en-UK, en-IN, hi-IN, etc.)\n- Audio format (mp3, wav, ogg)\n- Speech rate (0.5 to 2.0)","operationId":"set_preferences_api_v1_voice_horoscope_preferences__user_id__post","parameters":[{"required":true,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoicePreferencesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/voice-horoscope/horoscope/{sign}":{"get":{"tags":["Voice"],"summary":"Get audio horoscope","description":"Generate audio horoscope for a zodiac sign.\n\nReturns both text content and base64-encoded audio data.\nUse user_id for personalized readings based on birth chart.","operationId":"get_audio_horoscope_api_v1_voice_horoscope_horoscope__sign__get","parameters":[{"required":true,"schema":{"type":"string","title":"Sign"},"name":"sign","in":"path"},{"description":"daily, weekly, monthly, yearly","required":false,"schema":{"type":"string","title":"Period","description":"daily, weekly, monthly, yearly","default":"daily"},"name":"period","in":"query"},{"description":"general, love, career, health, finance, spiritual","required":false,"schema":{"type":"string","title":"Reading Type","description":"general, love, career, health, finance, spiritual","default":"general"},"name":"reading_type","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"required":false,"schema":{"$ref":"#/components/schemas/VoiceType"},"name":"voice","in":"query"},{"required":false,"schema":{"$ref":"#/components/schemas/VoiceLanguage"},"name":"language","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/horoscope/{sign}/audio":{"get":{"tags":["Voice"],"summary":"Get audio file directly","description":"Get the audio file directly (for streaming/download).\n\nReturns the audio data as a binary response.","operationId":"get_audio_file_api_v1_voice_horoscope_horoscope__sign__audio_get","parameters":[{"required":true,"schema":{"type":"string","title":"Sign"},"name":"sign","in":"path"},{"required":false,"schema":{"type":"string","title":"Period","default":"daily"},"name":"period","in":"query"},{"required":false,"schema":{"type":"string","title":"Reading Type","default":"general"},"name":"reading_type","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"required":false,"schema":{"$ref":"#/components/schemas/VoiceType"},"name":"voice","in":"query"},{"required":false,"schema":{"$ref":"#/components/schemas/VoiceLanguage"},"name":"language","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/horoscope/{sign}/text":{"get":{"tags":["Voice"],"summary":"Get text only","description":"Get just the text content without generating audio.\n\nUseful for displaying text alongside audio or for\nusers who prefer reading.","operationId":"get_text_only_api_v1_voice_horoscope_horoscope__sign__text_get","parameters":[{"required":true,"schema":{"type":"string","title":"Sign"},"name":"sign","in":"path"},{"required":false,"schema":{"type":"string","title":"Period","default":"daily"},"name":"period","in":"query"},{"required":false,"schema":{"type":"string","title":"Reading Type","default":"general"},"name":"reading_type","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/all-signs":{"get":{"tags":["Voice"],"summary":"Get all signs horoscopes","description":"Generate horoscope audio for all 12 zodiac signs.\n\nReturns summary info for each sign (without full audio data).\nFetch individual readings for audio content.","operationId":"get_all_signs_api_v1_voice_horoscope_all_signs_get","parameters":[{"required":false,"schema":{"type":"string","title":"Period","default":"daily"},"name":"period","in":"query"},{"required":false,"schema":{"type":"string","title":"Reading Type","default":"general"},"name":"reading_type","in":"query"},{"required":false,"schema":{"$ref":"#/components/schemas/VoiceType"},"name":"voice","in":"query"},{"required":false,"schema":{"$ref":"#/components/schemas/VoiceLanguage"},"name":"language","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/reading/{reading_id}/text":{"get":{"tags":["Voice"],"summary":"Get reading text by ID","description":"Get the text content of a previously generated reading.","operationId":"get_reading_text_api_v1_voice_horoscope_reading__reading_id__text_get","parameters":[{"required":true,"schema":{"type":"string","title":"Reading Id"},"name":"reading_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/signs":{"get":{"tags":["Voice"],"summary":"List all signs","description":"List all zodiac signs with their rulers and elements.","operationId":"list_signs_api_v1_voice_horoscope_signs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/voices":{"get":{"tags":["Voice"],"summary":"List voice options","description":"List all available voice types.","operationId":"list_voices_api_v1_voice_horoscope_voices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/languages":{"get":{"tags":["Voice"],"summary":"List languages","description":"List all supported languages.","operationId":"list_languages_api_v1_voice_horoscope_languages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/periods":{"get":{"tags":["Voice"],"summary":"List horoscope periods","description":"List all horoscope time periods.","operationId":"list_periods_api_v1_voice_horoscope_periods_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/reading-types":{"get":{"tags":["Voice"],"summary":"List reading types","description":"List all reading types/categories.","operationId":"list_reading_types_api_v1_voice_horoscope_reading_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/formats":{"get":{"tags":["Voice"],"summary":"List audio formats","description":"List supported audio output formats.","operationId":"list_formats_api_v1_voice_horoscope_formats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/status":{"get":{"tags":["Voice"],"summary":"Service status","description":"Get voice horoscope service status.","operationId":"get_status_api_v1_voice_horoscope_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/voice-horoscope/about":{"get":{"tags":["Voice"],"summary":"About Voice Horoscope","description":"Information about the Voice Horoscope feature.","operationId":"about_api_v1_voice_horoscope_about_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/tts/status":{"get":{"tags":["Voice"],"summary":"TTS engine status","operationId":"tts_status_api_v1_tts_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSStatusResponse"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/tts/admin/horoscope-audio/health":{"get":{"tags":["Voice"],"summary":"Prepared Rashiphal audio operational readiness","description":"Report dependencies and bounded queue pressure without loading a model.","operationId":"prepared_horoscope_audio_health_api_v1_tts_admin_horoscope_audio_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/tts/voices":{"get":{"tags":["Voice"],"summary":"List voices for every registered engine","operationId":"list_tts_voices_api_v1_tts_voices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/tts/admin/engines":{"get":{"tags":["Voice"],"summary":"List present and unavailable TTS engines","operationId":"admin_list_engines_api_v1_tts_admin_engines_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/tts/admin/assignments":{"get":{"tags":["Voice"],"summary":"List TTS assignments","operationId":"admin_list_assignments_api_v1_tts_admin_assignments_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSAssignmentListResponse"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"},"put":{"tags":["Voice"],"summary":"Impose a present TTS engine on all users or a locale","operationId":"admin_impose_assignment_api_v1_tts_admin_assignments_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSAssignmentUpsert"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSAssignmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/tts/admin/assignments/{assignment_id}":{"delete":{"tags":["Voice"],"summary":"Drop a locale TTS override","operationId":"admin_delete_assignment_api_v1_tts_admin_assignments__assignment_id__delete","parameters":[{"required":true,"schema":{"type":"integer","title":"Assignment Id"},"name":"assignment_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/tts/admin/settings":{"get":{"tags":["Voice"],"summary":"Get the all-users TTS assignment","operationId":"get_tts_settings_api_v1_tts_admin_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSSettingsResponse"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"},"patch":{"tags":["Voice"],"summary":"Impose a Pocket TTS voice on all users","operationId":"update_tts_settings_api_v1_tts_admin_settings_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSSettingsUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSSettingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/tts/admin/preview":{"post":{"tags":["Voice"],"summary":"Preview a voice without changing assignments","operationId":"preview_tts_voice_api_v1_tts_admin_preview_post","parameters":[{"required":false,"schema":{"type":"string","title":"Voice"},"name":"voice","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSSpeakResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/tts/speak":{"post":{"tags":["Voice"],"summary":"Synthesize speech with the assignment for this user","operationId":"speak_text_api_v1_tts_speak_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSSpeakRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSSpeakResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/tts/horoscope/daily/{sign}/audio":{"get":{"tags":["Voice"],"summary":"Stream prepared daily Rashiphal audio","description":"Return audio only when it matches the exact visible reading script.","operationId":"prepared_daily_horoscope_audio_api_v1_tts_horoscope_daily__sign__audio_get","parameters":[{"required":true,"schema":{"type":"string","title":"Sign"},"name":"sign","in":"path"},{"required":true,"schema":{"type":"string","format":"date","title":"Date"},"name":"date","in":"query"},{"required":true,"schema":{"type":"string","maxLength":8,"minLength":2,"title":"Locale"},"name":"locale","in":"query"},{"required":true,"schema":{"type":"string","maxLength":64,"minLength":64,"title":"Content Hash"},"name":"content_hash","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/tts/horoscope/daily/{sign}/audio/prepare":{"post":{"tags":["Voice"],"summary":"Prepare an exact daily Rashiphal audio variant","description":"Deduplicate one final narration across users, places and profiles.","operationId":"prepare_daily_horoscope_audio_variant_api_v1_tts_horoscope_daily__sign__audio_prepare_post","parameters":[{"required":true,"schema":{"type":"string","title":"Sign"},"name":"sign","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyHoroscopeAudioPrepareRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/tts/horoscope/daily/{sign}/audio/status":{"get":{"tags":["Voice"],"summary":"Get exact daily Rashiphal audio preparation status","description":"Expose durable progress without leaking worker exception details.","operationId":"daily_horoscope_audio_status_api_v1_tts_horoscope_daily__sign__audio_status_get","parameters":[{"required":true,"schema":{"type":"string","title":"Sign"},"name":"sign","in":"path"},{"required":true,"schema":{"type":"string","format":"date","title":"Date"},"name":"date","in":"query"},{"required":true,"schema":{"type":"string","maxLength":8,"minLength":2,"title":"Locale"},"name":"locale","in":"query"},{"required":true,"schema":{"type":"string","maxLength":64,"minLength":64,"title":"Content Hash"},"name":"content_hash","in":"query"},{"required":true,"schema":{"type":"string","maxLength":67,"minLength":67,"title":"Authorization"},"name":"authorization","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Personalization & Output","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/personal/overview":{"post":{"tags":["Calendar"],"summary":"Personal Calendar","description":"Calculate a personal calendar from supplied signs without storing them.\n\nNo account ids or saved chart records are read on this route. The caller\nsupplies the selected chart, so household changes and parallel tabs cannot\noverwrite another person's calendar. At most 31 days are computed.","operationId":"personal_calendar_api_v1_astro_calendar_personal_overview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalCalendarRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalCalendarOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/astro-calendar/personal/meeting-times":{"post":{"tags":["Calendar"],"summary":"Personal Meeting Times","description":"Working-hour windows outside Rahu Kaal; no booking or calendar write.","operationId":"personal_meeting_times_api_v1_astro_calendar_personal_meeting_times_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalMeetingRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingTimeOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/astro-calendar/chart":{"post":{"tags":["Calendar"],"summary":"Set User Chart","description":"Set birth chart for personalized calendar recommendations\n\nOnce set, all calendar suggestions will be tailored to your chart. Charts\nare stored in Postgres and shared by every API worker.","operationId":"set_user_chart_api_v1_astro_calendar_chart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__routers__astro_calendar__SetChartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetChartOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/astro-calendar/day/{target_date}":{"get":{"tags":["Calendar"],"summary":"Analyze Day","description":"Get comprehensive astrological analysis for a specific day\n\nReturns:\n- Day quality and score\n- Panchang elements (tithi, paksha, nakshatra, moon sign) read at sunrise\n- Sunrise and sunset for the requested place\n- Favorable/unfavorable activities\n- Rahu Kaal, as the eighth of the daylight span the weekday names\n- Personal insights (if chart provided)","operationId":"analyze_day_api_v1_astro_calendar_day__target_date__get","parameters":[{"description":"Date to analyze (YYYY-MM-DD)","required":true,"schema":{"type":"string","format":"date","title":"Target Date","description":"Date to analyze (YYYY-MM-DD)"},"name":"target_date","in":"path"},{"description":"Latitude of the place","required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Latitude of the place"},"name":"latitude","in":"query"},{"description":"Longitude of the place","required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Longitude of the place"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DayAnalysisOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/today":{"get":{"tags":["Calendar"],"summary":"Analyze Today","description":"Get astrological analysis for today, in the requested timezone.","operationId":"analyze_today_api_v1_astro_calendar_today_get","parameters":[{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DayAnalysisOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/tomorrow":{"get":{"tags":["Calendar"],"summary":"Analyze Tomorrow","description":"Get astrological analysis for tomorrow, in the requested timezone.","operationId":"analyze_tomorrow_api_v1_astro_calendar_tomorrow_get","parameters":[{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DayAnalysisOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/find-favorable-days":{"post":{"tags":["Calendar"],"summary":"Find Favorable Days","description":"Find favorable days for a specific activity\n\nEvery day in the range is scored, then ranked; the response reports how\nmany days were examined and how many cleared the threshold.\n\nActivities: interview, meeting, presentation, contract, travel,\ninvestment, medical, wedding, house_purchase, vehicle_purchase,\nnew_venture, exam, spiritual, relationship, legal, general","operationId":"find_favorable_days_api_v1_astro_calendar_find_favorable_days_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindFavorableDaysRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavorableDaysOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/astro-calendar/favorable/{activity}":{"get":{"tags":["Calendar"],"summary":"Quick Find Favorable","description":"Quick search for favorable days starting from today\n\nShortcut for find_favorable_days with today as start date.","operationId":"quick_find_favorable_api_v1_astro_calendar_favorable__activity__get","parameters":[{"description":"Activity type","required":true,"schema":{"allOf":[{"$ref":"#/components/schemas/ActivityType"}],"description":"Activity type"},"name":"activity","in":"path"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Days to search ahead","required":false,"schema":{"type":"integer","maximum":90.0,"minimum":7.0,"title":"Days Ahead","description":"Days to search ahead","default":30},"name":"days_ahead","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavorableDaysOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/month/{year}/{month}":{"get":{"tags":["Calendar"],"summary":"Get Monthly Calendar","description":"Get astrological calendar for a month\n\nReturns quality ratings for each day, plus summary of best days.","operationId":"get_monthly_calendar_api_v1_astro_calendar_month__year___month__get","parameters":[{"description":"Year","required":true,"schema":{"type":"integer","maximum":2100.0,"minimum":2020.0,"title":"Year","description":"Year"},"name":"year","in":"path"},{"description":"Month","required":true,"schema":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month","description":"Month"},"name":"month","in":"path"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonthlyCalendarOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/this-month":{"get":{"tags":["Calendar"],"summary":"Get This Month","description":"Get calendar for the current month where the caller is.","operationId":"get_this_month_api_v1_astro_calendar_this_month_get","parameters":[{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonthlyCalendarOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/power-days/{user_id}":{"get":{"tags":["Calendar"],"summary":"Get Power Days","description":"Get personal power days based on birth chart\n\nPower days are when planetary transits strongly favor your chart.\nBest for important decisions and new initiatives.","operationId":"get_power_days_api_v1_astro_calendar_power_days__user_id__get","parameters":[{"required":true,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"path"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Days to look ahead","required":false,"schema":{"type":"integer","maximum":90.0,"minimum":7.0,"title":"Days Ahead","description":"Days to look ahead","default":30},"name":"days_ahead","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PowerDaysOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/suggest-meeting-time":{"post":{"tags":["Calendar"],"summary":"Suggest Meeting Time","description":"Get optimal meeting time suggestions for a date\n\nAvoids Rahu Kaal and reports the day's first planetary hora, which begins\nat sunrise rather than at a fixed hour.","operationId":"suggest_meeting_time_api_v1_astro_calendar_suggest_meeting_time_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingTimeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingTimeOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/astro-calendar/week":{"get":{"tags":["Calendar"],"summary":"Get Weekly Overview","description":"Get astrological overview for the week\n\nReturns daily quality ratings and highlights for planning.","operationId":"get_weekly_overview_api_v1_astro_calendar_week_get","parameters":[{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"Week start date (defaults to today)","required":false,"schema":{"type":"string","format":"date","title":"Start Date","description":"Week start date (defaults to today)"},"name":"start_date","in":"query"},{"required":false,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeeklyOverviewOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/rahu-kaal/today":{"get":{"tags":["Calendar"],"summary":"Get Rahu Kaal Today","description":"Get Rahu Kaal timing for today, where the caller is.","operationId":"get_rahu_kaal_today_api_v1_astro_calendar_rahu_kaal_today_get","parameters":[{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RahuKaalDayOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/rahu-kaal/{target_date}":{"get":{"tags":["Calendar"],"summary":"Get Rahu Kaal","description":"Get Rahu Kaal timing for a specific date\n\nRahu Kaal is one eighth of the daylight span, so both its start and its\nlength depend on the date and the place. The previous fixed 90-minute\nwindows were right only on a notional 06:00-18:00 day.","operationId":"get_rahu_kaal_api_v1_astro_calendar_rahu_kaal__target_date__get","parameters":[{"description":"Date to check","required":true,"schema":{"type":"string","format":"date","title":"Target Date","description":"Date to check"},"name":"target_date","in":"path"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"description":"IANA timezone, e.g. Asia/Kolkata","required":true,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RahuKaalDayOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/activities":{"get":{"tags":["Calendar"],"summary":"Get Activity Types","description":"Get all supported activity types for scheduling.\n\nbest_weekdays was read off the service instance, where the table has never\nlived -- it is a module constant -- so the hasattr guard was always false\nand every activity advertised an empty list.","operationId":"get_activity_types_api_v1_astro_calendar_activities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivitiesOut"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/quality-levels":{"get":{"tags":["Calendar"],"summary":"Get Quality Levels","description":"Get explanation of day quality levels","operationId":"get_quality_levels_api_v1_astro_calendar_quality_levels_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QualityLevelsOut"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/astro-calendar/about":{"get":{"tags":["Calendar"],"summary":"About Astro Calendar","description":"Learn about the Astro Calendar feature","operationId":"about_astro_calendar_api_v1_astro_calendar_about_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AboutOut"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Timing & Calendar","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/kp/ayanamsa":{"get":{"tags":["KP System"],"summary":"Get Kp Ayanamsa","description":"Calculate KP Ayanamsa for a given date.\n\nDefault uses Swiss Ephemeris SIDM_KRISHNAMURTI. Linear kp_* variants remain\navailable for comparison with older tables.","operationId":"get_kp_ayanamsa_api_v1_kp_ayanamsa_get","parameters":[{"description":"Instant for ayanamsa calculation; naive datetimes are interpreted as UTC","required":true,"schema":{"type":"string","format":"date-time","title":"Date","description":"Instant for ayanamsa calculation; naive datetimes are interpreted as UTC"},"name":"date","in":"query"},{"description":"Type: swiss_krishnamurti (default), kp_old, kp_new, kp_straight_line","required":false,"schema":{"type":"string","title":"Ayanamsa Type","description":"Type: swiss_krishnamurti (default), kp_old, kp_new, kp_straight_line","default":"swiss_krishnamurti"},"name":"ayanamsa_type","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/kp/star-lord":{"post":{"tags":["KP System"],"summary":"Get Star Lord","description":"Get the Star Lord (Nakshatra Lord) for a given longitude\n\nThe Star Lord is the ruling planet of the nakshatra where the point falls.","operationId":"get_star_lord_api_v1_kp_star_lord_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanetPositionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/sub-lord":{"post":{"tags":["KP System"],"summary":"Get Sub Lord","description":"Get the Sub Lord for a given longitude\n\nThe Sub Lord is determined by dividing the nakshatra according to\nVimshottari dasha proportions.","operationId":"get_sub_lord_api_v1_kp_sub_lord_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanetPositionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/sub-sub-lord":{"post":{"tags":["KP System"],"summary":"Get Sub Sub Lord","description":"Get the Sub-Sub Lord (SSL) for a given longitude\n\nThe SSL is the finest division used in KP for precise timing.","operationId":"get_sub_sub_lord_api_v1_kp_sub_sub_lord_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanetPositionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/cuspal-sub-lords":{"post":{"tags":["KP System"],"summary":"Get Cuspal Sub Lords","description":"Calculate Sub Lords for all 12 house cusps\n\nThe cuspal sub lord is the most important factor in KP for\ndetermining house results.","operationId":"get_cuspal_sub_lords_api_v1_kp_cuspal_sub_lords_post","parameters":[{"description":"12 house cusp longitudes","required":true,"schema":{"items":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0},"type":"array","title":"House Cusps","description":"12 house cusp longitudes"},"name":"house_cusps","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/ruling-planets":{"post":{"tags":["KP System"],"summary":"Get Ruling Planets","description":"Calculate Ruling Planets at the moment of query\n\nRuling planets are used for:\n- Confirming the validity of a horary question\n- Timing predictions\n- Birth time rectification","operationId":"get_ruling_planets_api_v1_kp_ruling_planets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RulingPlanetsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/now":{"post":{"tags":["KP System"],"summary":"Get Kp Now","description":"The sky over a place right now, in KP terms: the Krishnamurti chart (Placidus\ncusps) and the ruling planets of this moment, with the moment echoed on the\nplace's own clock. The ascendant sub lord turns every few minutes, so this is\nnever cached; clients refresh it.","operationId":"get_kp_now_api_v1_kp_now_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KPNowRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/significators":{"post":{"tags":["KP System"],"summary":"Get Significators","description":"Calculate house significators for a planet\n\nCanonical 4-fold order (strongest → weakest):\n1. Houses occupied by the planet's star lord\n2. House occupied by the planet\n3. Houses owned by the planet's star lord\n4. Houses owned by the planet (dispositor for Rahu/Ketu)","operationId":"get_significators_api_v1_kp_significators_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignificatorRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/event-analysis":{"post":{"tags":["KP System"],"summary":"Analyze Event","description":"Analyze whether an event is promised by KP cuspal-sub-lord rules.\n\n**Requires: PROFESSIONAL subscription tier**\n\nPreferred input: birth details (computes KP ayanamsa + Placidus cusps).\nFallback: house_cusps + all nine planet_positions. Cusp-only and partial\nplanet charts return incomplete without timing predictions.\n\nSupported events: marriage, career, children, wealth, foreign_travel,\neducation, property, health","operationId":"analyze_event_api_v1_kp_event_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/full-analysis":{"post":{"tags":["KP System"],"summary":"Full Kp Analysis","description":"Complete KP Analysis for a birth chart\n\n**Requires: PROFESSIONAL subscription tier**\n\nReturns:\n- All planetary positions with Star/Sub/SSL lords\n- All cuspal sub lords\n- Ruling planets (if query time provided)\n- KP principles summary","operationId":"full_kp_analysis_api_v1_kp_full_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KPAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/significators-table":{"post":{"tags":["KP System"],"summary":"Kp Significators Table","description":"Complete KP significators table from birth details: computes KP-ayanamsa\nsidereal positions + Placidus cusps internally, then returns per-planet star/\nsub/sub-sub lords with the 4-fold significators, per-house significators\n(strongest→weakest), and the 12 cuspal sub-lords. Accessible (not tier-gated) —\nit is a chart-reading view, not the predictive event engine.","operationId":"kp_significators_table_api_v1_kp_significators_table_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KPSignificatorsTableRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/daily-timing":{"post":{"tags":["KP System"],"summary":"Kp Daily Timing","operationId":"kp_daily_timing_api_v1_kp_daily_timing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KPDailyTimingRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/horary":{"post":{"tags":["KP System"],"summary":"Kp Horary","description":"KP horary (Prashna): cast Krishnamurti + Placidus at the query moment and\napply cuspal-sub-lord promise rules for the chosen event type.\n\n**Requires: PROFESSIONAL subscription tier**","operationId":"kp_horary_api_v1_kp_horary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KPHoraryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/rectify":{"post":{"tags":["KP System"],"summary":"Kp Rectify","description":"KP birth-time rectification: scan a time window ranking candidates by\nruling-planet overlap with a reference query/event moment, Asc star/sub\nmatches, optional natal event promise, and Asc-sub-lord plateaus.\n\n**Requires: PROFESSIONAL subscription tier**","operationId":"kp_rectify_api_v1_kp_rectify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KPRectifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/kp/event-types":{"get":{"tags":["KP System"],"summary":"Get Event Types","description":"Get list of supported event types for KP analysis (school-aware).","operationId":"get_event_types_api_v1_kp_event_types_get","parameters":[{"description":"Event-house school: classic | extended","required":false,"schema":{"type":"string","title":"School","description":"Event-house school: classic | extended","default":"classic"},"name":"school","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/kp/principles":{"get":{"tags":["KP System"],"summary":"Get Kp Principles","description":"Get fundamental KP System principles","operationId":"get_kp_principles_api_v1_kp_principles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/jaimini/analyze":{"post":{"tags":["Jaimini"],"summary":"Jaimini Analysis","description":"Complete Jaimini astrology analysis.\n\nProvides comprehensive analysis including:\n- **7 Chara Karakas**: Significators based on planetary degrees\n - Atmakaraka (AK): Soul, self\n - Amatyakaraka (AmK): Career, profession\n - Bhratrukaraka (BK): Siblings\n - Matrukaraka (MK): Mother\n - Putrakaraka (PuK): Children\n - Gnatikaraka (GK): Relatives, diseases\n - Darakaraka (DK): Spouse\n\n- **Karakamsha**: Navamsa of Atmakaraka - reveals soul purpose\n- **Arudha Lagna (AL)**: How others perceive you\n- **Upapada Lagna (UL)**: Marriage significator\n- **Jaimini Aspects**: Sign-based aspects\n- **Argalas**: Planetary interventions","operationId":"jaimini_analysis_api_v1_jaimini_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JaiminiRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JaiminiResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/jaimini/marriage":{"post":{"tags":["Jaimini"],"summary":"Marriage Analysis","description":"Jaimini marriage analysis.\n\nUses Jaimini techniques for comprehensive marriage analysis:\n- **Upapada Lagna (UL/A12)**: Arudha of the 12th house\n- **Darakaraka**: Spouse significator (lowest degree planet)\n- **7th house analysis**: From multiple reference points\n- **Spouse characteristics**: Derived from UL and DK\n- **Marriage timing**: Based on relevant dashas\n- **Compatibility factors**: Key elements for harmony\n- **Potential challenges**: Areas to work on\n- **Remedies**: Suggestions for improvement\n\nThis is one of the most powerful Jaimini techniques for marriage prediction.","operationId":"marriage_analysis_api_v1_jaimini_marriage_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JaiminiRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarriageAnalysisResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/jaimini/career":{"post":{"tags":["Jaimini"],"summary":"Career Analysis","description":"Jaimini career analysis.\n\nUses Jaimini techniques for career and profession analysis:\n- **Amatyakaraka (AmK)**: Second highest degree planet - career significator\n- **Karma Pada (A10)**: 10th house Arudha - professional image\n- **10th from Karakamsha**: Career direction from soul level\n- **Career indications**: Fields suitable for the native\n- **Suitable professions**: Specific career suggestions\n- **Career timing**: When opportunities may arise\n- **Success factors**: Keys to professional achievement","operationId":"career_analysis_api_v1_jaimini_career_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JaiminiRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CareerAnalysisResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/jaimini/karakas":{"get":{"tags":["Jaimini"],"summary":"Get Karakas","description":"Get Jaimini Chara Karakas only.\n\nQuick endpoint to get just the 7 Chara Karakas without full analysis.\n\n**Karaka Determination:**\nPlanets are ranked by their degree within their signs.\n- Highest degree = Atmakaraka (soul significator)\n- Lowest degree = Darakaraka (spouse significator)\n\nThis endpoint uses the declared seven-karaka scheme: Sun through Saturn.","operationId":"get_karakas_api_v1_jaimini_karakas_get","parameters":[{"description":"Birth date and time","required":true,"schema":{"type":"string","format":"date-time","title":"Birth Date","description":"Birth date and time"},"name":"birth_date","in":"query"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"name":"birth_latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"name":"birth_longitude","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Birth Timezone","description":"Derived from the birth place's coordinates; a zone sent is replaced","example":"Asia/Kolkata"},"name":"birth_timezone","in":"query"},{"description":"Sidereal ayanamsa (default Lahiri)","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa (default Lahiri)"},"name":"ayanamsa","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/jaimini/karakamsha":{"get":{"tags":["Jaimini"],"summary":"Get Karakamsha","description":"Get Karakamsha analysis.\n\n**Karakamsha** = Navamsa sign of Atmakaraka\n\nThis is a crucial reference point in Jaimini astrology that reveals:\n- Soul's purpose in this life\n- Spiritual path indicated\n- Career direction from a dharmic perspective\n- Overall life direction\n\nAnalysis of planets in Karakamsha and houses from it provides\ndeep insights into the native's life purpose.","operationId":"get_karakamsha_api_v1_jaimini_karakamsha_get","parameters":[{"description":"Birth date and time","required":true,"schema":{"type":"string","format":"date-time","title":"Birth Date","description":"Birth date and time"},"name":"birth_date","in":"query"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"name":"birth_latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"name":"birth_longitude","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Birth Timezone","description":"Derived from the birth place's coordinates; a zone sent is replaced","example":"Asia/Kolkata"},"name":"birth_timezone","in":"query"},{"description":"Sidereal ayanamsa (default Lahiri)","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa (default Lahiri)"},"name":"ayanamsa","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/jaimini/arudhas":{"get":{"tags":["Jaimini"],"summary":"Get All Arudhas","description":"Get all 12 Arudha Padas.\n\n**Arudha Pada** calculation:\n1. Find the lord of a house\n2. Count from the lord to the house\n3. Count the same from the lord = Arudha\n\n**Important Arudhas:**\n- A1 (Arudha Lagna): Self-image, how others see you\n- A2: Perceived wealth\n- A7 (Dara Pada): Partnership image\n- A12 (Upapada): Marriage and spouse indications\n- A10 (Karma Pada): Career image, professional status\n\nException: If Arudha falls in same or 7th house, use 10th or 4th instead.","operationId":"get_all_arudhas_api_v1_jaimini_arudhas_get","parameters":[{"description":"Birth date and time","required":true,"schema":{"type":"string","format":"date-time","title":"Birth Date","description":"Birth date and time"},"name":"birth_date","in":"query"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"name":"birth_latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"name":"birth_longitude","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Birth Timezone","description":"Derived from the birth place's coordinates; a zone sent is replaced","example":"Asia/Kolkata"},"name":"birth_timezone","in":"query"},{"description":"Sidereal ayanamsa (default Lahiri)","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa (default Lahiri)"},"name":"ayanamsa","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/jaimini/upapada":{"get":{"tags":["Jaimini"],"summary":"Get Upapada","description":"Get Upapada Lagna (UL) analysis - primary marriage significator.\n\n**Upapada Lagna** is the Arudha of the 12th house and is\nconsidered the most important indicator for:\n- Spouse characteristics\n- Marriage quality\n- Marriage timing\n- Relationship dynamics\n\n**Analysis includes:**\n- UL sign and its implications\n- UL lord and placement\n- Planets in UL\n- Navamsa of UL\n- Spouse characteristics\n- Marriage assessment","operationId":"get_upapada_api_v1_jaimini_upapada_get","parameters":[{"description":"Birth date and time","required":true,"schema":{"type":"string","format":"date-time","title":"Birth Date","description":"Birth date and time"},"name":"birth_date","in":"query"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"name":"birth_latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"name":"birth_longitude","in":"query"},{"description":"Derived from the birth place's coordinates; a zone sent is replaced","required":false,"schema":{"type":"string","format":"iana-timezone","title":"Birth Timezone","description":"Derived from the birth place's coordinates; a zone sent is replaced","example":"Asia/Kolkata"},"name":"birth_timezone","in":"query"},{"description":"Sidereal ayanamsa (default Lahiri)","required":false,"schema":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa (default Lahiri)"},"name":"ayanamsa","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/jaimini/concepts":{"get":{"tags":["Jaimini"],"summary":"Jaimini Concepts","description":"Learn about Jaimini astrology concepts.\n\nReturns educational information about key Jaimini concepts\nto help understand the analysis results.","operationId":"jaimini_concepts_api_v1_jaimini_concepts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/jaimini/karaka-types":{"get":{"tags":["Jaimini"],"summary":"List Karaka Types","description":"List all Jaimini Karaka types with descriptions.","operationId":"list_karaka_types_api_v1_jaimini_karaka_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/nabhasa/analyze":{"post":{"tags":["Yogas"],"summary":"Analyze All Yogas","description":"Analyze all 32 Nabhasa Yogas in a birth chart\n\nReturns all found yogas with their meanings, strengths, and overall assessment.","operationId":"analyze_all_yogas_api_v1_nabhasa_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanetPositionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/nabhasa/analyze/category":{"post":{"tags":["Yogas"],"summary":"Analyze By Category","description":"Analyze Nabhasa Yogas for a specific category\n\nCategories:\n- ashraya: Based on movable/fixed/dual sign placement (3 yogas)\n- dala: Based on benefic/malefic placement in Kendras (2 yogas)\n- akriti: Based on planetary patterns and shapes (20 yogas)\n- sankhya: Based on number of houses occupied (7 yogas)","operationId":"analyze_by_category_api_v1_nabhasa_analyze_category_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/nabhasa/yoga/{yoga_name}":{"get":{"tags":["Yogas"],"summary":"Get Yoga Details","description":"Get detailed information about a specific Nabhasa Yoga\n\nExample yoga names: rajju, musala, nala, mala, sarpa, kamala, etc.","operationId":"get_yoga_details_api_v1_nabhasa_yoga__yoga_name__get","parameters":[{"required":true,"schema":{"type":"string","title":"Yoga Name"},"name":"yoga_name","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/nabhasa/list":{"get":{"tags":["Yogas"],"summary":"List All Yogas","description":"List all 32 Nabhasa Yogas organized by category\n\nReturns complete definitions for all yogas without needing chart data.","operationId":"list_all_yogas_api_v1_nabhasa_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/nabhasa/categories":{"get":{"tags":["Yogas"],"summary":"Get Categories","description":"Get information about the 4 Nabhasa Yoga categories","operationId":"get_categories_api_v1_nabhasa_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/nabhasa/ashraya":{"post":{"tags":["Yogas"],"summary":"Check Ashraya Yogas","description":"Check for Ashraya Yogas (Shelter Yogas)\n\nThese 3 yogas are based on all planets being in one type of sign:\n- Rajju: All in movable signs (Aries, Cancer, Libra, Capricorn)\n- Musala: All in fixed signs (Taurus, Leo, Scorpio, Aquarius)\n- Nala: All in dual signs (Gemini, Virgo, Sagittarius, Pisces)","operationId":"check_ashraya_yogas_api_v1_nabhasa_ashraya_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanetPositionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/nabhasa/dala":{"post":{"tags":["Yogas"],"summary":"Check Dala Yogas","description":"Check for Dala Yogas (Petal Yogas)\n\nThese 2 yogas are based on Kendra (1, 4, 7, 10) occupation:\n- Mala: All benefics in Kendras (auspicious)\n- Sarpa: All malefics in Kendras (inauspicious)","operationId":"check_dala_yogas_api_v1_nabhasa_dala_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanetPositionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/nabhasa/akriti":{"post":{"tags":["Yogas"],"summary":"Check Akriti Yogas","description":"Check for Akriti Yogas (Shape Yogas)\n\nThese 20 yogas are based on specific planetary patterns:\n- Consecutive house patterns (Yupa, Shara, Shakti, Danda)\n- Hemisphere patterns (Nauka, Kuta, Chhatra, Chapa)\n- Angular patterns (Kamala, Vajra, Yava, etc.)\n- Special configurations (Chakra, Samudra, Ardha Chandra)","operationId":"check_akriti_yogas_api_v1_nabhasa_akriti_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanetPositionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/nabhasa/sankhya":{"post":{"tags":["Yogas"],"summary":"Check Sankhya Yogas","description":"Check for Sankhya Yogas (Number Yogas)\n\nThese 7 yogas are based on how many houses are occupied:\n- Vallaki (7 houses): Musical, artistic, leader\n- Dama (6 houses): Generous, wealthy\n- Pasha (5 houses): Large family, servants\n- Kedara (4 houses): Agricultural wealth\n- Shoola (3 houses): Sharp, quarrelsome\n- Yuga (2 houses): Poor, outcaste\n- Gola (1 house): Ignorant, serves others","operationId":"check_sankhya_yogas_api_v1_nabhasa_sankhya_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanetPositionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/nabhasa/strength-levels":{"get":{"tags":["Yogas"],"summary":"Get Strength Levels","description":"Get explanation of yoga strength levels","operationId":"get_strength_levels_api_v1_nabhasa_strength_levels_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/rectification/analyze":{"post":{"tags":["Rectification"],"summary":"Rectify Birth Time","description":"Full birth time rectification using life events.\n\nThis is the most comprehensive rectification method. It:\n- Takes an approximate birth time range\n- Analyzes multiple significant life events\n- Correlates dasha periods with events\n- Returns the most likely birth time with confidence score\n\n**Required Information:**\n- Approximate birth date and time range\n- Birth location (latitude, longitude)\n- At least one significant life event with date\n\n**Best Results With:**\n- 3-5 significant life events (marriage, children, job, etc.)\n- Narrow time range (±2 hours from estimated time)\n- Events spread across different life areas\n\n**Example Events:**\n- Marriage, divorce\n- Child birth\n- Parent's death\n- Job start/loss, promotion\n- Major illness, surgery\n- Property/vehicle purchase\n- Foreign travel, relocation","operationId":"rectify_birth_time_api_v1_rectification_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RectificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RectificationResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/rectification/quick":{"post":{"tags":["Rectification"],"summary":"Quick Rectify","description":"Quick rectification using common life events.\n\nSimplified interface for basic rectification. Just provide:\n- Birth date and approximate time\n- Location\n- Any known major events (all optional):\n - Marriage date\n - First child's birth date\n - Father's death date\n - Mother's death date\n - First job start date\n\nReturns a rectified birth time with confidence level.\n\n**Note:** For more accurate results, use the full /analyze endpoint\nwith detailed life events.","operationId":"quick_rectify_api_v1_rectification_quick_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickRectificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickRectificationResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/rectification/tattwa-shuddhi":{"post":{"tags":["Rectification"],"summary":"Tattwa Shuddhi Rectify","description":"Tattwa Shuddhi (Ruling Planets) rectification.\n\nBased on KP (Krishnamurti Paddhati) principle:\n- Ruling planets at the time of query reflect the native's chart\n- Match birth time where ascendant/Moon/nakshatra lords match query time\n\n**How it works:**\n1. Calculate ruling planets at current query time\n2. Find birth time where these planets rule ascendant, Moon sign, or nakshatra\n3. Return the best matching birth time\n\n**Ruling Planets considered:**\n- Ascendant lord at query time\n- Moon sign lord at query time\n- Day lord (weekday)\n- Moon nakshatra lord at query time\n\n**Best when:**\n- The query is sincere and the native truly wants to know\n- Used to verify other rectification methods","operationId":"tattwa_shuddhi_rectify_api_v1_rectification_tattwa_shuddhi_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TattwaShuddbiRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TattwaShuddbiResult"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/rectification/prenatal-epoch":{"post":{"tags":["Rectification"],"summary":"Prenatal Epoch Rectify","description":"Pre-natal Epoch (Trutine of Hermes) rectification.\n\nClassical rectification method based on:\n- Moon at birth relates to Ascendant/Descendant at conception\n- Ascendant at birth relates to Moon at conception\n- Gestation period (approximately 273 days)\n\n**Rules:**\n- If Moon is above horizon at birth: Regular epoch\n- If Moon is below horizon: Reverse epoch\n- Gender affects calculation slightly\n\n**Provides:**\n- Estimated conception date\n- Rectified birth time\n- Confidence level\n\n**Limitations:**\n- Based on average gestation period\n- May be less accurate for premature or late births","operationId":"prenatal_epoch_rectify_api_v1_rectification_prenatal_epoch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrenatalEpochRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrenatalEpochResult"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/rectification/event-types":{"get":{"tags":["Rectification"],"summary":"List Event Types","description":"List all supported life event types for rectification.\n\nEach event type is associated with specific astrological houses\nthat should be activated during the dasha when the event occurs.\n\nReturns categorized list of events with their astrological significance.","operationId":"list_event_types_api_v1_rectification_event_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/rectification/event-house-mappings":{"get":{"tags":["Rectification"],"summary":"Get Event House Mappings","description":"Get detailed event-to-house mappings used in rectification.\n\nShows which astrological houses are examined for each life event type\nwhen correlating dashas with events.\n\nUseful for:\n- Understanding the rectification logic\n- Learning Vedic astrology event analysis\n- Validating rectification results","operationId":"get_event_house_mappings_api_v1_rectification_event_house_mappings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/rectification/methods":{"get":{"tags":["Rectification"],"summary":"List Rectification Methods","description":"Get information about available rectification methods.\n\nEach method has different requirements, accuracy levels, and use cases.\nUnderstanding these helps choose the right approach for your situation.","operationId":"list_rectification_methods_api_v1_rectification_methods_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/rectification/guide":{"get":{"tags":["Rectification"],"summary":"Rectification Guide","description":"Complete guide to birth time rectification.\n\nEducational endpoint explaining:\n- What is rectification and why it's needed\n- How to gather information for rectification\n- How to interpret results\n- Tips for better accuracy","operationId":"rectification_guide_api_v1_rectification_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/rectification/validate":{"get":{"tags":["Rectification"],"summary":"Validate Rectification","description":"Validate a rectified birth time against an event.\n\nUse this to test if a rectified (or suspected) birth time\ncorrectly predicts a known life event.\n\nReturns:\n- Dasha/Antardasha active during the event\n- Match quality with expected houses\n- Validation score","operationId":"validate_rectification_api_v1_rectification_validate_get","parameters":[{"description":"Birth date","required":true,"schema":{"type":"string","format":"date","title":"Birth Date","description":"Birth date"},"name":"birth_date","in":"query"},{"description":"Rectified time (HH:MM)","required":true,"schema":{"type":"string","title":"Rectified Time","description":"Rectified time (HH:MM)"},"name":"rectified_time","in":"query"},{"required":true,"schema":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"name":"latitude","in":"query"},{"required":true,"schema":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"name":"longitude","in":"query"},{"required":false,"schema":{"type":"string","format":"iana-timezone","title":"Timezone","example":"Asia/Kolkata"},"name":"timezone","in":"query"},{"description":"A significant event date to validate","required":true,"schema":{"type":"string","format":"date","title":"Event Date","description":"A significant event date to validate"},"name":"event_date","in":"query"},{"description":"Type of the event","required":true,"schema":{"allOf":[{"$ref":"#/components/schemas/LifeEventType"}],"description":"Type of the event"},"name":"event_type","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Advanced Systems","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/life-planner/about":{"get":{"tags":["Life Planning"],"summary":"About Life Planner","description":"Education copy for the forward-looking life planner.","operationId":"about_life_planner_api_v1_life_planner_about_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/life-planner/periods":{"get":{"tags":["Life Planning"],"summary":"List Periods","operationId":"list_periods_api_v1_life_planner_periods_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/life-planner/categories":{"get":{"tags":["Life Planning"],"summary":"List Categories","operationId":"list_categories_api_v1_life_planner_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/life-planner/timeline":{"post":{"tags":["Life Planning"],"summary":"Generate Timeline","description":"Generate a forward-looking timeline from saved chart anchors.","operationId":"generate_timeline_api_v1_life_planner_timeline_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartTimelineRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/life-planner/timeline/user/{user_id}":{"get":{"tags":["Life Planning"],"summary":"Get Saved Timeline","description":"Return the last generated timeline for this chart owner, if any.","operationId":"get_saved_timeline_api_v1_life_planner_timeline_user__user_id__get","parameters":[{"required":true,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/life-planner/events/{event_id}/feedback":{"post":{"tags":["Life Planning"],"summary":"Record Event Feedback","description":"Store user feedback on a predicted window.","operationId":"record_event_feedback_api_v1_life_planner_events__event_id__feedback_post","parameters":[{"required":true,"schema":{"type":"string","title":"Event Id"},"name":"event_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventFeedbackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/life-planner/feedback/user/{user_id}":{"get":{"tags":["Life Planning"],"summary":"List Event Feedback","operationId":"list_event_feedback_api_v1_life_planner_feedback_user__user_id__get","parameters":[{"required":true,"schema":{"type":"string","title":"User Id"},"name":"user_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Predictions & Insights","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/baby-name/suggest":{"post":{"tags":["Baby Names"],"summary":"Suggest Baby Names","description":"Generate baby name suggestions based on birth chart.\n\nThis is the most comprehensive naming method using:\n- **Moon's Nakshatra**: Primary source for auspicious syllables\n- **Nakshatra Pada**: Specific syllable for the quarter of nakshatra\n- **Moon Sign (Rashi)**: Additional auspicious letters\n- **Numerology**: Name compatibility with birth numbers\n\n**How it works:**\n1. Calculates Moon's position at birth time\n2. Determines nakshatra and pada (quarter)\n3. Gets auspicious syllables for that pada\n4. Generates name suggestions starting with those syllables\n5. Adds numerological analysis if requested\n\n**Example:**\nIf Moon is at 25° Aries (Bharani nakshatra, pada 4):\n- Primary syllable: \"Lo\"\n- Suggested names: Lokesh, Lohit, etc.\n\n**Inputs required:**\n- Birth date and time\n- Birth location (latitude, longitude)\n- Gender preference (optional)","operationId":"suggest_baby_names_api_v1_baby_name_suggest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BabyNameRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BabyNameResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/baby-name/quick":{"post":{"tags":["Baby Names"],"summary":"Quick Suggest","description":"Quick name suggestions using nakshatra only.\n\nUse this when you already know the baby's nakshatra and pada\nbut don't have exact birth time/location.\n\n**Inputs:**\n- Nakshatra name or number (1-27)\n- Pada (1-4)\n- Gender preference\n\n**Example:**\n- Nakshatra: \"Rohini\" or \"4\"\n- Pada: 2\n- Returns names starting with \"Va\" (Rohini pada 2 syllable)","operationId":"quick_suggest_api_v1_baby_name_quick_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickNameRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickNameResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/baby-name/by-rashi":{"post":{"tags":["Baby Names"],"summary":"Suggest By Rashi","description":"Name suggestions based on Moon sign (rashi) only.\n\nThis method uses the traditional rashi-based naming system\nwhere each zodiac sign has specific auspicious letters.\n\n**Moon Sign Letters:**\n- Aries (Mesha): A, L, E\n- Taurus (Vrishabha): B, V, U, W\n- Gemini (Mithuna): K, Chh, Gh, Q, C\n- Cancer (Karkataka): D, H\n- Leo (Simha): M, T\n- Virgo (Kanya): P, Th, N\n- Libra (Tula): R, T\n- Scorpio (Vrishchika): N, Y\n- Sagittarius (Dhanu): Bh, Dh, Ph, D\n- Capricorn (Makara): Kh, J\n- Aquarius (Kumbha): G, S, Sh\n- Pisces (Meena): D, Ch, Z, Th\n\n**Note:** Nakshatra-based naming is more precise than rashi-based.","operationId":"suggest_by_rashi_api_v1_baby_name_by_rashi_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RashiNameRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RashiNameResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/baby-name/nakshatra-syllables":{"get":{"tags":["Baby Names"],"summary":"Get Nakshatra Syllables","description":"Get auspicious syllables for all 27 nakshatras.\n\nEach nakshatra has 4 padas, and each pada has specific\nsyllables that are considered auspicious for naming.\n\n**Usage:**\n- Find baby's birth nakshatra\n- Look up the pada (1-4)\n- Use the syllable for that pada to start the name\n\n**Reference for:**\n- Astrologers\n- Parents who know the nakshatra\n- Educational purposes","operationId":"get_nakshatra_syllables_api_v1_baby_name_nakshatra_syllables_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/baby-name/rashi-letters":{"get":{"tags":["Baby Names"],"summary":"Get Rashi Letters","description":"Get auspicious letters for all 12 rashis (zodiac signs).\n\nThis is the traditional rashi-based naming reference where\neach Moon sign has associated starting letters.\n\n**Note:** This is a secondary method. Nakshatra-based naming\nis more precise and traditionally preferred.","operationId":"get_rashi_letters_api_v1_baby_name_rashi_letters_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/baby-name/by-nakshatra/{nakshatra}":{"get":{"tags":["Baby Names"],"summary":"Get Names By Nakshatra","description":"Get name suggestions for a specific nakshatra and pada.\n\n**Path parameter:**\n- nakshatra: Name (e.g., \"Ashwini\") or number (1-27)\n\n**Query parameters:**\n- pada: Quarter of nakshatra (1-4)\n- gender: male, female, or unisex\n- max_names: Maximum suggestions to return\n\n**Example:**\n`/baby-name/by-nakshatra/Rohini?pada=2&gender=female`","operationId":"get_names_by_nakshatra_api_v1_baby_name_by_nakshatra__nakshatra__get","parameters":[{"required":true,"schema":{"type":"string","title":"Nakshatra"},"name":"nakshatra","in":"path"},{"description":"Nakshatra pada (1-4)","required":false,"schema":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada","description":"Nakshatra pada (1-4)","default":1},"name":"pada","in":"query"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/app__schemas__baby_name__Gender"}],"default":"unisex"},"name":"gender","in":"query"},{"required":false,"schema":{"type":"integer","maximum":50.0,"minimum":5.0,"title":"Max Names","default":20},"name":"max_names","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/baby-name/by-letter/{letter}":{"get":{"tags":["Baby Names"],"summary":"Get Names By Letter","description":"Get name suggestions starting with a specific letter/syllable.\n\n**Path parameter:**\n- letter: Starting syllable (e.g., \"A\", \"Ra\", \"Vi\")\n\n**Examples:**\n- `/baby-name/by-letter/A` - Names starting with \"A\"\n- `/baby-name/by-letter/Ra` - Names starting with \"Ra\"\n- `/baby-name/by-letter/Vi` - Names starting with \"Vi\"","operationId":"get_names_by_letter_api_v1_baby_name_by_letter__letter__get","parameters":[{"required":true,"schema":{"type":"string","title":"Letter"},"name":"letter","in":"path"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/app__schemas__baby_name__Gender"}],"default":"unisex"},"name":"gender","in":"query"},{"required":false,"schema":{"type":"integer","maximum":50.0,"minimum":5.0,"title":"Max Names","default":20},"name":"max_names","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/baby-name/guide":{"get":{"tags":["Baby Names"],"summary":"Naming Guide","description":"Complete guide to Vedic baby naming.\n\nEducational endpoint explaining:\n- Traditional naming methods\n- Importance of nakshatra and pada\n- How to use auspicious syllables\n- Numerology in naming","operationId":"naming_guide_api_v1_baby_name_guide_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/baby-name/numerology/{name}":{"get":{"tags":["Baby Names"],"summary":"Analyze Name Numerology","description":"Analyze the numerology of a specific name.\n\n**Path parameter:**\n- name: The name to analyze\n\n**Returns:**\n- Destiny number (total value)\n- Soul number (vowels)\n- Personality number (consonants)\n- Interpretation","operationId":"analyze_name_numerology_api_v1_baby_name_numerology__name__get","parameters":[{"required":true,"schema":{"type":"string","title":"Name"},"name":"name","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/baby-name/traditions":{"get":{"tags":["Baby Names"],"summary":"Naming Traditions","description":"Information about regional naming traditions in India.\n\nDifferent regions have unique naming customs and preferences.","operationId":"naming_traditions_api_v1_baby_name_traditions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/baby-name/catalogue":{"get":{"tags":["Baby Names"],"summary":"Browse Names","operationId":"browse_names_api_v1_baby_name_catalogue_get","parameters":[{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":24},"name":"page_size","in":"query"},{"required":false,"schema":{"type":"string","maxLength":200,"title":"Q","default":""},"name":"q","in":"query"},{"required":false,"schema":{"type":"string","enum":["","male","female","unisex","unknown"],"title":"Gender","default":""},"name":"gender","in":"query"},{"required":false,"schema":{"type":"string","maxLength":30,"title":"Sound","default":""},"name":"sound","in":"query"},{"required":false,"schema":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Nakshatra"},"name":"nakshatra","in":"query"},{"required":false,"schema":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada"},"name":"pada","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/admin/baby-names/imports/preview":{"post":{"tags":["Baby Names"],"summary":"Preview Upload","operationId":"preview_upload_api_v1_admin_baby_names_imports_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BabyNameUpload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/admin/baby-names/imports/{batch_id}/commit":{"post":{"tags":["Baby Names"],"summary":"Import Upload","operationId":"import_upload_api_v1_admin_baby_names_imports__batch_id__commit_post","parameters":[{"required":true,"schema":{"type":"string","title":"Batch Id"},"name":"batch_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/admin/baby-names":{"get":{"tags":["Baby Names"],"summary":"Admin Names","operationId":"admin_names_api_v1_admin_baby_names_get","parameters":[{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":50},"name":"page_size","in":"query"},{"required":false,"schema":{"type":"string","enum":["all","draft","changes","published"],"title":"Status","default":"all"},"name":"status","in":"query"},{"required":false,"schema":{"type":"boolean","title":"Ready","default":false},"name":"ready","in":"query"},{"required":false,"schema":{"type":"string","maxLength":200,"title":"Q","default":""},"name":"q","in":"query"},{"required":false,"schema":{"type":"string","enum":["","male","female","unisex","unknown"],"title":"Gender","default":""},"name":"gender","in":"query"},{"required":false,"schema":{"type":"string","maxLength":30,"title":"Sound","default":""},"name":"sound","in":"query"},{"required":false,"schema":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Nakshatra"},"name":"nakshatra","in":"query"},{"required":false,"schema":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada"},"name":"pada","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/admin/baby-names/selection":{"get":{"tags":["Baby Names"],"summary":"Select Names","operationId":"select_names_api_v1_admin_baby_names_selection_get","parameters":[{"required":false,"schema":{"type":"string","enum":["all","draft","changes","published"],"title":"Status","default":"all"},"name":"status","in":"query"},{"required":false,"schema":{"type":"boolean","title":"Ready","default":false},"name":"ready","in":"query"},{"required":false,"schema":{"type":"string","maxLength":200,"title":"Q","default":""},"name":"q","in":"query"},{"required":false,"schema":{"type":"string","enum":["","male","female","unisex","unknown"],"title":"Gender","default":""},"name":"gender","in":"query"},{"required":false,"schema":{"type":"string","maxLength":30,"title":"Sound","default":""},"name":"sound","in":"query"},{"required":false,"schema":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Nakshatra"},"name":"nakshatra","in":"query"},{"required":false,"schema":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada"},"name":"pada","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/admin/baby-names/publish":{"post":{"tags":["Baby Names"],"summary":"Publish Names","operationId":"publish_names_api_v1_admin_baby_names_publish_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BabyNamePublishRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/admin/baby-names/history":{"get":{"tags":["Baby Names"],"summary":"Import History","operationId":"import_history_api_v1_admin_baby_names_history_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Remedies & Ritual Knowledge","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/users/me/profile":{"get":{"tags":["User"],"summary":"Get my profile","description":"Get the current user's profile information.","operationId":"get_my_profile_api_v1_users_me_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"},"put":{"tags":["User"],"summary":"Update my profile","description":"Update the current user's profile information.","operationId":"update_my_profile_api_v1_users_me_profile_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/users/me/astrology":{"get":{"tags":["User"],"summary":"Get my astrological profile","description":"Get the current user's astrological profile including birth chart and dasha.","operationId":"get_my_astrology_profile_api_v1_users_me_astrology_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrologicalProfileResponse"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/users/me/birth-details":{"put":{"tags":["User"],"summary":"Update my birth details","description":"Update birth details and recalculate astrological profile.","operationId":"update_my_birth_details_api_v1_users_me_birth_details_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BirthDetailsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AstrologicalProfileResponse"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/users/me/preferences":{"get":{"tags":["User"],"summary":"Get my preferences","description":"Get the current user's preferences.","operationId":"get_my_preferences_api_v1_users_me_preferences_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"},"put":{"tags":["User"],"summary":"Update my preferences","description":"Update the current user's preferences.","operationId":"update_my_preferences_api_v1_users_me_preferences_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreferencesUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/users/{user_id}/profile":{"get":{"tags":["User"],"summary":"Get user profile (Admin)","description":"Get a specific user's profile. Admin only.","operationId":"get_user_profile_api_v1_users__user_id__profile_get","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"User Id"},"name":"user_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/users/search":{"get":{"tags":["User"],"summary":"Search users (Admin)","description":"Search users by name or email. Admin only.","operationId":"search_users_api_v1_users_search_get","parameters":[{"required":true,"schema":{"type":"string","title":"Query"},"name":"query","in":"query"},{"required":false,"schema":{"type":"integer","title":"Skip","default":0},"name":"skip","in":"query"},{"required":false,"schema":{"type":"integer","title":"Limit","default":20},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/users/{user_id}/deactivate":{"post":{"tags":["User"],"summary":"Deactivate user (Admin)","description":"Deactivate a user account. Admin only.","operationId":"deactivate_user_api_v1_users__user_id__deactivate_post","parameters":[{"required":true,"schema":{"type":"string","format":"uuid","title":"User Id"},"name":"user_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/dashboard/me":{"get":{"tags":["User"],"summary":"Get My Dashboard","description":"Get comprehensive dashboard for current user.\n\nAggregates data from all services to provide a complete\noverview of the user's astrological journey.\n\nReturns:\n Complete dashboard data","operationId":"get_my_dashboard_api_v1_dashboard_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashboardData"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dashboard/me/summary":{"get":{"tags":["User"],"summary":"Get Dashboard Summary","description":"Get quick summary for dashboard header.\n\nReturns minimal data for fast loading.","operationId":"get_dashboard_summary_api_v1_dashboard_me_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dashboard/me/upcoming":{"get":{"tags":["User"],"summary":"Get Upcoming Events","description":"Get upcoming events for the user.\n\nIncludes bookings, remedy reminders, astrological events.\n\nArgs:\n days: Number of days to look ahead\n\nReturns:\n List of upcoming events","operationId":"get_upcoming_events_api_v1_dashboard_me_upcoming_get","parameters":[{"required":false,"schema":{"type":"integer","maximum":90.0,"minimum":1.0,"title":"Days","default":14},"name":"days","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/dashboard/me/activity":{"get":{"tags":["User"],"summary":"Get Recent Activity","description":"Get recent activity for the user.\n\nReturns recent notifications, consultations, and actions.\n\nArgs:\n limit: Maximum items to return\n\nReturns:\n List of recent activity","operationId":"get_recent_activity_api_v1_dashboard_me_activity_get","parameters":[{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":20},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/dashboard/me/insights":{"get":{"tags":["User"],"summary":"Get Astrological Insights","description":"Get personalized astrological insights.\n\nProvides current dasha analysis, transit impacts,\nand personalized recommendations.\n\nReturns:\n List of insights","operationId":"get_astrological_insights_api_v1_dashboard_me_insights_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dashboard/me/stats":{"get":{"tags":["User"],"summary":"Get User Stats","description":"Get user statistics.\n\nReturns consultation history stats, prediction accuracy,\nand remedy compliance.\n\nReturns:\n User statistics","operationId":"get_user_stats_api_v1_dashboard_me_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dashboard/astrologer/me":{"get":{"tags":["User"],"summary":"Get Astrologer Dashboard","description":"Get dashboard for astrologer.\n\nShows upcoming consultations, earnings, ratings, etc.\n\nReturns:\n Astrologer dashboard data","operationId":"get_astrologer_dashboard_api_v1_dashboard_astrologer_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/dashboard/astrologer/me/schedule":{"get":{"tags":["User"],"summary":"Get Astrologer Schedule","description":"Get astrologer's schedule.\n\nArgs:\n start_date: Start of date range (default: today)\n end_date: End of date range (default: 7 days from start)\n\nReturns:\n Schedule with bookings","operationId":"get_astrologer_schedule_api_v1_dashboard_astrologer_me_schedule_get","parameters":[{"required":false,"schema":{"type":"string","format":"date","title":"Start Date"},"name":"start_date","in":"query"},{"required":false,"schema":{"type":"string","format":"date","title":"End Date"},"name":"end_date","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/search":{"get":{"tags":["Search"],"summary":"Search","description":"Search across all platform entities.\n\nSearch for astrologers, content, services, and remedies\nwith filtering and sorting options.","operationId":"search_api_v1_search_get","parameters":[{"description":"Search query","required":true,"schema":{"type":"string","maxLength":200,"minLength":1,"title":"Q","description":"Search query"},"name":"q","in":"query"},{"description":"Entity types to search","required":false,"schema":{"items":{"$ref":"#/components/schemas/SearchEntityType"},"type":"array","description":"Entity types to search"},"name":"types","in":"query"},{"required":false,"schema":{"items":{"type":"string"},"type":"array","title":"Specializations"},"name":"specializations","in":"query"},{"required":false,"schema":{"items":{"type":"string"},"type":"array","title":"Languages"},"name":"languages","in":"query"},{"required":false,"schema":{"type":"number","maximum":5.0,"minimum":0.0,"title":"Min Rating"},"name":"min_rating","in":"query"},{"required":false,"schema":{"type":"number","minimum":0.0,"title":"Max Price"},"name":"max_price","in":"query"},{"required":false,"schema":{"type":"integer","minimum":0.0,"title":"Min Experience"},"name":"min_experience","in":"query"},{"required":false,"schema":{"items":{"type":"string"},"type":"array","title":"Content Types"},"name":"content_types","in":"query"},{"required":false,"schema":{"items":{"type":"string"},"type":"array","title":"Topics"},"name":"topics","in":"query"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/SortOrder"}],"default":"relevance"},"name":"sort_by","in":"query"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"name":"page_size","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/search/astrologers":{"get":{"tags":["Search"],"summary":"Search Astrologers","description":"Search for astrologers only.","operationId":"search_astrologers_api_v1_search_astrologers_get","parameters":[{"required":true,"schema":{"type":"string","maxLength":200,"minLength":1,"title":"Q"},"name":"q","in":"query"},{"required":false,"schema":{"items":{"type":"string"},"type":"array","title":"Specializations"},"name":"specializations","in":"query"},{"required":false,"schema":{"items":{"type":"string"},"type":"array","title":"Languages"},"name":"languages","in":"query"},{"required":false,"schema":{"type":"number","maximum":5.0,"minimum":0.0,"title":"Min Rating"},"name":"min_rating","in":"query"},{"required":false,"schema":{"type":"number","minimum":0.0,"title":"Max Price"},"name":"max_price","in":"query"},{"required":false,"schema":{"type":"integer","minimum":0.0,"title":"Min Experience"},"name":"min_experience","in":"query"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/SortOrder"}],"default":"relevance"},"name":"sort_by","in":"query"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Page Size","default":20},"name":"page_size","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/search/content":{"get":{"tags":["Search"],"summary":"Search Content","description":"Search for content only.","operationId":"search_content_api_v1_search_content_get","parameters":[{"required":true,"schema":{"type":"string","maxLength":200,"minLength":1,"title":"Q"},"name":"q","in":"query"},{"required":false,"schema":{"items":{"type":"string"},"type":"array","title":"Content Types"},"name":"content_types","in":"query"},{"required":false,"schema":{"items":{"type":"string"},"type":"array","title":"Topics"},"name":"topics","in":"query"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/SortOrder"}],"default":"relevance"},"name":"sort_by","in":"query"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Page Size","default":20},"name":"page_size","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/search/services":{"get":{"tags":["Search"],"summary":"Search Services","description":"Search for services only.","operationId":"search_services_api_v1_search_services_get","parameters":[{"required":true,"schema":{"type":"string","maxLength":200,"minLength":1,"title":"Q"},"name":"q","in":"query"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Page Size","default":20},"name":"page_size","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/search/suggestions":{"get":{"tags":["Search"],"summary":"Get Suggestions","description":"Get search suggestions for autocomplete.","operationId":"get_suggestions_api_v1_search_suggestions_get","parameters":[{"required":true,"schema":{"type":"string","maxLength":200,"minLength":1,"title":"Q"},"name":"q","in":"query"},{"required":false,"schema":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":10},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/search/trending":{"get":{"tags":["Search"],"summary":"Get Trending Searches","description":"Get trending searches.","operationId":"get_trending_searches_api_v1_search_trending_get","parameters":[{"required":false,"schema":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":10},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/search/facets":{"get":{"tags":["Search"],"summary":"Get Facets","description":"Get available facets for filtering.","operationId":"get_facets_api_v1_search_facets_get","parameters":[{"required":false,"schema":{"type":"string","title":"Q"},"name":"q","in":"query"},{"required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/SearchEntityType"}],"default":"all"},"name":"entity_type","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/recommendations/astrologers":{"get":{"tags":["Recommendations"],"summary":"Get Astrologer Recommendations","description":"Get personalized astrologer recommendations.\n\nRecommends astrologers based on:\n- User's astrological profile (moon sign, dasha)\n- Language preferences\n- Specialization requirements\n- Budget constraints\n- Collaborative filtering (similar users)\n\nArgs:\n consultation_type: Type of consultation (birth_chart, career, etc.)\n specialization: Required specialization\n language: Preferred language\n max_price: Maximum price willing to pay\n limit: Number of recommendations\n\nReturns:\n List of astrologer recommendations with match scores","operationId":"get_astrologer_recommendations_api_v1_recommendations_astrologers_get","parameters":[{"required":false,"schema":{"type":"string","title":"Consultation Type"},"name":"consultation_type","in":"query"},{"required":false,"schema":{"type":"string","title":"Specialization"},"name":"specialization","in":"query"},{"required":false,"schema":{"type":"string","title":"Language"},"name":"language","in":"query"},{"required":false,"schema":{"type":"number","title":"Max Price"},"name":"max_price","in":"query"},{"required":false,"schema":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Limit","default":10},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AstrologerRecommendation"},"type":"array","title":"Response Get Astrologer Recommendations Api V1 Recommendations Astrologers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/recommendations/astrologers/for-me":{"get":{"tags":["Recommendations"],"summary":"Get Personalized Astrologers","description":"Get quick personalized astrologer recommendations.\n\nUses user's profile and history to recommend\nthe best matching astrologers.","operationId":"get_personalized_astrologers_api_v1_recommendations_astrologers_for_me_get","parameters":[{"required":false,"schema":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":5},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/recommendations/content":{"get":{"tags":["Recommendations"],"summary":"Get Content Recommendations","description":"Get personalized content recommendations.\n\nRecommends articles, videos, and other content based on:\n- User's astrological profile\n- Current planetary periods\n- Viewing history\n- Topics of interest\n\nArgs:\n content_type: Filter by type (article, video, horoscope)\n topic: Filter by topic\n limit: Number of recommendations\n\nReturns:\n List of content recommendations","operationId":"get_content_recommendations_api_v1_recommendations_content_get","parameters":[{"required":false,"schema":{"type":"string","title":"Content Type"},"name":"content_type","in":"query"},{"required":false,"schema":{"type":"string","title":"Topic"},"name":"topic","in":"query"},{"required":false,"schema":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Limit","default":10},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ContentRecommendation"},"type":"array","title":"Response Get Content Recommendations Api V1 Recommendations Content Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/recommendations/content/for-you":{"get":{"tags":["Recommendations"],"summary":"Get Content For You","description":"Get 'For You' content feed.\n\nPersonalized content mix based on user's profile and interests.","operationId":"get_content_for_you_api_v1_recommendations_content_for_you_get","parameters":[{"required":false,"schema":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Limit","default":10},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/recommendations/remedies":{"get":{"tags":["Recommendations"],"summary":"Get Remedy Recommendations","description":"Get personalized remedy recommendations.\n\nRecommends remedies based on:\n- Current dasha period\n- Moon sign and ascendant\n- Life areas of concern\n\nArgs:\n life_area: Specific life area to focus on\n limit: Number of recommendations\n\nReturns:\n List of remedy recommendations","operationId":"get_remedy_recommendations_api_v1_recommendations_remedies_get","parameters":[{"required":false,"schema":{"type":"string","title":"Life Area"},"name":"life_area","in":"query"},{"required":false,"schema":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":5},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/recommendations/services":{"get":{"tags":["Recommendations"],"summary":"Get Service Recommendations","description":"Get recommended services for the user.\n\nSuggests relevant astrology services based on\nuser's profile and current needs.","operationId":"get_service_recommendations_api_v1_recommendations_services_get","parameters":[{"required":false,"schema":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Limit","default":5},"name":"limit","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/recommendations/profile":{"get":{"tags":["Recommendations"],"summary":"Get Recommendation Profile","description":"Get user's recommendation profile.","operationId":"get_recommendation_profile_api_v1_recommendations_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"},"put":{"tags":["Recommendations"],"summary":"Update Recommendation Profile","description":"Update profile data used for recommendations.\n\nThis improves recommendation accuracy.","operationId":"update_recommendation_profile_api_v1_recommendations_profile_put","parameters":[{"required":false,"schema":{"type":"string","title":"Moon Sign"},"name":"moon_sign","in":"query"},{"required":false,"schema":{"type":"string","title":"Sun Sign"},"name":"sun_sign","in":"query"},{"required":false,"schema":{"type":"string","title":"Ascendant"},"name":"ascendant","in":"query"},{"required":false,"schema":{"type":"string","title":"Current Dasha"},"name":"current_dasha","in":"query"},{"required":false,"schema":{"type":"string","title":"Current Antardasha"},"name":"current_antardasha","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_update_recommendation_profile_api_v1_recommendations_profile_put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/recommendations/track/interaction":{"post":{"tags":["Recommendations"],"summary":"Track Interaction","description":"Track user interaction for improving recommendations.\n\nThis data is used for collaborative filtering.\n\nArgs:\n interaction_type: Type of interaction (view, book, complete, rate)\n entity_type: Type of entity (astrologer, content)\n entity_id: Entity identifier\n score: Interaction score (default 1.0, use higher for ratings)","operationId":"track_interaction_api_v1_recommendations_track_interaction_post","parameters":[{"required":true,"schema":{"type":"string","title":"Interaction Type"},"name":"interaction_type","in":"query"},{"required":true,"schema":{"type":"string","title":"Entity Type"},"name":"entity_type","in":"query"},{"required":true,"schema":{"type":"string","title":"Entity Id"},"name":"entity_id","in":"query"},{"required":false,"schema":{"type":"number","title":"Score","default":1.0},"name":"score","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/recommendations/home-feed":{"get":{"tags":["Recommendations"],"summary":"Get Home Feed","description":"Get combined recommendations for home page.\n\nReturns a mix of recommended astrologers, content,\nand services personalized for the user.","operationId":"get_home_feed_api_v1_recommendations_home_feed_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/forum/posts":{"get":{"tags":["Forum"],"summary":"Get all posts","description":"Get forum posts, newest first by default.\n\n``total`` counts the posts matching ``category`` and ``topic``, so it agrees\nwith what paging through the listing will actually return.","operationId":"get_posts_api_v1_forum_posts_get","parameters":[{"required":false,"schema":{"$ref":"#/components/schemas/TopicCategory"},"name":"category","in":"query"},{"required":false,"schema":{"type":"string","maxLength":100,"title":"Topic"},"name":"topic","in":"query"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"name":"page_size","in":"query"},{"description":"Ordering; pinned posts lead all of them","required":false,"schema":{"type":"string","enum":["recent","oldest","popular","votes","views"],"title":"Sort By","description":"Ordering; pinned posts lead all of them","default":"recent"},"name":"sort_by","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostListResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"post":{"tags":["Forum"],"summary":"Create a new post","description":"Create a forum post, attributed to the caller.\n\n``author_id`` in the body must be the caller's own id, and ``author_name`` is\nignored: the author is taken from the access token.\n\n``is_draft``, ``is_private`` and ``scheduled_publish`` are refused with 400\nrather than accepted and ignored -- publishing a post that asked to stay\nprivate is worse than declining to store it. ``allow_comments=False`` locks\nthe post. ``notify_followers`` has no notification system behind it and is\nignored.","operationId":"create_post_api_v1_forum_posts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePostRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:write"}},"/forum/stats":{"get":{"tags":["Forum"],"summary":"Get forum statistics","description":"Get forum statistics.\n\n``total_users`` counts the people who have posted or commented, not\nregistered accounts -- those live in a database this service cannot read. The\nday for ``posts_today`` and ``active_users_today`` is the UTC day.","operationId":"get_stats_api_v1_forum_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumStats"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/forum/topics":{"get":{"tags":["Forum"],"summary":"Get all topics","description":"The topics live posts are filed under.\n\n``forum_posts.topic`` is free text and there is no topics table, so a topic\nis exactly a label some post carries -- there is no description, id or post\ncount to return, and no ``category`` to filter by that is not already\n``GET /posts?category=``.","operationId":"get_topics_api_v1_forum_topics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get Topics Api V1 Forum Topics Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/forum/categories":{"get":{"tags":["Forum"],"summary":"Get all categories","description":"The categories live posts are filed under.\n\nThe categories a post *may* use are the ``TopicCategory`` enum, which clients\nalready have from the schema; this is the subset in use.","operationId":"get_categories_api_v1_forum_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get Categories Api V1 Forum Categories Get"}}}},"404":{"description":"Not found"},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","parameters":[{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"x-ashwagosha-required-scope":"jyotisha:read"}},"/forum/posts/{post_id}":{"get":{"tags":["Forum"],"summary":"Get a specific post","description":"Get one post. Counts the view.","operationId":"get_post_api_v1_forum_posts__post_id__get","parameters":[{"description":"The post's id","required":true,"schema":{"type":"string","title":"Post Id","description":"The post's id"},"name":"post_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}},"/forum/posts/{post_id}/comments":{"get":{"tags":["Forum"],"summary":"Get comments for a post","description":"Every comment on a post, replies included, oldest first.\n\nReplies carry ``parent_id``, so the flat thread is enough to nest. Listing\ntop-level comments while counting all of them was why ``has_more`` stayed\ntrue on an exhausted listing.","operationId":"get_comments_api_v1_forum_posts__post_id__comments_get","parameters":[{"description":"The post whose comments to return","required":true,"schema":{"type":"string","title":"Post Id","description":"The post whose comments to return"},"name":"post_id","in":"path"},{"required":false,"schema":{"type":"integer","minimum":1.0,"title":"Page","default":1},"name":"page","in":"query"},{"required":false,"schema":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Page Size","default":20},"name":"page_size","in":"query"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentListResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"},"post":{"tags":["Forum"],"summary":"Add a comment to a post","description":"Comment on a post, or reply to a comment by setting ``parent_id``.\n\nA ``parent_id`` on a different post is refused rather than filed here.","operationId":"add_comment_api_v1_forum_posts__post_id__comments_post","parameters":[{"description":"The post being commented on","required":true,"schema":{"type":"string","title":"Post Id","description":"The post being commented on"},"name":"post_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCommentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/forum/posts/{post_id}/vote":{"post":{"tags":["Forum"],"summary":"Vote on a post","description":"Upvote or downvote a post.\n\nReturns ``{\"post_id\", \"vote_count\", \"vote\"}``, where ``vote`` is ``added``,\n``removed`` or ``switched``: voting the same way twice takes the vote back,\nvoting the other way replaces it. ``vote_count`` is the post's net score,\nupvotes minus downvotes, counted from the votes themselves.","operationId":"vote_post_api_v1_forum_posts__post_id__vote_post","parameters":[{"description":"The post being voted on","required":true,"schema":{"type":"string","title":"Post Id","description":"The post being voted on"},"name":"post_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/forum/comments/{comment_id}/vote":{"post":{"tags":["Forum"],"summary":"Vote on a comment","description":"Upvote or downvote a comment. See ``POST /forum/posts/{post_id}/vote``.","operationId":"vote_comment_api_v1_forum_comments__comment_id__vote_post","parameters":[{"description":"The comment being voted on","required":true,"schema":{"type":"string","title":"Comment Id","description":"The comment being voted on"},"name":"comment_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/forum/posts/{post_id}/accept/{comment_id}":{"post":{"tags":["Forum"],"summary":"Accept answer","description":"Mark a comment as a post's accepted answer.\n\nOnly the author of the post may accept, and only a comment on that post.","operationId":"accept_answer_api_v1_forum_posts__post_id__accept__comment_id__post","parameters":[{"description":"The question","required":true,"schema":{"type":"string","title":"Post Id","description":"The question"},"name":"post_id","in":"path"},{"description":"The comment to accept as its answer","required":true,"schema":{"type":"string","title":"Comment Id","description":"The comment to accept as its answer"},"name":"comment_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"security":[{"OAuth2PasswordBearer":[]},{"HTTPBearer":[]}],"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:write"}},"/forum/users/{user_id}":{"get":{"tags":["Forum"],"summary":"Get user profile","description":"Get a user's forum profile: their real post, comment and answer counts.\n\n``member_since`` is when they first wrote in the forum, falling back to when\ntheir profile was created. 404 if nothing is known about them at all.","operationId":"get_user_profile_api_v1_forum_users__user_id__get","parameters":[{"description":"The ID of the user","required":true,"schema":{"type":"string","title":"User Id","description":"The ID of the user"},"name":"user_id","in":"path"},{"name":"X-API-Key","in":"header","required":true,"description":"Required on /v1/jyotisha. Server-side example: X-API-Key: ag_test__.","schema":{"type":"string","writeOnly":true}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserForumProfile"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"$ref":"#/components/responses/DeveloperApiKeyUnauthorized"},"403":{"$ref":"#/components/responses/DeveloperApiKeyInsufficientScope"},"429":{"$ref":"#/components/responses/DeveloperLimitExceeded"},"503":{"$ref":"#/components/responses/DeveloperAccessUnavailable"}},"x-ashwagosha-api-group":"Account & Discovery","x-ashwagosha-readiness":"ready","x-ashwagosha-required-scope":"jyotisha:read"}}},"components":{"schemas":{"AbdaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"is_year_lord":{"type":"boolean","title":"Is Year Lord"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","is_year_lord","strength_virupas"],"title":"AbdaBala","description":"Year lord strength."},"AboutOut":{"properties":{"feature":{"type":"string","title":"Feature"},"tagline":{"type":"string","title":"Tagline"},"description":{"type":"string","title":"Description"},"how_it_works":{"items":{"type":"string"},"type":"array","title":"How It Works"},"factors_considered":{"items":{"type":"string"},"type":"array","title":"Factors Considered"},"unique_features":{"items":{"type":"string"},"type":"array","title":"Unique Features"},"activities_supported":{"type":"integer","title":"Activities Supported"},"note":{"type":"string","title":"Note"}},"type":"object","required":["feature","tagline","description","how_it_works","factors_considered","unique_features","activities_supported","note"],"title":"AboutOut"},"ActiveDashaLevel":{"properties":{"level":{"type":"string","title":"Level","description":"mahadasha, antardasha, or pratyantardasha"},"lord":{"type":"string","title":"Lord"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"placement":{"$ref":"#/components/schemas/DashaPlanetPlacement"}},"type":"object","required":["level","lord","start_date","end_date","placement"],"title":"ActiveDashaLevel"},"ActivitiesOut":{"properties":{"activities":{"items":{"$ref":"#/components/schemas/app__routers__astro_calendar__ActivityInfoOut"},"type":"array","title":"Activities"}},"type":"object","required":["activities"],"title":"ActivitiesOut"},"ActivitiesResponse":{"properties":{"total_activities":{"type":"integer","title":"Total Activities"},"activities":{"items":{"$ref":"#/components/schemas/app__schemas__advanced_muhurta__ActivityInfoOut"},"type":"array","title":"Activities"}},"type":"object","required":["total_activities"],"title":"ActivitiesResponse","description":"GET /advanced-muhurta/activities"},"ActivityCategory":{"type":"string","enum":["vivah","upanayana","mundan","namkaran","annaprashan","karnavedha","vidyarambha","diksha","yagna","vratarambha","mantra_japa","grihapravesh","bhoomi_puja","shilanyas","vastushanti","vyapar","dhan_labha","runanubandh","samjhauta","yatra","digvijaya","aushadhi_seva","shastra_karma","chikitsa_arambha","krishi","beejropan","vahan_kharid","yantra_sthapana","manglik_karya","shubh_karya"],"title":"ActivityCategory","description":"Comprehensive activity categories for muhurta selection."},"ActivityType":{"type":"string","enum":["interview","meeting","presentation","contract","travel","investment","medical","wedding","house_purchase","vehicle_purchase","new_venture","exam","spiritual","relationship","legal","general"],"title":"ActivityType","description":"Types of activities for timing recommendations"},"AdjacentDay":{"properties":{"date":{"type":"string","format":"date-time","title":"Date"},"tone":{"type":"string","title":"Tone"},"support_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Support Score"},"moon_sign":{"type":"string","title":"Moon Sign","default":""},"moon_house_from_rashi":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Moon House From Rashi"},"nakshatra":{"type":"string","title":"Nakshatra","default":""},"is_chandrashtama":{"type":"boolean","title":"Is Chandrashtama","default":false},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"changed":{"items":{"type":"string"},"type":"array","title":"Changed"}},"type":"object","required":["date","tone","support_score"],"title":"AdjacentDay","description":"A neighbouring day, and which of its fields differ from today's.\n\n`changed` is computed rather than prosed so the API and the UI cannot\ndisagree about what actually moved between the two days."},"AdvancedDashaRequest":{"properties":{"birth_date":{"type":"string","format":"date-time","title":"Birth Date","description":"Date and time of birth"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude","description":"Latitude of birth location"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude","description":"Longitude of birth location"},"birth_timezone":{"type":"string","title":"Birth Timezone","description":"Timezone of birth location"},"years":{"type":"integer","maximum":150.0,"minimum":1.0,"title":"Years","description":"Years to calculate","default":120},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa (Parashari/Jaimini Vedic set; default Lahiri)"}},"type":"object","required":["birth_date","birth_latitude","birth_longitude","birth_timezone"],"title":"AdvancedDashaRequest","description":"Shared body for Chara / Narayana / Sudharshana endpoints."},"AllDailyHoroscopesResponse":{"properties":{"date":{"type":"string","format":"date-time","title":"Date"},"horoscopes":{"additionalProperties":{"$ref":"#/components/schemas/HoroscopeResponse"},"type":"object","title":"Horoscopes"}},"type":"object","required":["date","horoscopes"],"title":"AllDailyHoroscopesResponse"},"AnandadiSpan":{"properties":{"number":{"type":"integer","maximum":28.0,"minimum":1.0,"title":"Number","description":"One-based member of the Anandadi cycle (1 = Ananda)"},"name":{"type":"string","title":"Name","description":"Name of the Anandadi yoga in this span"},"nakshatra_number":{"type":"integer","maximum":28.0,"minimum":1.0,"title":"Nakshatra Number","description":"The Moon's one-based nakshatra on the 28-fold division; 22 is Abhijit"},"nakshatra_name":{"type":"string","title":"Nakshatra Name","description":"Name of that nakshatra"},"tamil_yoga":{"type":"string","title":"Tamil Yoga","description":"Tamil verdict of this member -- tamil_siddha, tamil_amrita or tamil_marana. Every member carries one, so this is null only if the tables have stopped partitioning the cycle."},"tamil_yoga_is_auspicious":{"type":"boolean","title":"Tamil Yoga Is Auspicious","description":"Whether that verdict is a good one. Published beside the code so a client does not hardcode which of the three names is the bad one."},"start":{"type":"string","format":"date-time","title":"Start","description":"When this span began; may precede the day's sunrise"},"end":{"type":"string","format":"date-time","title":"End","description":"When this span ends; may follow the next sunrise"}},"type":"object","required":["number","name","nakshatra_number","nakshatra_name","start","end"],"title":"AnandadiSpan","description":"One span of the 28-fold Anandadi cycle, with its Tamil verdict.\n\nRead almost like a :class:`LimbSpan` -- half-open, one entry per span touching\nthe day, printed \"Ananda upto 22:48, then Kaladanda\" -- but CLIPPED to the day\nwhere a limb span is not. A limb's name belongs to its span; this name belongs to\nthe span and the weekday together, so the same Abhijit is Mushala on 2026-01-18\nand Kana on 2026-01-19, and ``start``/``end`` bound the reign of the name rather\nthan the extent of the nakshatra. The unclipped extent is in the ``nakshatra``\nlimb above for 27 of the 28; for Abhijit it is not published anywhere, because\nnothing divides it the way the ghati arithmetic divides a limb span. It is a\nseparate model because it carries two numbers where a limb carries one, and\nbecause the verdict rides with it.\n\n``number`` is the member of the cycle and ``nakshatra_number`` is the Moon's\nposition on the division that counts Abhijit. THEY ARE DIFFERENT NUMBERS and\nneither can be derived from the other without the weekday: the count starts\nfrom the nakshatra the vara itself starts on, four nakshatras later for each day\npast Sunday. Both are published so a reader can check the one against the other.\n\nThe nakshatra here is the 28-fold one, so it does not always agree with the\n``nakshatra`` limb above. On 2026-01-19 the Moon leaves Uttara Ashadha at 11:52\nand this row still reads Abhijit until 13:34, which is the discrepancy the whole\ndivision exists to express."},"AnnualForecastFactor":{"properties":{"year":{"type":"integer","title":"Year"},"summary":{"type":"string","title":"Summary"},"theme":{"type":"string","title":"Theme"},"support_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Support Score"},"keyword":{"type":"string","title":"Keyword"},"mahadasha":{"type":"string","title":"Mahadasha"},"antardasha":{"type":"string","title":"Antardasha"},"solar_return_date":{"type":"string","format":"date-time","title":"Solar Return Date"},"muntha_house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Muntha House"},"year_lord":{"type":"string","title":"Year Lord"},"return_ascendant":{"type":"string","title":"Return Ascendant"},"mudda_dasha":{"items":{"$ref":"#/components/schemas/DashaWindow"},"type":"array","title":"Mudda Dasha"},"sahams":{"items":{"$ref":"#/components/schemas/AnnualSensitivePoint"},"type":"array","title":"Sahams"},"tajika_yogas":{"items":{"$ref":"#/components/schemas/AnnualYogaFactor"},"type":"array","title":"Tajika Yogas"},"best_periods":{"items":{"type":"string"},"type":"array","title":"Best Periods"},"challenging_periods":{"items":{"type":"string"},"type":"array","title":"Challenging Periods"},"major_transits":{"items":{"$ref":"#/components/schemas/ForecastEvent"},"type":"array","title":"Major Transits"}},"type":"object","required":["year","summary","theme","support_score"],"title":"AnnualForecastFactor","description":"One year in a yearly or multi-year forecast."},"AnnualSensitivePoint":{"properties":{"name":{"type":"string","title":"Name"},"life_area":{"type":"string","title":"Life Area"},"longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Longitude"},"sign":{"type":"string","title":"Sign"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"lord":{"type":"string","title":"Lord"},"support_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Support Score"},"formula":{"type":"string","title":"Formula"}},"type":"object","required":["name","life_area","longitude","sign","house","lord","support_score","formula"],"title":"AnnualSensitivePoint","description":"A calculated Tajika Saham in the annual solar-return chart."},"AnnualYogaFactor":{"properties":{"name":{"type":"string","title":"Name"},"yoga_type":{"type":"string","title":"Yoga Type"},"planets":{"items":{"type":"string"},"type":"array","title":"Planets"},"aspect":{"type":"string","title":"Aspect"},"orb":{"type":"number","minimum":0.0,"title":"Orb"},"applying":{"type":"boolean","title":"Applying"},"strength":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Strength"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["name","yoga_type","planets","aspect","orb","applying","strength","interpretation"],"title":"AnnualYogaFactor","description":"A detected applying or separating Tajika aspect."},"ApplicabilityRequest":{"properties":{"rahu_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Rahu Longitude"},"lagna_lord_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Lagna Lord Longitude"},"ascendant_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Ascendant Longitude"}},"type":"object","required":["rahu_longitude","lagna_lord_longitude","ascendant_longitude"],"title":"ApplicabilityRequest","description":"Request model for checking dasha applicability."},"ApproximateBirthTime":{"properties":{"birth_date":{"type":"string","format":"date","title":"Birth Date"},"approximate_time":{"type":"string","title":"Approximate Time","description":"Best guess time in HH:MM format"},"time_range_start":{"type":"string","title":"Time Range Start","description":"Earliest possible time (HH:MM)","default":"00:00"},"time_range_end":{"type":"string","title":"Time Range End","description":"Latest possible time (HH:MM)","default":"23:59"},"confidence":{"type":"string","title":"Confidence","description":"high, medium, or low","default":"low"},"source":{"type":"string","title":"Source","description":"family_record, hospital_record, relative_memory, unknown","default":"unknown"}},"type":"object","required":["birth_date","approximate_time"],"title":"ApproximateBirthTime","description":"Approximate birth time information provided by the user.\n\nAttributes:\n birth_date: Known birth date\n approximate_time: Best guess of birth time\n time_range_start: Earliest possible birth time\n time_range_end: Latest possible birth time\n confidence: How confident in the approximate time\n source: Source of this information"},"Argala":{"properties":{"argala_type":{"allOf":[{"$ref":"#/components/schemas/ArgalaType"}],"description":"Type of argala"},"from_house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"From House","description":"House causing argala"},"to_house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"To House","description":"House receiving argala"},"causing_planets":{"items":{"type":"string"},"type":"array","title":"Causing Planets","description":"Planets causing argala"},"obstructing_planets":{"items":{"type":"string"},"type":"array","title":"Obstructing Planets","description":"Planets obstructing"},"is_obstructed":{"type":"boolean","title":"Is Obstructed","description":"Whether argala is obstructed"},"net_effect":{"type":"string","title":"Net Effect","description":"Net effect of argala"}},"type":"object","required":["argala_type","from_house","to_house","is_obstructed","net_effect"],"title":"Argala","description":"Argala (planetary intervention)."},"ArgalaType":{"type":"string","enum":["shubha","papa","virodha"],"title":"ArgalaType","description":"Argala (intervention) types."},"ArudhaPada":{"properties":{"pada_type":{"allOf":[{"$ref":"#/components/schemas/ArudhaPadaType"}],"description":"Type of Arudha Pada"},"sign":{"type":"string","title":"Sign","description":"Sign where Pada falls"},"sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Index","description":"Sign index"},"house_lord":{"type":"string","title":"House Lord","description":"Lord of the original house"},"lord_placement":{"type":"string","title":"Lord Placement","description":"Sign where lord is placed"},"calculation_steps":{"type":"string","title":"Calculation Steps","description":"How it was calculated","default":""},"planets_in_pada":{"items":{"type":"string"},"type":"array","title":"Planets In Pada","description":"Planets in this pada"},"significance":{"type":"string","title":"Significance","description":"What this pada represents"},"predictions":{"items":{"type":"string"},"type":"array","title":"Predictions","description":"Interpretations"}},"type":"object","required":["pada_type","sign","sign_index","house_lord","lord_placement","significance"],"title":"ArudhaPada","description":"Arudha Pada information."},"ArudhaPadaType":{"type":"string","enum":["A1","A2","A3","A4","A5","A6","A7","A8","A9","A10","A11","A12"],"title":"ArudhaPadaType","description":"Arudha Pada types (12 padas)."},"AshtaKootaScore":{"properties":{"varna":{"$ref":"#/components/schemas/VarnaKoota"},"vashya":{"$ref":"#/components/schemas/VashyaKoota"},"tara":{"$ref":"#/components/schemas/TaraKoota"},"yoni":{"$ref":"#/components/schemas/YoniKoota"},"graha_maitri":{"$ref":"#/components/schemas/GrahaMaitriKoota"},"gana":{"$ref":"#/components/schemas/GanaKoota"},"bhakoot":{"$ref":"#/components/schemas/BhakootKoota"},"nadi":{"$ref":"#/components/schemas/NadiKoota"},"total_points":{"type":"number","maximum":36.0,"minimum":0.0,"title":"Total Points"},"max_points":{"type":"number","title":"Max Points","default":36},"percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Percentage"},"compatibility_level":{"$ref":"#/components/schemas/CompatibilityLevel"}},"type":"object","required":["varna","vashya","tara","yoni","graha_maitri","gana","bhakoot","nadi","total_points","percentage","compatibility_level"],"title":"AshtaKootaScore","description":"Complete Ashta Koota (8-fold) matching score.\n\nAttributes:\n varna: Varna Koota details (1 point max)\n vashya: Vashya Koota details (2 points max)\n tara: Tara Koota details (3 points max)\n yoni: Yoni Koota details (4 points max)\n graha_maitri: Graha Maitri Koota details (5 points max)\n gana: Gana Koota details (6 points max)\n bhakoot: Bhakoot Koota details (7 points max)\n nadi: Nadi Koota details (8 points max)\n total_points: Total points obtained\n max_points: Maximum possible (36)\n percentage: Percentage score\n compatibility_level: Overall compatibility level"},"AshtakavargaAnalysis":{"properties":{"birth_details":{"$ref":"#/components/schemas/AshtakavargaBirthDetails"},"analysis_date":{"type":"string","format":"date","title":"Analysis Date"},"ascendant_sign":{"type":"integer","title":"Ascendant Sign"},"ascendant_sign_name":{"type":"string","title":"Ascendant Sign Name"},"moon_sign":{"type":"integer","title":"Moon Sign"},"moon_sign_name":{"type":"string","title":"Moon Sign Name"},"bhinnashtakavarga":{"additionalProperties":{"$ref":"#/components/schemas/BhinnashtakavargaChart"},"type":"object","title":"Bhinnashtakavarga"},"sarvashtakavarga":{"$ref":"#/components/schemas/SarvashtakavargaChart"},"house_strengths":{"items":{"$ref":"#/components/schemas/HouseStrength"},"type":"array","title":"House Strengths"},"planet_summaries":{"items":{"$ref":"#/components/schemas/PlanetAshtakavargaSummary"},"type":"array","title":"Planet Summaries"},"current_transits":{"items":{"$ref":"#/components/schemas/TransitBinduAnalysis"},"type":"array","title":"Current Transits"},"upcoming_transits":{"items":{"$ref":"#/components/schemas/TransitTimingAnalysis"},"type":"array","title":"Upcoming Transits"},"strongest_areas":{"items":{"type":"string"},"type":"array","title":"Strongest Areas"},"weakest_areas":{"items":{"type":"string"},"type":"array","title":"Weakest Areas"},"overall_chart_strength":{"type":"string","title":"Overall Chart Strength"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["birth_details","analysis_date","ascendant_sign","ascendant_sign_name","moon_sign","moon_sign_name","bhinnashtakavarga","sarvashtakavarga","house_strengths","planet_summaries","current_transits","upcoming_transits","strongest_areas","weakest_areas","overall_chart_strength","recommendations"],"title":"AshtakavargaAnalysis","description":"Complete Ashtakavarga analysis."},"AshtakavargaBirthDetails":{"properties":{"date_of_birth":{"type":"string","format":"date","title":"Date Of Birth"},"time_of_birth":{"type":"string","title":"Time Of Birth"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","default":"Asia/Kolkata"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["date_of_birth","time_of_birth","latitude","longitude"],"title":"AshtakavargaBirthDetails"},"AspectDetail":{"properties":{"aspecting_planet":{"type":"string","title":"Aspecting Planet"},"aspect_type":{"type":"string","title":"Aspect Type"},"is_benefic":{"type":"boolean","title":"Is Benefic"},"strength_contribution":{"type":"number","title":"Strength Contribution"}},"type":"object","required":["aspecting_planet","aspect_type","is_benefic","strength_contribution"],"title":"AspectDetail","description":"Details of an aspect."},"AstrologerRecommendation":{"properties":{"astrologer_id":{"type":"string","format":"uuid","title":"Astrologer Id"},"display_name":{"type":"string","title":"Display Name"},"title":{"type":"string","title":"Title"},"specializations":{"items":{"type":"string"},"type":"array","title":"Specializations"},"languages":{"items":{"type":"string"},"type":"array","title":"Languages"},"experience_years":{"type":"integer","title":"Experience Years","default":0},"rating":{"type":"number","title":"Rating","default":0.0},"total_consultations":{"type":"integer","title":"Total Consultations","default":0},"price":{"type":"number","title":"Price","default":0.0},"currency":{"type":"string","title":"Currency","default":"INR"},"match_score":{"type":"number","title":"Match Score","default":0.0},"match_reasons":{"items":{"type":"string"},"type":"array","title":"Match Reasons"}},"type":"object","required":["astrologer_id","display_name"],"title":"AstrologerRecommendation","description":"Astrologer recommendation with details."},"AstrologicalInsight":{"properties":{"insight_type":{"type":"string","title":"Insight Type"},"title":{"type":"string","title":"Title"},"message":{"type":"string","title":"Message"},"severity":{"type":"string","title":"Severity","default":"info"}},"type":"object","required":["insight_type","title","message"],"title":"AstrologicalInsight","description":"Quick astrological insight."},"AstrologicalProfileResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"missing_fields":{"items":{"type":"string"},"type":"array","title":"Missing Fields"},"birth_details":{"type":"object","title":"Birth Details"},"chart_summary":{"type":"object","title":"Chart Summary"},"current_dasha":{"type":"object","title":"Current Dasha"},"planetary_positions":{"items":{"type":"object"},"type":"array","title":"Planetary Positions"},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","required":["status"],"title":"AstrologicalProfileResponse","description":"Response model for astrological profile."},"AuspiciousTimesResponse":{"properties":{"abhijit_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Abhijit Muhurat","description":"Time range for Abhijit Muhurat; null on Wednesday"},"brahma_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Brahma Muhurat","description":"Time range for Brahma Muhurat"},"godhuli_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Godhuli Muhurat","description":"Time range for Godhuli Muhurat"},"vijaya_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Vijaya Muhurat","description":"Vijaya Muhurta: the 11th of the 15 daylight muhurtas"},"nishita_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Nishita Muhurat","description":"Nishita Muhurta: the 8th of the 15 night muhurtas"},"pratah_sandhya":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Pratah Sandhya","description":"Dawn sandhya: three night ghatikas ending at sunrise"},"sayahna_sandhya":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Sayahna Sandhya","description":"Dusk sandhya: three night ghatikas beginning at sunset"},"pradosh_kaal":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Pradosh Kaal","description":"Pradosh Kaal: three night muhurtas beginning at sunset"},"amrit_kaal":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Amrit Kaal","description":"First Amrit Kaal window of the day; null if the day has none"},"amrit_kaal_windows":{"items":{"$ref":"#/components/schemas/TimeRange"},"type":"array","title":"Amrit Kaal Windows","description":"Every Amrit Kaal window beginning in this sunrise-to-sunrise day"}},"type":"object","required":["brahma_muhurat","godhuli_muhurat"],"title":"AuspiciousTimesResponse","description":"Response model for auspicious times calculations.\n\nAttributes:\n abhijit_muhurat: Time range for Abhijit Muhurat, or null on Wednesday\n brahma_muhurat: Time range for Brahma Muhurat\n godhuli_muhurat: Time range for Godhuli Muhurat\n vijaya_muhurat: Time range for Vijaya Muhurta\n nishita_muhurat: Time range for Nishita Muhurta\n pratah_sandhya: Dawn sandhya\n sayahna_sandhya: Dusk sandhya\n pradosh_kaal: Dusk worship period, twice the sayahna sandhya\n amrit_kaal: First Amrit Kaal window of the day, if any\n amrit_kaal_windows: Every Amrit Kaal window touching the day\n\nAmrit Kaal is a list, and optional, because it is derived from the Moon's\npassage through a nakshatra rather than from a slice of the daylight: a day\ncan hold none of them, one, or two when two nakshatras touch the same\nsunrise-to-sunrise day. `amrit_kaal` is the first entry of\n`amrit_kaal_windows`, retained so existing clients keep working."},"AyanaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"declination":{"type":"number","title":"Declination"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","declination","strength_virupas"],"title":"AyanaBala","description":"Solstice strength (declination based)."},"BabyNamePublishRequest":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/BabyNameSelection"},"type":"array","maxItems":10000,"minItems":1,"title":"Entries"},"action":{"type":"string","enum":["publish","unpublish"],"title":"Action","default":"publish"}},"type":"object","required":["entries"],"title":"BabyNamePublishRequest"},"BabyNameRequest":{"properties":{"birth_datetime":{"type":"string","format":"date-time","title":"Birth Datetime"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","default":"UTC"},"gender":{"allOf":[{"$ref":"#/components/schemas/app__schemas__baby_name__Gender"}],"default":"unisex"},"preferred_origins":{"items":{"$ref":"#/components/schemas/NameOrigin"},"type":"array"},"name_length_preference":{"type":"string","title":"Name Length Preference","description":"short, medium, long, or any","default":"any"},"include_numerology":{"type":"boolean","title":"Include Numerology","default":true},"max_suggestions":{"type":"integer","maximum":100.0,"minimum":5.0,"title":"Max Suggestions","default":25}},"type":"object","required":["birth_datetime","latitude","longitude"],"title":"BabyNameRequest"},"BabyNameResponse":{"properties":{"birth_datetime":{"type":"string","format":"date-time","title":"Birth Datetime"},"nakshatra_info":{"$ref":"#/components/schemas/NakshatraInfo"},"rashi_info":{"$ref":"#/components/schemas/RashiInfo"},"planetary_influences":{"items":{"$ref":"#/components/schemas/PlanetaryInfluence"},"type":"array","title":"Planetary Influences"},"primary_syllables":{"items":{"type":"string"},"type":"array","title":"Primary Syllables"},"suggestions":{"items":{"$ref":"#/components/schemas/NameSuggestion"},"type":"array","title":"Suggestions"},"naming_guidelines":{"items":{"type":"string"},"type":"array","title":"Naming Guidelines"},"lucky_numbers":{"items":{"type":"integer"},"type":"array","title":"Lucky Numbers"},"lucky_colors":{"items":{"type":"string"},"type":"array","title":"Lucky Colors"},"lucky_day":{"type":"string","title":"Lucky Day"}},"type":"object","required":["birth_datetime","nakshatra_info","rashi_info","planetary_influences","primary_syllables","suggestions","naming_guidelines","lucky_numbers","lucky_colors","lucky_day"],"title":"BabyNameResponse","description":"Complete baby name suggestion response.\n\nAttributes:\n birth_datetime: Birth date/time analyzed\n nakshatra_info: Birth nakshatra details\n rashi_info: Moon sign details\n planetary_influences: Strong planets in chart\n primary_syllables: Primary auspicious syllables\n suggestions: List of name suggestions\n naming_guidelines: Traditional naming guidelines\n lucky_numbers: Lucky numbers for the baby\n lucky_colors: Lucky colors\n lucky_day: Lucky day of the week"},"BabyNameSelection":{"properties":{"name_id":{"type":"string","maxLength":100,"minLength":1,"title":"Name Id"},"version":{"type":"integer","minimum":1.0,"title":"Version"}},"type":"object","required":["name_id","version"],"title":"BabyNameSelection"},"BabyNameUpload":{"properties":{"filename":{"type":"string","maxLength":255,"minLength":1,"title":"Filename"},"csv_text":{"type":"string","maxLength":10000000,"minLength":1,"title":"Csv Text"}},"type":"object","required":["filename","csv_text"],"title":"BabyNameUpload"},"BehavioralRemedy":{"properties":{"habits_to_adopt":{"items":{"type":"string"},"type":"array","title":"Habits To Adopt"},"habits_to_avoid":{"items":{"type":"string"},"type":"array","title":"Habits To Avoid"},"morning_routine":{"type":"string","title":"Morning Routine"},"evening_routine":{"type":"string","title":"Evening Routine"},"social_guidelines":{"items":{"type":"string"},"type":"array","title":"Social Guidelines"},"work_guidelines":{"items":{"type":"string"},"type":"array","title":"Work Guidelines"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["habits_to_adopt","habits_to_avoid","morning_routine","evening_routine","social_guidelines","work_guidelines","reason"],"title":"BehavioralRemedy","description":"Behavioral modifications."},"BestPeriodOut":{"properties":{"start_day":{"type":"integer","title":"Start Day"},"length":{"type":"integer","title":"Length"}},"type":"object","required":["length"],"title":"BestPeriodOut"},"BestWindowOut":{"properties":{"start_time":{"type":"string","title":"Start Time"},"end_time":{"type":"string","title":"End Time"},"duration_minutes":{"type":"integer","title":"Duration Minutes"},"score":{"type":"number","title":"Score"},"quality":{"type":"string","title":"Quality"},"suitability":{"type":"string","title":"Suitability"},"reasons":{"items":{"type":"object"},"type":"array","title":"Reasons"},"strengths":{"items":{"type":"string"},"type":"array","title":"Strengths"},"weaknesses":{"items":{"type":"string"},"type":"array","title":"Weaknesses"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"component_scores":{"additionalProperties":{"type":"number"},"type":"object","title":"Component Scores"},"score_weights":{"additionalProperties":{"type":"number"},"type":"object","title":"Score Weights"},"factors":{"type":"object","title":"Factors"},"planetary_balas":{"items":{"type":"object"},"type":"array","title":"Planetary Balas"}},"type":"object","required":["start_time","end_time","duration_minutes","score","quality","suitability"],"title":"BestWindowOut","description":"The highest-scoring window, with the same auditable shape as all rows."},"BhakootDoshaAnalysis":{"properties":{"has_bhakoot_dosha":{"type":"boolean","title":"Has Bhakoot Dosha"},"dosha_type":{"type":"string","title":"Dosha Type","description":"Dhana (2/12) or Roga (6/8)"},"bride_rashi":{"type":"string","title":"Bride Rashi"},"groom_rashi":{"type":"string","title":"Groom Rashi"},"position":{"type":"string","title":"Position"},"expected_effects":{"items":{"type":"string"},"type":"array","title":"Expected Effects"},"cancellation_rules":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Cancellation Rules"},"applicable_cancellations":{"items":{"type":"string"},"type":"array","title":"Applicable Cancellations"},"is_cancelled":{"type":"boolean","title":"Is Cancelled","default":false},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"}},"type":"object","required":["has_bhakoot_dosha","bride_rashi","groom_rashi","position"],"title":"BhakootDoshaAnalysis","description":"Detailed Bhakoot Dosha (6/8 or 2/12 position) analysis.\n\nAttributes:\n has_bhakoot_dosha: Whether dosha exists\n dosha_type: Type of Bhakoot dosha\n bride_rashi: Bride's Moon sign\n groom_rashi: Groom's Moon sign\n position: Relative position (6/8, 2/12, etc.)\n effects: Expected negative effects\n cancellation_rules: Rules that can cancel the dosha\n is_cancelled: Whether effectively cancelled\n remedies: Suggested remedies"},"BhakootKoota":{"properties":{"name":{"type":"string","title":"Name"},"max_points":{"type":"number","title":"Max Points"},"obtained_points":{"type":"number","title":"Obtained Points"},"percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Percentage"},"bride_value":{"type":"string","title":"Bride Value"},"groom_value":{"type":"string","title":"Groom Value"},"compatibility_status":{"type":"string","title":"Compatibility Status","description":"Good, Average, or Poor"},"description":{"type":"string","title":"Description"},"analysis":{"type":"string","title":"Analysis"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"bride_rashi":{"type":"string","title":"Bride Rashi"},"groom_rashi":{"type":"string","title":"Groom Rashi"},"rashi_position":{"type":"string","title":"Rashi Position","description":"Position like 2/12, 6/8, 5/9, etc."},"has_bhakoot_dosha":{"type":"boolean","title":"Has Bhakoot Dosha"},"dosha_type":{"type":"string","title":"Dosha Type","description":"Dhana (2/12) or Roga (6/8) Bhakoot Dosha"},"is_cancelled":{"type":"boolean","title":"Is Cancelled","default":false},"cancellation_reason":{"type":"string","title":"Cancellation Reason"}},"type":"object","required":["name","max_points","obtained_points","percentage","bride_value","groom_value","compatibility_status","description","analysis","bride_rashi","groom_rashi","rashi_position","has_bhakoot_dosha"],"title":"BhakootKoota","description":"Bhakoot Koota - Emotional/Financial compatibility (7 points).\n\nBased on Moon sign relationship (Rashi placement).\n\nRules:\n- 2/12 position = Dhana Bhakoot Dosha (financial problems)\n- 6/8 position = Roga Bhakoot Dosha (health/quarrel problems)\n- 5/9 position = Excellent (7 points)\n- 3/11, 4/10 = Good (7 points)\n- Exceptions exist for certain combinations"},"BhavaBala":{"properties":{"house":{"type":"integer","title":"House"},"sign":{"type":"integer","title":"Sign"},"sign_name":{"type":"string","title":"Sign Name"},"house_lord":{"type":"string","title":"House Lord"},"bhava_dig_bala":{"type":"number","title":"Bhava Dig Bala"},"bhava_drishti_bala":{"type":"number","title":"Bhava Drishti Bala"},"bhava_adhipati_bala":{"type":"number","title":"Bhava Adhipati Bala"},"occupancy_bala":{"type":"number","title":"Occupancy Bala","default":0.0},"time_sign_bala":{"type":"number","title":"Time Sign Bala","default":0.0},"total_strength_virupas":{"type":"number","title":"Total Strength Virupas"},"total_strength_rupas":{"type":"number","title":"Total Strength Rupas"},"strength_category":{"$ref":"#/components/schemas/StrengthCategory"},"house_significations":{"items":{"type":"string"},"type":"array","title":"House Significations"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["house","sign","sign_name","house_lord","bhava_dig_bala","bhava_drishti_bala","bhava_adhipati_bala","total_strength_virupas","total_strength_rupas","strength_category","house_significations","interpretation"],"title":"BhavaBala","description":"Complete house strength."},"BhavaBalaAnalysis":{"properties":{"birth_details":{"$ref":"#/components/schemas/ShadbalaBirthDetails"},"bhava_strengths":{"items":{"$ref":"#/components/schemas/BhavaBala"},"type":"array","title":"Bhava Strengths"},"strongest_houses":{"items":{"type":"integer"},"type":"array","title":"Strongest Houses"},"weakest_houses":{"items":{"type":"integer"},"type":"array","title":"Weakest Houses"},"calculation_standard":{"type":"string","title":"Calculation Standard","default":"BPHS chapters 26-27"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"type":"object","required":["birth_details","bhava_strengths","strongest_houses","weakest_houses"],"title":"BhavaBalaAnalysis","description":"Complete Bhava Bala analysis."},"BhinnashtakavargaChart":{"properties":{"planet":{"type":"string","title":"Planet"},"bindu_contributions":{"items":{"$ref":"#/components/schemas/PlanetBinduRow"},"type":"array","title":"Bindu Contributions"},"sign_totals":{"items":{"type":"integer"},"type":"array","title":"Sign Totals"},"total_bindus":{"type":"integer","title":"Total Bindus"},"strongest_signs":{"items":{"type":"integer"},"type":"array","title":"Strongest Signs"},"weakest_signs":{"items":{"type":"integer"},"type":"array","title":"Weakest Signs"}},"type":"object","required":["planet","bindu_contributions","sign_totals","total_bindus","strongest_signs","weakest_signs"],"title":"BhinnashtakavargaChart","description":"Bhinnashtakavarga for a single planet."},"BhinnashtakavargaData":{"properties":{"planet":{"type":"string","title":"Planet","description":"Planet name (Sun, Moon, Mars, etc.)"},"bindus_by_sign":{"additionalProperties":{"type":"integer"},"type":"object","title":"Bindus By Sign","description":"Sign index (0-11) to bindu count mapping"},"total_bindus":{"type":"integer","minimum":0.0,"title":"Total Bindus","description":"Total bindus across all signs"},"max_possible":{"type":"integer","title":"Max Possible","description":"Maximum possible bindus for this planet"},"sign_names":{"additionalProperties":{"type":"string"},"type":"object","title":"Sign Names","description":"Sign index to name mapping for readability"}},"type":"object","required":["planet","bindus_by_sign","total_bindus","max_possible","sign_names"],"title":"BhinnashtakavargaData","description":"Bhinnashtakavarga (BAV) data for a single planet.\n\nContains the bindu (benefic point) count for each of the 12 signs,\ncontributed by all 8 sources (7 planets + Ascendant).\n\nAttributes:\n planet: The planet this BAV belongs to\n bindus_by_sign: Dictionary mapping sign index (0-11) to bindu count\n total_bindus: Total bindus for this planet across all signs\n max_possible: Maximum possible bindus for this planet\n sign_names: Human-readable sign names for reference"},"BillingCycle":{"type":"string","enum":["monthly","quarterly","yearly","lifetime"],"title":"BillingCycle","description":"Billing cycle options."},"BirthChartRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"calculate_dashas":{"type":"boolean","title":"Calculate Dashas","default":true},"calculate_doshas":{"type":"boolean","title":"Calculate Doshas","default":true},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_details"],"title":"BirthChartRequest","description":"Request model for birth chart calculations.\n\nAttributes:\n birth_details: Birth details including date, location, and timezone\n calculate_dashas: Whether to calculate dasha periods (default: True)\n calculate_doshas: Whether to calculate doshas (default: True)\n ayanamsa: Optional Parashari sidereal ayanamsa (default Lahiri)"},"BirthChartResponse":{"properties":{"chart":{"$ref":"#/components/schemas/KundaliChart"},"dashas":{"items":{"$ref":"#/components/schemas/app__schemas__kundali__DashaPeriod"},"type":"array","title":"Dashas"},"doshas":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Doshas"},"system":{"type":"string","title":"System","description":"Named astrology engine id (parashari | kp | …)","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied for this Parashari chart","default":"Lahiri"}},"type":"object","required":["chart"],"title":"BirthChartResponse","description":"Response model for birth chart calculations.\n\nAttributes:\n chart: The complete birth chart with all planetary positions and calculations\n dashas: Dasha periods if calculated\n doshas: Dosha information if calculated"},"BirthDataRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in YYYY-MM-DD format"},"birth_time":{"type":"string","title":"Birth Time","description":"Birth time in HH:MM format (24-hour)"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Birth latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Birth longitude"},"ascendant_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Ascendant Longitude","description":"Ascendant longitude in degrees"},"moon_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Moon Longitude","description":"Moon longitude in degrees"},"sun_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Sun Longitude","description":"Sun longitude in degrees"},"planets":{"additionalProperties":{"type":"number"},"type":"object","title":"Planets","description":"Planet longitudes"},"sunrise_time":{"type":"string","title":"Sunrise Time","description":"Sunrise in HH:MM local time. Omitted, it is read from the ephemeris for the given latitude and longitude."},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone of the birth place, e.g. Asia/Kolkata. Omitted, the offset is derived from the longitude, which is within about half an hour of political time nearly everywhere. Supply it for an exact sunrise, since every lagna here is measured from sunrise.","example":"Asia/Kolkata"}},"type":"object","required":["birth_date","birth_time","latitude","longitude","ascendant_longitude","moon_longitude","sun_longitude"],"title":"BirthDataRequest"},"BirthDetails":{"properties":{"date":{"type":"string","format":"date-time","title":"Date"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","minLength":1,"title":"Timezone","default":"UTC"}},"type":"object","required":["date","latitude","longitude"],"title":"BirthDetails"},"BirthDetailsRequest":{"properties":{"date_of_birth":{"type":"string","format":"date-time","title":"Date Of Birth","description":"Birth date and time"},"birth_time":{"type":"string","title":"Birth Time","description":"Birth time in HH:MM format"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Birth place latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Birth place longitude"},"timezone":{"type":"string","title":"Timezone","description":"Birth timezone (e.g., Asia/Kolkata)"},"place_name":{"type":"string","title":"Place Name","description":"Birth place name"}},"type":"object","required":["date_of_birth","latitude","longitude","timezone"],"title":"BirthDetailsRequest"},"Body_update_recommendation_profile_api_v1_recommendations_profile_put":{"properties":{"preferred_languages":{"items":{"type":"string"},"type":"array","title":"Preferred Languages"},"preferred_specializations":{"items":{"type":"string"},"type":"array","title":"Preferred Specializations"}},"type":"object","title":"Body_update_recommendation_profile_api_v1_recommendations_profile_put"},"Bookmark":{"properties":{"id":{"type":"string","title":"Id"},"chapter":{"type":"integer","title":"Chapter"},"verse_id":{"type":"string","title":"Verse Id"},"note":{"type":"string","title":"Note"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","chapter","created_at"],"title":"Bookmark"},"BookmarkCreate":{"properties":{"chapter":{"type":"integer","title":"Chapter"},"verse_id":{"type":"string","title":"Verse Id"},"note":{"type":"string","title":"Note"}},"type":"object","required":["chapter"],"title":"BookmarkCreate"},"BookmarkUpdate":{"properties":{"note":{"type":"string","title":"Note"}},"type":"object","title":"BookmarkUpdate"},"CalendarDayOut":{"properties":{"date":{"type":"string","title":"Date"},"weekday":{"type":"string","title":"Weekday"},"quality":{"type":"string","title":"Quality"},"score":{"type":"integer","title":"Score"},"moon_sign":{"type":"string","title":"Moon Sign"},"tithi":{"type":"string","title":"Tithi"}},"type":"object","required":["date","weekday","quality","score","moon_sign","tithi"],"title":"CalendarDayOut"},"CancelSubscriptionRequest":{"properties":{"reason":{"type":"string","title":"Reason"},"cancel_immediately":{"type":"boolean","title":"Cancel Immediately","default":false}},"type":"object","title":"CancelSubscriptionRequest","description":"Request to cancel subscription."},"CareerAnalysisResponse":{"properties":{"amatyakaraka":{"allOf":[{"$ref":"#/components/schemas/app__schemas__jaimini__JaiminiKaraka"}],"title":"Amatyakaraka","description":"Amatyakaraka analysis"},"karma_pada":{"allOf":[{"$ref":"#/components/schemas/ArudhaPada"}],"title":"Karma Pada","description":"A10 (Karma Pada) analysis"},"tenth_from_karakamsha":{"type":"object","title":"Tenth From Karakamsha","description":"10th from Karakamsha"},"career_indications":{"items":{"type":"string"},"type":"array","title":"Career Indications"},"suitable_professions":{"items":{"type":"string"},"type":"array","title":"Suitable Professions"},"career_timing":{"items":{"type":"string"},"type":"array","title":"Career Timing"},"success_factors":{"items":{"type":"string"},"type":"array","title":"Success Factors"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"jaimini"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["amatyakaraka","karma_pada","tenth_from_karakamsha"],"title":"CareerAnalysisResponse","description":"Jaimini career analysis using Amatyakaraka and A10."},"CategoryAnalysisRequest":{"properties":{"planet_positions":{"additionalProperties":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0},"type":"object","title":"Planet Positions","description":"Dictionary of planet names to longitudes (0 <= x < 360)"},"ascendant":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Ascendant","description":"Lagna longitude. Required for the dala and akriti categories, which are counted from the ascendant; ashraya and sankhya are counted over signs and do not need it."},"category":{"type":"string","title":"Category","description":"Category to analyze: ashraya, dala, akriti, or sankhya"},"benefics":{"items":{"type":"string"},"type":"array","title":"Benefics"},"malefics":{"items":{"type":"string"},"type":"array","title":"Malefics"}},"type":"object","required":["planet_positions","category"],"title":"CategoryAnalysisRequest"},"CeremonySession":{"properties":{"version":{"type":"integer","minimum":1.0,"title":"Version","default":1},"status":{"type":"string","enum":["not_started","active","paused","completed"],"title":"Status","default":"not_started"},"active_step_id":{"type":"string","maxLength":80,"title":"Active Step Id"},"steps":{"items":{"$ref":"#/components/schemas/CeremonyStepProgress"},"type":"array","maxItems":80,"title":"Steps"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"paused_at":{"type":"string","format":"date-time","title":"Paused At"},"completed_at":{"type":"string","format":"date-time","title":"Completed At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","title":"CeremonySession"},"CeremonyStepProgress":{"properties":{"step_id":{"type":"string","maxLength":80,"minLength":1,"title":"Step Id"},"status":{"type":"string","enum":["pending","active","completed","skipped"],"title":"Status","default":"pending"},"is_optional":{"type":"boolean","title":"Is Optional","default":false},"target_repetitions":{"type":"integer","maximum":1008.0,"minimum":0.0,"title":"Target Repetitions","default":0},"target_duration_minutes":{"type":"integer","maximum":720.0,"minimum":0.0,"title":"Target Duration Minutes","default":0},"repetitions_completed":{"type":"integer","maximum":100000.0,"minimum":0.0,"title":"Repetitions Completed","default":0},"elapsed_seconds":{"type":"integer","maximum":604800.0,"minimum":0.0,"title":"Elapsed Seconds","default":0},"timer_started_at":{"type":"string","format":"date-time","title":"Timer Started At"},"completed_at":{"type":"string","format":"date-time","title":"Completed At"}},"type":"object","required":["step_id"],"title":"CeremonyStepProgress"},"ChakraCell":{"properties":{"row":{"type":"integer","maximum":8.0,"minimum":0.0,"title":"Row"},"col":{"type":"integer","maximum":8.0,"minimum":0.0,"title":"Col"},"content":{"type":"string","title":"Content"},"content_type":{"type":"string","title":"Content Type"},"is_corner":{"type":"boolean","title":"Is Corner","default":false},"associated_nakshatra":{"type":"string","title":"Associated Nakshatra"}},"type":"object","required":["row","col","content","content_type"],"title":"ChakraCell","description":"Individual cell in Sarvatobhadra Chakra"},"ChandraBala":{"properties":{"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"quality":{"type":"string","title":"Quality"},"is_chandrashtama":{"type":"boolean","title":"Is Chandrashtama","default":false},"note":{"type":"string","title":"Note"}},"type":"object","required":["house","quality","note"],"title":"ChandraBala","description":"Chandra Bala — the transiting Moon's house from the natal rashi\n(favourable in 1,3,6,7,10,11; the 8th is Chandrashtama)."},"ChandraYogaSummary":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"yogas":{"items":{"$ref":"#/components/schemas/YogaData"},"type":"array","title":"Yogas"},"moon_strength":{"type":"string","title":"Moon Strength"},"emotional_stability":{"type":"string","title":"Emotional Stability"},"kemadruma_present":{"type":"boolean","title":"Kemadruma Present","default":false},"kemadruma_cancelled":{"type":"boolean","title":"Kemadruma Cancelled","default":false}},"type":"object","required":["total_count","yogas","moon_strength","emotional_stability"],"title":"ChandraYogaSummary","description":"Summary of Chandra (Moon) Yogas.\n\nAttributes:\n total_count: Number of Moon yogas present\n yogas: List of individual Moon yoga details\n moon_strength: Moon's overall strength\n emotional_stability: Emotional stability indication\n kemadruma_present: Whether Kemadruma (isolation) yoga exists\n kemadruma_cancelled: Whether Kemadruma is cancelled"},"ChandrabalaBandOut":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"transit_moon_rashi":{"$ref":"#/components/schemas/TransitBodyOut"},"paksha":{"type":"string","title":"Paksha"},"is_shukla_paksha":{"type":"boolean","title":"Is Shukla Paksha"},"entries":{"items":{"$ref":"#/components/schemas/ChandrabalaEntryOut"},"type":"array","title":"Entries"}},"type":"object","required":["start","end","transit_moon_rashi","paksha","is_shukla_paksha"],"title":"ChandrabalaBandOut","description":"The whole Chandra table over one stretch of the day.\n\nCut by the Moon's rashi *and* by the paksha, because the rule reads both:\nthe 2nd, 5th and 9th houses from the Moon are favourable in Shukla Paksha\nand mixed otherwise, so a paksha that turns at 13:21 turns three rashis'\nverdict with it. Clipped to the vara day like a Tara band, with the same\ncaveat about the last ``end``."},"ChandrabalaEntryOut":{"properties":{"rashi_number":{"type":"integer","title":"Rashi Number"},"rashi":{"type":"string","title":"Rashi"},"house_from_birth":{"type":"integer","title":"House From Birth"},"quality":{"type":"string","title":"Quality"},"is_favorable":{"type":"boolean","title":"Is Favorable"},"strength_score":{"type":"number","title":"Strength Score"}},"type":"object","required":["rashi_number","rashi","house_from_birth","quality","is_favorable","strength_score"],"title":"ChandrabalaEntryOut","description":"Today's Chandra Bala for one birth rashi."},"ChandrabalaResponse":{"properties":{"birth_rashi":{"type":"string","title":"Birth Rashi"},"transit_moon_rashi":{"type":"string","title":"Transit Moon Rashi"},"house_from_birth":{"type":"integer","title":"House From Birth"},"quality":{"type":"string","title":"Quality"},"is_favorable":{"type":"boolean","title":"Is Favorable"},"strength_score":{"type":"number","title":"Strength Score"},"favorable_activities":{"items":{"type":"string"},"type":"array","title":"Favorable Activities"},"unfavorable_activities":{"items":{"type":"string"},"type":"array","title":"Unfavorable Activities"},"description":{"type":"string","title":"Description"}},"type":"object","required":["birth_rashi","transit_moon_rashi","house_from_birth","quality","is_favorable","strength_score","description"],"title":"ChandrabalaResponse","description":"GET /advanced-muhurta/chandrabala"},"ChandrashtamaNakshatra":{"properties":{"number":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Number","description":"One-based nakshatra (1 = Ashwini)"},"name":{"type":"string","title":"Name","description":"Name of the nakshatra"},"padas":{"items":{"type":"integer"},"type":"array","maxItems":4,"minItems":1,"title":"Padas","description":"Which of this nakshatra's padas fall in the afflicted rashi, ascending. All four for the whole nakshatra every rashi contains."},"is_whole":{"type":"boolean","title":"Is Whole","description":"True when all four padas are caught, so a client can print \"Rohini\" plain and \"Krittika (2, 3, 4)\" qualified without knowing that a nakshatra has four padas."}},"type":"object","required":["number","name","padas","is_whole"],"title":"ChandrashtamaNakshatra","description":"One janma nakshatra caught by a Chandrashtama, and by which of its padas.\n\nA rashi is nine of the circle's 108 padas and a nakshatra is four, so a rashi\nalways touches exactly three nakshatras and never on all three's boundaries:\neither two whole and one fragment (Mesha is Ashwini, Bharani and one pada of\nKrittika) or one whole and two fragments (Vrishabha is the rest of Krittika,\nRohini, and half of Mrigashira). The fragments are the reason this is\npublished per pada: on the day Chandrashtama falls to Vrishabha it falls to\nthe reader born in Krittika pada 2, 3 or 4 and NOT to the one born in pada 1,\nwhose rashi is Mesha. A row that named the nakshatra alone would tell a quarter\nof Krittika the wrong thing, and printed panchangams state the padas for\nexactly this reason."},"ChandrashtamaRashi":{"properties":{"number":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Number","description":"Rashi number (1-12)"},"name":{"type":"string","title":"Name","description":"Sanskrit name, e.g. Vrishabha"},"name_en":{"type":"string","title":"Name En","description":"English name, e.g. Taurus"}},"type":"object","required":["number","name","name_en"],"title":"ChandrashtamaRashi","description":"A rashi named as a whole sign, with no degree inside it.\n\nDeliberately not :class:`MoonRashi`, which carries ``degrees``. A degree is a\nreading at one instant, and both rashis in a Chandrashtama row are spans: the\nafflicted one has no Moon in it at all, and the transited one is named for the\nwhole stretch between its ingress and its egress. Publishing a ``degrees`` here\nwould have to pick a moment, and whichever moment it picked would be wrong for\nthe rest of the row."},"ChandrashtamaRow":{"properties":{"start":{"type":"string","format":"date-time","title":"Start","description":"When the Moon entered this rashi; may precede the day's sunrise"},"end":{"type":"string","format":"date-time","title":"End","description":"When it leaves; may follow the next sunrise"},"transit_moon_rashi":{"allOf":[{"$ref":"#/components/schemas/ChandrashtamaRashi"}],"title":"Transit Moon Rashi","description":"The rashi the Moon is standing in for this stretch"},"rashi":{"allOf":[{"$ref":"#/components/schemas/ChandrashtamaRashi"}],"title":"Rashi","description":"The afflicted rashi -- the one whose eighth the Moon is standing in. Its janma nakshatras are in `nakshatras`."},"nakshatras":{"items":{"$ref":"#/components/schemas/ChandrashtamaNakshatra"},"type":"array","title":"Nakshatras","description":"The janma nakshatras of the afflicted rashi, with padas. Always three of them, in ascending order, at least one of them partial."}},"type":"object","required":["start","end","transit_moon_rashi","rashi","nakshatras"],"title":"ChandrashtamaRow","description":"Whose Chandrashtama this stretch of the day is.\n\nChandrashtama is the Moon standing in the eighth rashi from a birth Moon. The\nMoon is in one rashi at a time, so at every instant there is exactly one rashi\nit is the eighth of -- which makes this publishable with no chart at all, the\nway a South-Indian panchangam prints it, and the way this response already\npublishes Rahu Kaal.\n\n``start`` and ``end`` are the Moon's real ingress into and egress from\n``transit_moon_rashi``, UNCLIPPED, so they may lie outside this day. That is\ndeliberate and it is the number a reader needs: Chandrashtama is a thing you\ndefer a beginning past, and \"it ends when this page stops\" is not a time. One\ninstant for the whole planet, too -- no latitude enters a sign ingress, so two\ncities can honestly print the same Chandrashtama under different dates."},"CharaDashaPeriod":{"properties":{"sign":{"type":"string","title":"Sign","description":"Zodiac sign ruling this period"},"sign_lord":{"type":"string","title":"Sign Lord","description":"Lord of the sign"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date of the period"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End date of the period"},"duration_years":{"type":"integer","title":"Duration Years","description":"Duration in years (1-12)"},"karakamsha_relation":{"type":"string","title":"Karakamsha Relation","description":"Relation to Karakamsha"},"predictions":{"items":{"type":"string"},"type":"array","title":"Predictions","description":"Predictions for this period"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Strength of the period"},"is_beneficial":{"type":"boolean","title":"Is Beneficial","description":"Whether period is beneficial"}},"type":"object","required":["sign","sign_lord","start_date","end_date","duration_years","karakamsha_relation","strength","is_beneficial"],"title":"CharaDashaPeriod","description":"Model for a Chara (Jaimini) Dasha period - sign-based."},"CharaDashaResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in ISO format"},"dasha_system":{"type":"string","title":"Dasha System","description":"Dasha system used","default":"chara"},"karakas":{"items":{"$ref":"#/components/schemas/JaiminiKarakaInfo"},"type":"array","title":"Karakas","description":"Jaimini Karakas"},"karakamsha":{"type":"string","title":"Karakamsha","description":"Karakamsha sign"},"periods":{"items":{"$ref":"#/components/schemas/CharaDashaPeriod"},"type":"array","title":"Periods","description":"Chara Dasha periods"},"current_period":{"allOf":[{"$ref":"#/components/schemas/CharaDashaPeriod"}],"title":"Current Period","description":"Current period"},"next_period":{"allOf":[{"$ref":"#/components/schemas/CharaDashaPeriod"}],"title":"Next Period","description":"Next period"},"summary":{"type":"string","title":"Summary","description":"Summary of Chara Dasha"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations","description":"Recommendations"}},"type":"object","required":["birth_date","karakas","karakamsha","periods","summary"],"title":"CharaDashaResponse","description":"Response model for Chara Dasha calculations."},"CharityItem":{"properties":{"item":{"type":"string","title":"Item"},"quantity":{"type":"string","title":"Quantity"},"monetary_equivalent":{"type":"string","title":"Monetary Equivalent"},"ruling_planet":{"type":"string","title":"Ruling Planet"},"cause_category":{"allOf":[{"$ref":"#/components/schemas/DanaCauseCategory"}],"default":"general"}},"type":"object","required":["item","quantity","ruling_planet"],"title":"CharityItem","description":"Item or service for charity."},"CharityRecommendation":{"properties":{"primary_charities":{"items":{"$ref":"#/components/schemas/CharityRemedy"},"type":"array","title":"Primary Charities"},"monthly_charity_schedule":{"additionalProperties":{"type":"string"},"type":"object","title":"Monthly Charity Schedule"},"annual_charity_occasions":{"items":{"type":"string"},"type":"array","title":"Annual Charity Occasions"}},"type":"object","required":["primary_charities","monthly_charity_schedule","annual_charity_occasions"],"title":"CharityRecommendation","description":"Complete charity recommendation set."},"CharityRemedy":{"properties":{"charity_type":{"type":"string","title":"Charity Type"},"items":{"items":{"$ref":"#/components/schemas/CharityItem"},"type":"array","title":"Items"},"reason":{"type":"string","title":"Reason"},"planet_pacified":{"type":"string","title":"Planet Pacified"},"cause_category":{"allOf":[{"$ref":"#/components/schemas/DanaCauseCategory"}],"default":"general"},"monetary_band":{"type":"string","title":"Monetary Band"},"best_day":{"type":"string","title":"Best Day"},"best_time":{"type":"string","title":"Best Time"},"best_tithi":{"type":"string","title":"Best Tithi"},"recommended_recipient":{"type":"string","title":"Recommended Recipient"},"donation_location":{"type":"string","title":"Donation Location"},"mental_attitude":{"type":"string","title":"Mental Attitude"},"sankalpa":{"type":"string","title":"Sankalpa"},"frequency":{"type":"string","title":"Frequency"},"shastra_note":{"type":"string","title":"Shastra Note"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["charity_type","items","reason","planet_pacified","best_day","best_time","recommended_recipient","donation_location","mental_attitude","sankalpa","frequency","effectiveness_score"],"title":"CharityRemedy","description":"Charity recommendation."},"ChartCellData":{"properties":{"row":{"type":"integer","minimum":0.0,"title":"Row"},"col":{"type":"integer","minimum":0.0,"title":"Col"},"house_number":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House Number"},"sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Index"},"sign_name":{"type":"string","title":"Sign Name"},"sign_abbreviation":{"type":"string","title":"Sign Abbreviation"},"planets":{"items":{"type":"string"},"type":"array","title":"Planets"},"is_ascendant":{"type":"boolean","title":"Is Ascendant","default":false},"aspects_from":{"items":{"type":"string"},"type":"array","title":"Aspects From"}},"type":"object","required":["row","col","house_number","sign_index","sign_name","sign_abbreviation"],"title":"ChartCellData","description":"Data for a single cell in the chart grid.\n\nAttributes:\n row: Row position in grid (0-indexed)\n col: Column position in grid (0-indexed)\n house_number: House number in this cell (1-12)\n sign_index: Sign index in this cell (0-11)\n sign_name: Name of the sign (Mesha, Vrishabha, etc.)\n sign_abbreviation: Short form of sign name\n planets: List of planets in this cell\n is_ascendant: Whether this cell contains the Ascendant\n aspects_from: Planets aspecting this cell"},"ChartExportRequest":{"properties":{"ascendant":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Ascendant","description":"Ascendant degrees"},"planets":{"items":{"$ref":"#/components/schemas/app__routers__chart_export__PlanetPosition"},"type":"array","title":"Planets","description":"Planet positions"},"houses":{"items":{"type":"number"},"type":"array","title":"Houses","description":"House cusps (12 values)"},"style":{"allOf":[{"$ref":"#/components/schemas/ChartStyle"}],"description":"Chart style","default":"north_indian"},"title":{"type":"string","title":"Title","description":"Chart title"},"subtitle":{"type":"string","title":"Subtitle","description":"Chart subtitle"},"format":{"allOf":[{"$ref":"#/components/schemas/app__services__chart_export__ExportFormat"}],"description":"Export format","default":"svg"},"width":{"type":"integer","maximum":1200.0,"minimum":200.0,"title":"Width","description":"Chart width","default":400},"height":{"type":"integer","maximum":1200.0,"minimum":200.0,"title":"Height","description":"Chart height","default":400}},"type":"object","required":["ascendant","planets"],"title":"ChartExportRequest","description":"Request for chart export."},"ChartLayoutData":{"properties":{"style":{"type":"string","title":"Style"},"style_name":{"type":"string","title":"Style Name"},"grid_rows":{"type":"integer","title":"Grid Rows"},"grid_cols":{"type":"integer","title":"Grid Cols"},"cells":{"items":{"$ref":"#/components/schemas/ChartCellData"},"type":"array","title":"Cells"},"planets":{"items":{"$ref":"#/components/schemas/PlanetCellInfo"},"type":"array","title":"Planets"},"ascendant_sign":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Ascendant Sign"},"ascendant_house":{"type":"integer","title":"Ascendant House","default":1},"center_text":{"type":"string","title":"Center Text"},"render_hints":{"additionalProperties":{"type":"string"},"type":"object","title":"Render Hints"}},"type":"object","required":["style","style_name","grid_rows","grid_cols","cells","planets","ascendant_sign"],"title":"ChartLayoutData","description":"Complete layout data for rendering a chart in a specific regional style.\n\nAttributes:\n style: Chart style (north_indian, south_indian, east_indian)\n style_name: Display name for the style\n grid_rows: Number of rows in the grid\n grid_cols: Number of columns in the grid\n cells: All cell data for the chart\n planets: Planet placement information\n ascendant_sign: Ascendant sign index\n ascendant_house: Ascendant house (always 1)\n center_text: Text to display in center (if applicable)\n render_hints: Additional rendering hints"},"ChartStyle":{"type":"string","enum":["north_indian","south_indian","east_indian","western"],"title":"ChartStyle","description":"Chart visual styles."},"ChartStyleRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"chart_style":{"type":"string","title":"Chart Style","description":"Chart style: north_indian, south_indian, east_indian","default":"south_indian"},"language":{"type":"string","title":"Language","description":"Language for labels: sanskrit, english, hindi","default":"english"},"color_scheme":{"type":"string","title":"Color Scheme","description":"Color scheme: traditional, modern, dark","default":"traditional"},"include_aspects":{"type":"boolean","title":"Include Aspects","default":true},"include_nakshatras":{"type":"boolean","title":"Include Nakshatras","default":false},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_details"],"title":"ChartStyleRequest","description":"Request model for chart generation with specific style.\n\nAttributes:\n birth_details: Birth details for chart calculation\n chart_style: Regional chart style to use\n language: Language for labels (sanskrit, english, hindi)\n color_scheme: Color scheme for rendering\n include_aspects: Whether to include aspect information\n include_nakshatras: Whether to include nakshatra info in cells"},"ChartStyleResponse":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"chart_style":{"type":"string","title":"Chart Style"},"layout":{"$ref":"#/components/schemas/ChartLayoutData"},"d1_chart":{"$ref":"#/components/schemas/ChartLayoutData"},"additional_charts":{"additionalProperties":{"$ref":"#/components/schemas/ChartLayoutData"},"type":"object","title":"Additional Charts"},"color_scheme":{"additionalProperties":{"type":"string"},"type":"object","title":"Color Scheme"},"metadata":{"additionalProperties":{"type":"string"},"type":"object","title":"Metadata"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["birth_details","chart_style","layout","color_scheme"],"title":"ChartStyleResponse","description":"Response model with chart data formatted for specific regional style.\n\nAttributes:\n birth_details: Original birth details\n chart_style: Style used for this chart\n layout: Complete layout data for rendering\n d1_chart: D1 (Rashi) chart layout\n additional_charts: Optional additional divisional chart layouts\n color_scheme: Color values for rendering\n metadata: Additional chart metadata"},"ChartTimelineRequest":{"properties":{"user_id":{"type":"string","title":"User Id","description":"Chart owner id (chart-… from saved kundli)"},"chart_data":{"type":"object","title":"Chart Data","description":"Natal anchors: ascendant, moon_sign, current_dasha, optional antardasha"},"period":{"allOf":[{"$ref":"#/components/schemas/TimelinePeriod"}],"default":"3_months"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"min_significance":{"type":"string","title":"Min Significance","description":"major | moderate | minor"}},"type":"object","required":["user_id","chart_data"],"title":"ChartTimelineRequest"},"CheckoutSessionResponse":{"properties":{"session_id":{"type":"string","title":"Session Id"},"checkout_url":{"type":"string","title":"Checkout Url"},"razorpay_subscription_id":{"type":"string","title":"Razorpay Subscription Id"},"razorpay_key":{"type":"string","title":"Razorpay Key"},"stripe_session_id":{"type":"string","title":"Stripe Session Id"}},"type":"object","required":["session_id"],"title":"CheckoutSessionResponse","description":"Checkout session for payment."},"ChestaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"is_retrograde":{"type":"boolean","title":"Is Retrograde"},"is_combust":{"type":"boolean","title":"Is Combust"},"daily_motion":{"type":"number","title":"Daily Motion"},"mean_daily_motion":{"type":"number","title":"Mean Daily Motion"},"motion_type":{"type":"string","title":"Motion Type"},"strength_virupas":{"type":"number","title":"Strength Virupas"},"strength_rupas":{"type":"number","title":"Strength Rupas"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["planet","is_retrograde","is_combust","daily_motion","mean_daily_motion","motion_type","strength_virupas","strength_rupas","interpretation"],"title":"ChestaBala","description":"Motional Strength."},"ChoghadiyaOut":{"properties":{"name":{"type":"string","title":"Name"},"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"quality":{"type":"string","title":"Quality"},"planet":{"type":"string","title":"Planet"},"is_auspicious":{"type":"boolean","title":"Is Auspicious"},"suitable_for":{"items":{"type":"string"},"type":"array","title":"Suitable For"},"not_suitable_for":{"items":{"type":"string"},"type":"array","title":"Not Suitable For"}},"type":"object","required":["name","start","end","quality","planet","is_auspicious"],"title":"ChoghadiyaOut"},"ChoghadiyaPeriod":{"properties":{"start":{"type":"string","title":"Start","description":"Start time in ISO format"},"end":{"type":"string","title":"End","description":"End time in ISO format"},"type":{"type":"string","title":"Type","description":"Amrit, Shubh, Labh, Char, Udveg, Rog or Kaal"},"period":{"type":"string","title":"Period","description":"'day' or 'night'"},"system":{"type":"string","title":"System","description":"Ephemeris system used"}},"type":"object","required":["start","end","type","period"],"title":"ChoghadiyaPeriod","description":"One choghadiya: an eighth of the daylight, or of the night."},"ClosingVerse":{"properties":{"citation":{"type":"string","title":"Citation"},"sanskrit":{"type":"string","title":"Sanskrit"},"text":{"type":"string","title":"Text"},"attribution":{"type":"string","title":"Attribution"},"work":{"type":"string","title":"Work"},"source_url":{"type":"string","title":"Source Url"},"matched_moon_house":{"type":"integer","title":"Matched Moon House"}},"type":"object","required":["citation","sanskrit","text","attribution"],"title":"ClosingVerse","description":"The quoted verse a daily reading closes on.\n\nThe only text in a reading that is not generated, so the fields keep the\nquotation and the rendering apart: `sanskrit` and `citation` are quoted from\na recorded source revision, `text` is this app's own plain rendering, and\n`attribution` says so on the page. See app/services/closing_verse.py."},"ColorRemedy":{"properties":{"colors_to_wear":{"items":{"type":"string"},"type":"array","title":"Colors To Wear"},"colors_for_environment":{"items":{"type":"string"},"type":"array","title":"Colors For Environment"},"colors_to_avoid":{"items":{"type":"string"},"type":"array","title":"Colors To Avoid"},"reason":{"type":"string","title":"Reason"},"planets_benefited":{"items":{"type":"string"},"type":"array","title":"Planets Benefited"},"planets_pacified":{"items":{"type":"string"},"type":"array","title":"Planets Pacified"},"best_days_for_colors":{"additionalProperties":{"type":"string"},"type":"object","title":"Best Days For Colors"},"color_meditation":{"type":"string","title":"Color Meditation"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["colors_to_wear","colors_for_environment","colors_to_avoid","reason","planets_benefited","planets_pacified","best_days_for_colors","color_meditation","effectiveness_score"],"title":"ColorRemedy","description":"Color therapy recommendation."},"CommentListResponse":{"properties":{"comments":{"items":{"$ref":"#/components/schemas/CommentResponse"},"type":"array","title":"Comments","description":"List of comments"},"total":{"type":"integer","title":"Total","description":"Total number of comments"},"page":{"type":"integer","title":"Page","description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","description":"Number of comments per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether there are more pages"}},"type":"object","required":["comments","total","page","per_page","has_more"],"title":"CommentListResponse","description":"Schema for paginated comment list response."},"CommentResponse":{"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier of the comment"},"post_id":{"type":"string","title":"Post Id","description":"ID of the post this comment belongs to"},"parent_id":{"type":"string","title":"Parent Id","description":"ID of the parent comment if this is a reply"},"author_id":{"type":"string","title":"Author Id","description":"ID of the comment author"},"author_name":{"type":"string","title":"Author Name","description":"Name of the comment author"},"content":{"type":"string","title":"Content","description":"Content of the comment"},"chart_data":{"type":"object","title":"Chart Data","description":"Astrological chart data if applicable"},"images":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","title":"Images","description":"List of image URLs associated with the comment"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp when the comment was created"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Timestamp when the comment was last updated"},"vote_count":{"type":"integer","title":"Vote Count","description":"Net vote count (upvotes - downvotes)","default":0},"is_accepted_answer":{"type":"boolean","title":"Is Accepted Answer","description":"Whether this comment is the accepted answer","default":false}},"type":"object","required":["id","post_id","author_id","author_name","content","created_at","updated_at"],"title":"CommentResponse","description":"Schema for comment response."},"CommunityObservance":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"date_basis":{"type":"string","title":"Date Basis"},"source_url":{"type":"string","title":"Source Url"}},"type":"object","required":["id","name","description","date_basis","source_url"],"title":"CommunityObservance"},"CompatibilityDoshaRequest":{"properties":{"nakshatra1":{"type":"string","title":"Nakshatra1","description":"First person's Moon nakshatra"},"nakshatra2":{"type":"string","title":"Nakshatra2","description":"Second person's Moon nakshatra"}},"type":"object","required":["nakshatra1","nakshatra2"],"title":"CompatibilityDoshaRequest","description":"Request for compatibility dosha check."},"CompatibilityLevel":{"type":"string","enum":["excellent","very_good","good","moderate","below_average","poor"],"title":"CompatibilityLevel","description":"Compatibility rating levels."},"CompatibilityRequest":{"properties":{"person1":{"$ref":"#/components/schemas/BirthDetails"},"person2":{"$ref":"#/components/schemas/BirthDetails"},"calculate_dashas":{"type":"boolean","title":"Calculate Dashas","default":true},"calculate_doshas":{"type":"boolean","title":"Calculate Doshas","default":true},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["person1","person2"],"title":"CompatibilityRequest","description":"Request model for compatibility calculations.\n\nAttributes:\n person1: Birth details of the first person\n person2: Birth details of the second person\n calculate_dashas: Whether to calculate dasha periods (default: True)\n calculate_doshas: Whether to calculate doshas (default: True)\n ayanamsa: Optional Parashari sidereal ayanamsa (default Lahiri)"},"CompatibilityResponse":{"properties":{"match":{"$ref":"#/components/schemas/KundaliMatch"},"guna_milan":{"$ref":"#/components/schemas/GunaMilan"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["match","guna_milan","recommendations"],"title":"CompatibilityResponse","description":"Response model for compatibility calculations.\n\nAttributes:\n match: Detailed compatibility analysis\n guna_milan: Guna Milan scores\n recommendations: List of recommendations"},"ComprehensiveRemedyPackage":{"properties":{"birth_details":{"$ref":"#/components/schemas/RemedyBirthDetails"},"analysis_date":{"type":"string","format":"date","title":"Analysis Date"},"moon_sign":{"type":"string","title":"Moon Sign"},"ascendant":{"type":"string","title":"Ascendant"},"current_dasha":{"type":"string","title":"Current Dasha"},"planetary_analysis":{"items":{"$ref":"#/components/schemas/PlanetaryAnalysis"},"type":"array","title":"Planetary Analysis"},"problems_identified":{"items":{"type":"string"},"type":"array","title":"Problems Identified"},"gemstone_recommendations":{"$ref":"#/components/schemas/app__schemas__remedies__GemstoneRecommendation"},"mantra_recommendations":{"$ref":"#/components/schemas/MantraRecommendation"},"puja_recommendations":{"$ref":"#/components/schemas/PujaRecommendation"},"charity_recommendations":{"$ref":"#/components/schemas/CharityRecommendation"},"fasting_recommendations":{"$ref":"#/components/schemas/FastingRecommendation"},"yantra_recommendations":{"$ref":"#/components/schemas/YantraRecommendation"},"color_recommendations":{"$ref":"#/components/schemas/ColorRemedy"},"rudraksha_recommendations":{"$ref":"#/components/schemas/RudrakshaRecommendation"},"mala_recommendations":{"$ref":"#/components/schemas/MalaRecommendation"},"seva_recommendations":{"$ref":"#/components/schemas/SevaRecommendation"},"temple_recommendations":{"$ref":"#/components/schemas/TempleRecommendation"},"lifestyle_recommendations":{"$ref":"#/components/schemas/LifestyleRecommendation"},"dosha_flags":{"items":{"type":"string"},"type":"array","title":"Dosha Flags","default":[]},"remedy_priorities":{"items":{"$ref":"#/components/schemas/RemedyPriority"},"type":"array","title":"Remedy Priorities"},"immediate_actions":{"items":{"type":"string"},"type":"array","title":"Immediate Actions"},"weekly_schedule":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Weekly Schedule"},"monthly_schedule":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Monthly Schedule"},"annual_observances":{"items":{"type":"string"},"type":"array","title":"Annual Observances"},"overall_guidance":{"type":"string","title":"Overall Guidance"},"adaptation_notes":{"items":{"type":"string"},"type":"array","title":"Adaptation Notes","default":[]}},"type":"object","required":["birth_details","analysis_date","moon_sign","ascendant","current_dasha","planetary_analysis","problems_identified","gemstone_recommendations","mantra_recommendations","puja_recommendations","charity_recommendations","fasting_recommendations","yantra_recommendations","color_recommendations","rudraksha_recommendations","temple_recommendations","lifestyle_recommendations","remedy_priorities","immediate_actions","weekly_schedule","monthly_schedule","annual_observances","overall_guidance"],"title":"ComprehensiveRemedyPackage","description":"Complete remedy package for an individual."},"ComprehensiveRemedyResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"package":{"$ref":"#/components/schemas/ComprehensiveRemedyPackage"}},"type":"object","required":["package"],"title":"ComprehensiveRemedyResponse","description":"Response with complete remedy package."},"ConsultationRequestBody":{"properties":{"channel":{"type":"string","pattern":"^(whatsapp|phone|video)$","title":"Channel"}},"type":"object","required":["channel"],"title":"ConsultationRequestBody"},"ConsultationSummaryRequest":{"properties":{"user_name":{"type":"string","title":"User Name"},"astrologer_name":{"type":"string","title":"Astrologer Name"},"consultation_date":{"type":"string","title":"Consultation Date"},"duration_minutes":{"type":"integer","title":"Duration Minutes"},"summary":{"type":"string","title":"Summary"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"include_chart":{"type":"boolean","title":"Include Chart","default":false},"ascendant":{"type":"number","title":"Ascendant"},"planets":{"items":{"$ref":"#/components/schemas/app__routers__chart_export__PlanetPosition"},"type":"array","title":"Planets"},"style":{"allOf":[{"$ref":"#/components/schemas/ChartStyle"}],"default":"north_indian"}},"type":"object","required":["user_name","astrologer_name","consultation_date","duration_minutes","summary","recommendations"],"title":"ConsultationSummaryRequest","description":"Request for consultation summary report."},"ContentRecommendation":{"properties":{"content_id":{"type":"string","title":"Content Id"},"content_type":{"type":"string","title":"Content Type"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"relevance_score":{"type":"number","title":"Relevance Score","default":0.0},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["content_id","content_type","title","reason"],"title":"ContentRecommendation","description":"Content recommendation."},"CreateCommentRequest":{"properties":{"content":{"type":"string","minLength":5,"title":"Content","description":"Content of the comment, minimum 5 characters"},"parent_id":{"type":"string","title":"Parent Id","description":"ID of the parent comment if this is a reply"},"chart_data":{"type":"object","title":"Chart Data","description":"Astrological chart data if applicable"},"images":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","title":"Images","description":"List of image URLs associated with the comment"}},"type":"object","required":["content"],"title":"CreateCommentRequest","description":"Schema for creating a new comment request."},"CreatePostRequest":{"properties":{"title":{"type":"string","maxLength":300,"minLength":5,"title":"Title","description":"Title of the post, between 5 and 300 characters"},"content":{"type":"string","minLength":20,"title":"Content","description":"Main content of the post, minimum 20 characters"},"category":{"allOf":[{"$ref":"#/components/schemas/TopicCategory"}],"description":"Category of the post"},"topic":{"type":"string","maxLength":100,"title":"Topic","description":"Free-text topic within the category"},"post_type":{"allOf":[{"$ref":"#/components/schemas/PostType"}],"description":"Type of the post"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"List of tags associated with the post"},"chart_data":{"type":"object","title":"Chart Data","description":"Astrological chart data if applicable"},"images":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","title":"Images","description":"List of image URLs associated with the post"},"author_id":{"type":"string","title":"Author Id","description":"ID of the post author"},"author_name":{"type":"string","title":"Author Name","description":"Name of the post author"},"is_draft":{"type":"boolean","title":"Is Draft","description":"Whether the post is a draft","default":false},"notify_followers":{"type":"boolean","title":"Notify Followers","description":"Whether to notify followers about the post","default":true},"allow_comments":{"type":"boolean","title":"Allow Comments","description":"Whether to allow comments on the post","default":true},"is_private":{"type":"boolean","title":"Is Private","description":"Whether the post is private","default":false},"scheduled_publish":{"type":"string","format":"date-time","title":"Scheduled Publish","description":"Scheduled publish time if set"}},"type":"object","required":["title","content","category","post_type","author_id","author_name"],"title":"CreatePostRequest","description":"Schema for creating a new post."},"CreatePrashnaInquiryRequest":{"properties":{"querent":{"$ref":"#/components/schemas/QuerentDetails"},"question":{"$ref":"#/components/schemas/QuestionDetails"},"source":{"type":"string","maxLength":64,"title":"Source","default":"homepage"}},"type":"object","required":["question"],"title":"CreatePrashnaInquiryRequest","description":"Create a Prashna inquiry.\n\nThe canonical linked FamilyPerson supplies required DOB/TOB/POB. Optional\n``querent`` fields enrich the saved snapshot but do not replace that gate."},"CreateSubscriptionRequest":{"properties":{"plan_id":{"type":"string","title":"Plan Id"},"payment_method":{"type":"string","title":"Payment Method"},"coupon_code":{"type":"string","title":"Coupon Code"}},"type":"object","required":["plan_id"],"title":"CreateSubscriptionRequest","description":"Request to create a subscription."},"CulturalTradition":{"type":"string","enum":["hindu_north","hindu_south","hindu_east","hindu_west","jain","buddhist","sikh","arya_samaj","iskcon","spiritual","secular"],"title":"CulturalTradition","description":"Cultural/religious tradition for remedy variations."},"CurrentDashaInfo":{"properties":{"mahadasha_lord":{"type":"string","title":"Mahadasha Lord"},"mahadasha_start":{"type":"string","format":"date-time","title":"Mahadasha Start"},"mahadasha_end":{"type":"string","format":"date-time","title":"Mahadasha End"},"antardasha_lord":{"type":"string","title":"Antardasha Lord"},"antardasha_start":{"type":"string","format":"date-time","title":"Antardasha Start"},"antardasha_end":{"type":"string","format":"date-time","title":"Antardasha End"},"pratyantardasha_lord":{"type":"string","title":"Pratyantardasha Lord"},"pratyantardasha_start":{"type":"string","format":"date-time","title":"Pratyantardasha Start"},"pratyantardasha_end":{"type":"string","format":"date-time","title":"Pratyantardasha End"}},"type":"object","required":["mahadasha_lord","mahadasha_start","mahadasha_end","antardasha_lord","antardasha_start","antardasha_end"],"title":"CurrentDashaInfo","description":"Current running dasha period information."},"CurrentInfluencesResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"as_of_date":{"type":"string","format":"date","title":"As Of Date"},"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"moon_sign":{"type":"string","title":"Moon Sign"},"ascendant":{"type":"string","title":"Ascendant"},"current_dasha":{"$ref":"#/components/schemas/CurrentDashaInfo"},"transit_summary":{"type":"string","title":"Transit Summary"},"active_yogas":{"items":{"$ref":"#/components/schemas/YogaActivation"},"type":"array","title":"Active Yogas"},"key_influences":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Key Influences"},"overall_energy":{"type":"string","title":"Overall Energy"},"immediate_advice":{"type":"string","title":"Immediate Advice"}},"type":"object","required":["as_of_date","birth_details","moon_sign","ascendant","current_dasha","transit_summary","active_yogas","key_influences","overall_energy","immediate_advice"],"title":"CurrentInfluencesResponse","description":"Response showing all current astrological influences."},"DailyHoroscopeAudioPrepareRequest":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"locale":{"type":"string","maxLength":8,"minLength":2,"title":"Locale"},"content_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Content Hash"},"narration":{"type":"string","maxLength":4000,"minLength":1,"title":"Narration"},"authorization":{"type":"string","maxLength":67,"minLength":67,"title":"Authorization"}},"type":"object","required":["date","locale","content_hash","narration","authorization"],"title":"DailyHoroscopeAudioPrepareRequest"},"DailyInauspiciousOut":{"properties":{"rahu_kaal":{"$ref":"#/components/schemas/InauspiciousPeriodOut"},"gulika_kaal":{"$ref":"#/components/schemas/InauspiciousPeriodOut"},"yamaganda":{"$ref":"#/components/schemas/InauspiciousPeriodOut"},"durmuhurtas":{"items":{"$ref":"#/components/schemas/InauspiciousPeriodOut"},"type":"array","title":"Durmuhurtas"}},"type":"object","required":["rahu_kaal","gulika_kaal","yamaganda"],"title":"DailyInauspiciousOut"},"DailyMuhurtaAnalysisResponse":{"properties":{"date":{"type":"string","title":"Date"},"location":{"$ref":"#/components/schemas/app__schemas__advanced_muhurta__LocationOut"},"panchang":{"$ref":"#/components/schemas/app__schemas__advanced_muhurta__PanchangOut"},"sun_times":{"$ref":"#/components/schemas/app__schemas__advanced_muhurta__SunTimesOut"},"special_muhurtas":{"$ref":"#/components/schemas/SpecialMuhurtasOut"},"horas":{"items":{"$ref":"#/components/schemas/HoraOut"},"type":"array","title":"Horas"},"choghadiyas":{"items":{"$ref":"#/components/schemas/ChoghadiyaOut"},"type":"array","title":"Choghadiyas"},"inauspicious_periods":{"$ref":"#/components/schemas/DailyInauspiciousOut"},"special_yogas":{"items":{"$ref":"#/components/schemas/SpecialYogaOut"},"type":"array","title":"Special Yogas"},"activity_scores":{"additionalProperties":{"type":"number"},"type":"object","title":"Activity Scores"},"day_quality":{"type":"string","title":"Day Quality"},"best_activities":{"items":{"type":"string"},"type":"array","title":"Best Activities"},"avoid_activities":{"items":{"type":"string"},"type":"array","title":"Avoid Activities"}},"type":"object","required":["date","location","panchang","sun_times","special_muhurtas","inauspicious_periods","day_quality"],"title":"DailyMuhurtaAnalysisResponse","description":"GET /advanced-muhurta/daily-analysis"},"DanaCauseCategory":{"type":"string","enum":["annadanam","vidya_dana","go_seva","vastra","deepa","general"],"title":"DanaCauseCategory","description":"Classical dana (charity) cause categories."},"DashaComparisonRequest":{"properties":{"birth_date":{"type":"string","format":"date-time","title":"Birth Date","description":"Date and time of birth"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude","description":"Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude","description":"Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","description":"Timezone"},"systems":{"items":{"$ref":"#/components/schemas/DashaSystem"},"type":"array","description":"Systems to compare"},"years_to_analyze":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Years To Analyze","description":"Years to analyze","default":10},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied to all compared systems (default Lahiri)"}},"type":"object","required":["birth_date","birth_latitude","birth_longitude","birth_timezone"],"title":"DashaComparisonRequest","description":"Request for comparing multiple dasha systems."},"DashaCompatibility":{"properties":{"bride_current_dasha":{"type":"string","title":"Bride Current Dasha"},"bride_current_antardasha":{"type":"string","title":"Bride Current Antardasha"},"groom_current_dasha":{"type":"string","title":"Groom Current Dasha"},"groom_current_antardasha":{"type":"string","title":"Groom Current Antardasha"},"dasha_harmony":{"type":"string","title":"Dasha Harmony"},"marriage_timing_favorable":{"type":"boolean","title":"Marriage Timing Favorable"},"favorable_periods":{"items":{"type":"string"},"type":"array","title":"Favorable Periods"},"challenging_periods":{"items":{"type":"string"},"type":"array","title":"Challenging Periods"},"timing_recommendation":{"type":"string","title":"Timing Recommendation"}},"type":"object","required":["bride_current_dasha","bride_current_antardasha","groom_current_dasha","groom_current_antardasha","dasha_harmony","marriage_timing_favorable","favorable_periods","challenging_periods","timing_recommendation"],"title":"DashaCompatibility","description":"Dasha-based compatibility and timing analysis.\n\nCompares the current and upcoming dasha periods\nto assess timing for marriage.\n\nAttributes:\n bride_current_dasha: Bride's current main period\n groom_current_dasha: Groom's current main period\n dasha_harmony: How well dashas align\n favorable_periods: Good periods for marriage\n challenging_periods: Periods to avoid\n timing_recommendation: Best time to proceed"},"DashaEventMatch":{"properties":{"event":{"$ref":"#/components/schemas/LifeEvent"},"dasha_lord":{"type":"string","title":"Dasha Lord"},"antardasha_lord":{"type":"string","title":"Antardasha Lord"},"pratyantardasha_lord":{"type":"string","title":"Pratyantardasha Lord"},"match_quality":{"type":"string","title":"Match Quality","description":"excellent, good, moderate, poor"},"relevant_houses":{"items":{"type":"integer"},"type":"array","title":"Relevant Houses"},"explanation":{"type":"string","title":"Explanation"}},"type":"object","required":["event","dasha_lord","antardasha_lord","match_quality","relevant_houses","explanation"],"title":"DashaEventMatch","description":"Match between a dasha period and a life event.\n\nAttributes:\n event: The life event\n dasha_lord: Main dasha lord during event\n antardasha_lord: Sub-period lord during event\n pratyantardasha_lord: Sub-sub period lord\n match_quality: How well the dasha matches event type\n relevant_houses: Houses activated by these lords\n explanation: Why this is a good/poor match"},"DashaEvidence":{"properties":{"kind":{"type":"string","title":"Kind"},"statement":{"type":"string","title":"Statement"}},"type":"object","required":["kind","statement"],"title":"DashaEvidence"},"DashaInfluence":{"properties":{"current_dasha":{"$ref":"#/components/schemas/CurrentDashaInfo"},"mahadasha_nature":{"$ref":"#/components/schemas/InfluenceNature"},"mahadasha_themes":{"items":{"type":"string"},"type":"array","title":"Mahadasha Themes"},"antardasha_nature":{"$ref":"#/components/schemas/InfluenceNature"},"antardasha_themes":{"items":{"type":"string"},"type":"array","title":"Antardasha Themes"},"combined_effect":{"type":"string","title":"Combined Effect"},"favorable_activities":{"items":{"type":"string"},"type":"array","title":"Favorable Activities"},"unfavorable_activities":{"items":{"type":"string"},"type":"array","title":"Unfavorable Activities"},"dasha_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Dasha Score"}},"type":"object","required":["current_dasha","mahadasha_nature","mahadasha_themes","antardasha_nature","antardasha_themes","combined_effect","favorable_activities","unfavorable_activities","dasha_score"],"title":"DashaInfluence","description":"Dasha period influence on predictions."},"DashaInterpretationRequest":{"properties":{"person_name":{"type":"string","maxLength":120,"title":"Person Name"},"birth_date":{"type":"string","format":"date-time","title":"Birth Date","description":"Local date and time of birth"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","description":"IANA timezone, for example Asia/Kolkata"},"as_of":{"type":"string","format":"date-time","title":"As Of","description":"Date to interpret; defaults to now"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa; defaults to Lahiri"}},"type":"object","required":["birth_date","birth_latitude","birth_longitude","birth_timezone"],"title":"DashaInterpretationRequest","description":"Birth data and observation date for a personalised dasha reading."},"DashaInterpretationResponse":{"properties":{"person_name":{"type":"string","title":"Person Name"},"dasha_system":{"allOf":[{"$ref":"#/components/schemas/DashaSystem"}],"default":"vimshottari"},"calculation_status":{"type":"string","title":"Calculation Status","default":"validated_foundation"},"as_of":{"type":"string","format":"date-time","title":"As Of"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"ascendant_sign":{"type":"string","title":"Ascendant Sign"},"active_periods":{"items":{"$ref":"#/components/schemas/ActiveDashaLevel"},"type":"array","title":"Active Periods"},"life_themes":{"items":{"$ref":"#/components/schemas/DashaLifeTheme"},"type":"array","title":"Life Themes"},"synthesis":{"type":"string","title":"Synthesis"},"evidence":{"items":{"$ref":"#/components/schemas/DashaEvidence"},"type":"array","title":"Evidence"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"type":"object","required":["as_of","ayanamsa","ascendant_sign","active_periods","life_themes","synthesis","evidence","limitations"],"title":"DashaInterpretationResponse"},"DashaLifeTheme":{"properties":{"area":{"type":"string","title":"Area"},"activated_by":{"items":{"type":"string"},"type":"array","title":"Activated By"},"interpretation":{"type":"string","title":"Interpretation"},"tone":{"type":"string","title":"Tone","description":"growth, pressure, or mixed"}},"type":"object","required":["area","activated_by","interpretation","tone"],"title":"DashaLifeTheme"},"DashaPeriodResponse":{"properties":{"planet":{"type":"string","title":"Planet"},"sign":{"type":"string","title":"Sign"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"duration_years":{"type":"number","title":"Duration Years"},"level":{"type":"integer","title":"Level"},"description":{"type":"string","title":"Description"}},"type":"object","required":["planet","start_date","end_date","duration_years","level","description"],"title":"DashaPeriodResponse","description":"Response model for a single dasha period."},"DashaPlanetPlacement":{"properties":{"planet":{"type":"string","title":"Planet"},"sign":{"type":"string","title":"Sign"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"ruled_houses":{"items":{"type":"integer"},"type":"array","title":"Ruled Houses"},"is_retrograde":{"type":"boolean","title":"Is Retrograde","default":false}},"type":"object","required":["planet","sign","house"],"title":"DashaPlanetPlacement"},"DashaSystem":{"type":"string","enum":["vimshottari","yogini","kalachakra","ashtottari","chara","narayana","sudharshana","moola"],"title":"DashaSystem","description":"Types of Dasha systems."},"DashaTimelineInterpretationRequest":{"properties":{"person_name":{"type":"string","maxLength":120,"title":"Person Name"},"birth_date":{"type":"string","format":"date-time","title":"Birth Date","description":"Local date and time of birth"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","description":"IANA timezone, for example Asia/Kolkata"},"as_of":{"type":"string","format":"date-time","title":"As Of","description":"Date to interpret; defaults to now"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa; defaults to Lahiri"},"from_date":{"type":"string","format":"date-time","title":"From Date","description":"Defaults to birth_date"},"to_date":{"type":"string","format":"date-time","title":"To Date","description":"Defaults to 120 years after birth_date"},"include_antardashas":{"type":"boolean","title":"Include Antardashas","default":true},"max_periods":{"type":"integer","maximum":500.0,"minimum":1.0,"title":"Max Periods","default":200}},"type":"object","required":["birth_date","birth_latitude","birth_longitude","birth_timezone"],"title":"DashaTimelineInterpretationRequest","description":"Request an interpreted Vimshottari timeline over a bounded date window."},"DashaTimelineInterpretationResponse":{"properties":{"person_name":{"type":"string","title":"Person Name"},"dasha_system":{"allOf":[{"$ref":"#/components/schemas/DashaSystem"}],"default":"vimshottari"},"calculation_status":{"type":"string","title":"Calculation Status","default":"validated_foundation"},"window_start":{"type":"string","format":"date-time","title":"Window Start"},"window_end":{"type":"string","format":"date-time","title":"Window End"},"active_as_of":{"type":"string","format":"date-time","title":"Active As Of"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"ascendant_sign":{"type":"string","title":"Ascendant Sign"},"periods":{"items":{"$ref":"#/components/schemas/InterpretedDashaPeriod"},"type":"array","title":"Periods"},"period_count":{"type":"integer","title":"Period Count","description":"Total periods matching the window"},"returned_count":{"type":"integer","title":"Returned Count"},"truncated":{"type":"boolean","title":"Truncated","default":false},"evidence":{"items":{"$ref":"#/components/schemas/DashaEvidence"},"type":"array","title":"Evidence"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"type":"object","required":["window_start","window_end","active_as_of","ayanamsa","ascendant_sign","periods","period_count","returned_count","evidence","limitations"],"title":"DashaTimelineInterpretationResponse"},"DashaWindow":{"properties":{"level":{"type":"string","title":"Level"},"lord":{"type":"string","title":"Lord"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"}},"type":"object","required":["level","lord","start_date","end_date"],"title":"DashaWindow","description":"A Vimshottari period overlapping the requested forecast range."},"DashboardData":{"properties":{"summary":{"$ref":"#/components/schemas/DashboardSummary"},"upcoming_events":{"items":{"$ref":"#/components/schemas/UpcomingEvent"},"type":"array","title":"Upcoming Events"},"recent_activity":{"items":{"$ref":"#/components/schemas/RecentActivity"},"type":"array","title":"Recent Activity"},"insights":{"items":{"$ref":"#/components/schemas/AstrologicalInsight"},"type":"array","title":"Insights"},"quick_actions":{"items":{"type":"object"},"type":"array","title":"Quick Actions"},"stats":{"type":"object","title":"Stats"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["summary"],"title":"DashboardData","description":"Complete dashboard data."},"DashboardSummary":{"properties":{"user_name":{"type":"string","title":"User Name"},"current_dasha":{"type":"string","title":"Current Dasha"},"current_antardasha":{"type":"string","title":"Current Antardasha"},"moon_sign":{"type":"string","title":"Moon Sign"},"ascendant":{"type":"string","title":"Ascendant"},"unread_notifications":{"type":"integer","title":"Unread Notifications","default":0},"upcoming_consultations":{"type":"integer","title":"Upcoming Consultations","default":0},"active_remedies":{"type":"integer","title":"Active Remedies","default":0},"pending_predictions":{"type":"integer","title":"Pending Predictions","default":0}},"type":"object","required":["user_name"],"title":"DashboardSummary","description":"Quick summary for dashboard header."},"DayAnalysisOut":{"properties":{"date":{"type":"string","title":"Date"},"weekday":{"type":"string","title":"Weekday"},"weekday_lord":{"type":"string","title":"Weekday Lord"},"location":{"$ref":"#/components/schemas/app__routers__astro_calendar__LocationOut"},"panchang":{"$ref":"#/components/schemas/app__routers__astro_calendar__PanchangOut"},"sun_times":{"$ref":"#/components/schemas/app__routers__astro_calendar__SunTimesOut"},"quality":{"type":"string","title":"Quality"},"score":{"type":"integer","title":"Score"},"favorable_for":{"items":{"type":"string"},"type":"array","title":"Favorable For"},"avoid_for":{"items":{"type":"string"},"type":"array","title":"Avoid For"},"rahu_kaal":{"$ref":"#/components/schemas/RahuKaalOut"},"special_notes":{"items":{"type":"string"},"type":"array","title":"Special Notes"},"personal_insights":{"items":{"type":"string"},"type":"array","title":"Personal Insights"}},"type":"object","required":["date","weekday","weekday_lord","location","panchang","sun_times","quality","score","favorable_for","avoid_for","rahu_kaal","special_notes","personal_insights"],"title":"DayAnalysisOut"},"DayBalaResponse":{"properties":{"date":{"type":"string","title":"Date"},"transit_nakshatra":{"$ref":"#/components/schemas/TransitBodyOut"},"transit_moon_rashi":{"$ref":"#/components/schemas/TransitBodyOut"},"paksha":{"type":"string","title":"Paksha"},"is_shukla_paksha":{"type":"boolean","title":"Is Shukla Paksha"},"tarabala":{"items":{"$ref":"#/components/schemas/TarabalaEntryOut"},"type":"array","title":"Tarabala"},"chandrabala":{"items":{"$ref":"#/components/schemas/ChandrabalaEntryOut"},"type":"array","title":"Chandrabala"},"tarabala_bands":{"items":{"$ref":"#/components/schemas/TarabalaBandOut"},"type":"array","title":"Tarabala Bands"},"chandrabala_bands":{"items":{"$ref":"#/components/schemas/ChandrabalaBandOut"},"type":"array","title":"Chandrabala Bands"}},"type":"object","required":["date","transit_nakshatra","transit_moon_rashi","paksha","is_shukla_paksha"],"title":"DayBalaResponse","description":"GET /advanced-muhurta/day-bala\n\nThe inverse of /tarabala and /chandrabala: one date and place in, the whole\n27-nakshatra and 12-rashi table out. Lets a panchang view show \"favourable\nfor these birth stars today\" without re-implementing the rules client-side.\n\n``tarabala`` and ``chandrabala`` grade the day at its first instant;\n``tarabala_bands`` and ``chandrabala_bands`` grade every stretch of it, and\na day whose Moon changes nakshatra has two different Tara verdicts in it. The\nflat lists stay because they are a smaller answer to the commoner question,\nand because they are what a caller falls back to when a boundary would not\nsolve and the band list arrives empty."},"DayStrength":{"properties":{"day":{"type":"string","title":"Day"},"date":{"type":"string","title":"Date"},"tara":{"type":"string","title":"Tara"},"chandra_house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Chandra House"},"note":{"type":"string","title":"Note"}},"type":"object","required":["day","date","tara","chandra_house"],"title":"DayStrength","description":"One day of a weekly reading, qualified by tara + chandra bala."},"DetailedBirthReportRequest":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"birth_date":{"type":"string","format":"date-time","title":"Birth Date","description":"Birth instant, ISO 8601"},"timezone":{"type":"string","maxLength":64,"minLength":1,"title":"Timezone"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"place_label":{"type":"string","maxLength":160,"minLength":1,"title":"Place Label"},"ayanamsa":{"type":"string","maxLength":32,"title":"Ayanamsa","default":"Lahiri"},"node_type":{"type":"string","maxLength":16,"title":"Node Type","default":"mean"},"chart_image_base64":{"type":"string","title":"Chart Image Base64","description":"The selected plate as a data:image/png;base64 URL"},"chart_caption":{"type":"string","maxLength":200,"title":"Chart Caption"},"format":{"type":"string","enum":["pdf","html"],"title":"Format","default":"pdf"},"paper_size":{"type":"string","enum":["A4","Letter"],"title":"Paper Size","description":"Physical page size used by the print renderer","default":"A4"},"audience":{"type":"string","enum":["astrologer","reader"],"title":"Audience","description":"astrologer (worksheet) or reader (reading)"},"include_ashtakavarga":{"type":"boolean","title":"Include Ashtakavarga","default":true},"include_shadbala":{"type":"boolean","title":"Include Shadbala","default":true},"include_panchanga":{"type":"boolean","title":"Include Panchanga","default":true},"include_yogas":{"type":"boolean","title":"Include Yogas","default":true},"include_doshas":{"type":"boolean","title":"Include Doshas","default":true},"include_outlook":{"type":"boolean","title":"Include Outlook","default":true},"include_remedies":{"type":"boolean","title":"Include Remedies","default":true},"include_janma":{"type":"boolean","title":"Include Janma","default":true},"include_gochara":{"type":"boolean","title":"Include Gochara","default":true},"as_of":{"type":"string","format":"date","title":"As Of","description":"Date for the current Gochara snapshot; defaults to today in the birth timezone"},"outlook_years":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Outlook Years","default":10}},"type":"object","required":["name","birth_date","timezone","latitude","longitude","place_label"],"title":"DetailedBirthReportRequest"},"DhaiyaAnalysis":{"properties":{"is_active":{"type":"boolean","title":"Is Active"},"dhaiya_type":{"$ref":"#/components/schemas/DhaiyaType"},"description":{"type":"string","title":"Description"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"intensity":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Intensity","default":0},"effects":{"items":{"type":"string"},"type":"array","title":"Effects","default":[]},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies","default":[]}},"type":"object","required":["is_active","dhaiya_type","description"],"title":"DhaiyaAnalysis","description":"Dhaiya (Small Panoti) analysis"},"DhaiyaType":{"type":"string","enum":["fourth_house","eighth_house","not_active"],"title":"DhaiyaType","description":"Dhaiya (Small Panoti) types"},"DhanaYogaSummary":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"yogas":{"items":{"$ref":"#/components/schemas/YogaData"},"type":"array","title":"Yogas"},"wealth_potential":{"type":"string","title":"Wealth Potential","description":"excellent, good, moderate, limited"},"primary_sources":{"items":{"type":"string"},"type":"array","title":"Primary Sources"},"timing_houses":{"items":{"type":"integer"},"type":"array","title":"Timing Houses"}},"type":"object","required":["total_count","yogas","wealth_potential"],"title":"DhanaYogaSummary","description":"Summary of Dhana Yogas (wealth combinations).\n\nAttributes:\n total_count: Number of Dhana Yogas present\n yogas: List of individual Dhana Yoga details\n wealth_potential: Overall wealth potential\n primary_sources: Main sources of wealth indicated\n timing_houses: Houses indicating timing of wealth"},"DietaryPreference":{"type":"string","enum":["non_vegetarian","vegetarian","lacto_vegetarian","vegan","jain_vegetarian","satvik","eggetarian"],"title":"DietaryPreference","description":"Dietary preferences for remedy recommendations."},"DietaryRemedy":{"properties":{"foods_to_increase":{"items":{"type":"string"},"type":"array","title":"Foods To Increase"},"foods_to_decrease":{"items":{"type":"string"},"type":"array","title":"Foods To Decrease"},"foods_to_avoid":{"items":{"type":"string"},"type":"array","title":"Foods To Avoid"},"eating_times":{"type":"string","title":"Eating Times"},"fasting_days":{"items":{"type":"string"},"type":"array","title":"Fasting Days"},"planet_benefited":{"type":"string","title":"Planet Benefited"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["foods_to_increase","foods_to_decrease","foods_to_avoid","eating_times","fasting_days","planet_benefited","reason"],"title":"DietaryRemedy","description":"Dietary recommendations."},"DigBala":{"properties":{"planet":{"type":"string","title":"Planet"},"current_house":{"type":"integer","title":"Current House"},"optimal_house":{"type":"integer","title":"Optimal House"},"distance_from_optimal":{"type":"number","title":"Distance From Optimal"},"strength_virupas":{"type":"number","title":"Strength Virupas"},"strength_rupas":{"type":"number","title":"Strength Rupas"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["planet","current_house","optimal_house","distance_from_optimal","strength_virupas","strength_rupas","interpretation"],"title":"DigBala","description":"Directional Strength."},"DivisionalChartData":{"properties":{"chart_code":{"type":"string","title":"Chart Code","description":"D1, D2, D3, D7, D9, D10, D12, etc."},"chart_name":{"type":"string","title":"Chart Name","description":"Rashi, Hora, Drekkana, Navamsa, etc."},"division":{"type":"integer","maximum":60.0,"minimum":1.0,"title":"Division"},"arc_degrees":{"type":"number","maximum":30.0,"exclusiveMinimum":0.0,"title":"Arc Degrees"},"significance":{"type":"string","title":"Significance"},"planets":{"items":{"$ref":"#/components/schemas/DivisionalPosition"},"type":"array","title":"Planets"},"ascendant":{"$ref":"#/components/schemas/DivisionalPosition"},"vargottama_planets":{"items":{"type":"string"},"type":"array","title":"Vargottama Planets"},"pushkara_navamsa_planets":{"items":{"type":"string"},"type":"array","title":"Pushkara Navamsa Planets"}},"type":"object","required":["chart_code","chart_name","division","arc_degrees","significance","planets","ascendant"],"title":"DivisionalChartData","description":"Complete divisional chart data.\n\nAttributes:\n chart_code: Divisional chart code (D1, D9, D10, etc.)\n chart_name: Traditional name (Rashi, Navamsa, Dasamsa, etc.)\n division: Number of divisions (1, 9, 10, etc.)\n arc_degrees: Degrees per division\n significance: What this chart signifies\n planets: List of planetary positions in this chart\n ascendant: Ascendant position in this chart\n vargottama_planets: Planets that are vargottama (same sign in D1 and D9)\n pushkara_navamsa_planets: Planets in pushkara navamsa (D9 only)"},"DivisionalChartRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"chart_types":{"items":{"type":"string"},"type":"array","title":"Chart Types","description":"List of chart codes: D1, D2, D3, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45, D60","default":["D9","D10"]},"include_all_charts":{"type":"boolean","title":"Include All Charts","description":"Calculate all available divisional charts","default":false},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_details"],"title":"DivisionalChartRequest","description":"Request model for divisional charts calculation.\n\nAttributes:\n birth_details: Birth details for calculation\n chart_types: List of divisional charts to calculate (default: D9, D10)\n include_all_charts: If True, calculate all available charts (D1-D60)"},"DivisionalChartsResponse":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"d1_chart":{"allOf":[{"$ref":"#/components/schemas/DivisionalChartData"}],"title":"D1 Chart","description":"Base Rashi chart"},"divisional_charts":{"additionalProperties":{"$ref":"#/components/schemas/DivisionalChartData"},"type":"object","title":"Divisional Charts","description":"Dictionary of chart_code -> chart_data"},"vargottama_summary":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Vargottama Summary","description":"Planet -> list of charts where vargottama"},"chart_strength_analysis":{"additionalProperties":{"type":"string"},"type":"object","title":"Chart Strength Analysis","description":"Planet -> strength assessment across vargas"},"special_combinations":{"items":{"type":"string"},"type":"array","title":"Special Combinations","description":"Notable patterns across divisional charts"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["birth_details"],"title":"DivisionalChartsResponse","description":"Response containing multiple divisional charts.\n\nAttributes:\n birth_details: Original birth details\n d1_chart: Base D1 (Rashi) chart for reference\n divisional_charts: Dictionary of requested divisional charts\n vargottama_summary: Summary of vargottama planets\n chart_strength_analysis: Overall strength based on vargas\n special_combinations: Notable combinations across charts"},"DivisionalPosition":{"properties":{"planet":{"type":"string","title":"Planet"},"d1_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"D1 Longitude","description":"Original longitude 0-360°"},"d1_sign":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"D1 Sign","description":"Sign index in D1 (0=Aries)"},"d1_sign_name":{"type":"string","title":"D1 Sign Name"},"divisional_sign":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Divisional Sign","description":"Sign index in divisional chart"},"divisional_sign_name":{"type":"string","title":"Divisional Sign Name"},"nakshatra":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Nakshatra"},"nakshatra_name":{"type":"string","title":"Nakshatra Name"},"pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada"},"is_vargottama":{"type":"boolean","title":"Is Vargottama","description":"Same sign in D1 and D9","default":false},"dignity_in_varga":{"type":"string","title":"Dignity In Varga","description":"exalted, own_sign, friendly, neutral, enemy, debilitated"}},"type":"object","required":["planet","d1_longitude","d1_sign","d1_sign_name","divisional_sign","divisional_sign_name","nakshatra","nakshatra_name","pada"],"title":"DivisionalPosition","description":"Planet position in a divisional chart.\n\nAttributes:\n planet: Name of the planet\n d1_longitude: Original longitude in D1 (Rashi) chart (0-360)\n d1_sign: Sign in D1 chart (0-11)\n d1_sign_name: Name of sign in D1 chart\n divisional_sign: Calculated sign in this divisional chart (0-11)\n divisional_sign_name: Name of sign in divisional chart\n nakshatra: Nakshatra number (1-27)\n nakshatra_name: Name of the nakshatra\n pada: Nakshatra pada (1-4)\n is_vargottama: True if same sign in D1 and D9\n dignity_in_varga: Dignity status in this divisional chart"},"DominantTransit":{"properties":{"planet":{"type":"string","title":"Planet"},"sign":{"type":"string","title":"Sign"},"sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign Num"},"house_from_moon":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House From Moon"}},"type":"object","required":["planet","sign","sign_num","house_from_moon"],"title":"DominantTransit","description":"A graha's current placement, counted from the natal Moon."},"DoshaRequest":{"properties":{"planets":{"$ref":"#/components/schemas/PlanetPositions"},"ascendant":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Ascendant","description":"Ascendant longitude"},"moon_nakshatra":{"type":"string","title":"Moon Nakshatra","description":"Moon's nakshatra name"}},"type":"object","required":["planets","ascendant","moon_nakshatra"],"title":"DoshaRequest","description":"Request model for dosha analysis."},"DoshaResponse":{"properties":{"dosha_type":{"type":"string","title":"Dosha Type"},"present":{"type":"boolean","title":"Present"},"severity":{"type":"string","title":"Severity"},"score":{"type":"number","title":"Score"},"description":{"type":"string","title":"Description"},"factors":{"items":{"type":"string"},"type":"array","title":"Factors"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"},"cancellation":{"type":"string","title":"Cancellation"},"is_cancelled":{"type":"boolean","title":"Is Cancelled"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"type":"object","required":["dosha_type","present","severity","score","description","factors","remedies","is_cancelled"],"title":"DoshaResponse","description":"Response model for single dosha."},"DoshaStatus":{"type":"string","enum":["absent","present","cancelled","partially_cancelled"],"title":"DoshaStatus","description":"Status of a dosha."},"DrekkanaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"drekkana":{"type":"integer","title":"Drekkana"},"is_favorable":{"type":"boolean","title":"Is Favorable"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","drekkana","is_favorable","strength_virupas"],"title":"DrekkanaBala","description":"Decanate strength."},"DrikBala":{"properties":{"planet":{"type":"string","title":"Planet"},"benefic_aspects":{"items":{"$ref":"#/components/schemas/AspectDetail"},"type":"array","title":"Benefic Aspects"},"malefic_aspects":{"items":{"$ref":"#/components/schemas/AspectDetail"},"type":"array","title":"Malefic Aspects"},"subha_drishti_bala":{"type":"number","title":"Subha Drishti Bala"},"papa_drishti_bala":{"type":"number","title":"Papa Drishti Bala"},"net_strength_virupas":{"type":"number","title":"Net Strength Virupas"},"net_strength_rupas":{"type":"number","title":"Net Strength Rupas"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["planet","benefic_aspects","malefic_aspects","subha_drishti_bala","papa_drishti_bala","net_strength_virupas","net_strength_rupas","interpretation"],"title":"DrikBala","description":"Aspectual Strength."},"Eclipse":{"properties":{"eclipse_id":{"type":"string","title":"Eclipse Id"},"category":{"$ref":"#/components/schemas/EclipseCategory"},"eclipse_type":{"$ref":"#/components/schemas/EclipseType"},"saros_series":{"type":"integer","title":"Saros Series"},"name_sanskrit":{"type":"string","title":"Name Sanskrit"},"type_sanskrit":{"type":"string","title":"Type Sanskrit"},"date":{"type":"string","format":"date-time","title":"Date"},"year":{"type":"integer","title":"Year"},"month":{"type":"integer","title":"Month"},"day":{"type":"integer","title":"Day"},"timing":{"$ref":"#/components/schemas/EclipseTiming"},"gamma":{"type":"number","title":"Gamma"},"magnitude":{"type":"number","minimum":0.0,"title":"Magnitude"},"obscuration":{"type":"number","title":"Obscuration"},"path_width_km":{"type":"number","minimum":0.0,"title":"Path Width Km"},"central_duration_seconds":{"type":"number","minimum":0.0,"title":"Central Duration Seconds"},"path_coordinates":{"items":{"additionalProperties":{"type":"number"},"type":"object"},"type":"array","title":"Path Coordinates"},"astrology":{"$ref":"#/components/schemas/EclipseAstrology"},"visibility_map":{"additionalProperties":{"$ref":"#/components/schemas/EclipseVisibility"},"type":"object","title":"Visibility Map"},"description":{"type":"string","title":"Description"},"significance":{"type":"string","title":"Significance"}},"type":"object","required":["eclipse_id","category","eclipse_type","name_sanskrit","type_sanskrit","date","year","month","day","timing","magnitude","description","significance"],"title":"Eclipse","description":"Complete eclipse information."},"EclipseAstrology":{"properties":{"ayanamsa":{"type":"string","title":"Ayanamsa","default":"Lahiri"},"eclipse_longitude":{"type":"number","title":"Eclipse Longitude"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_pada":{"type":"integer","title":"Nakshatra Pada"},"rashi":{"type":"string","title":"Rashi"},"rashi_lord":{"type":"string","title":"Rashi Lord"},"affected_house":{"type":"integer","title":"Affected House"},"affected_rashis":{"items":{"type":"string"},"type":"array","title":"Affected Rashis"},"grahan_dosha":{"items":{"$ref":"#/components/schemas/GrahanDosha"},"type":"array"},"affected_nakshatras":{"items":{"type":"string"},"type":"array","title":"Affected Nakshatras"},"general_effects":{"type":"string","title":"General Effects"},"political_effects":{"type":"string","title":"Political Effects"},"natural_effects":{"type":"string","title":"Natural Effects"},"individual_effects":{"additionalProperties":{"type":"string"},"type":"object","title":"Individual Effects"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"},"mantras":{"items":{"type":"string"},"type":"array","title":"Mantras"},"restrictions":{"items":{"type":"string"},"type":"array","title":"Restrictions"},"sutak_start":{"type":"string","format":"date-time","title":"Sutak Start"},"sutak_end":{"type":"string","format":"date-time","title":"Sutak End"},"sutak_duration_hours":{"type":"number","title":"Sutak Duration Hours"}},"type":"object","required":["nakshatra","nakshatra_pada","rashi","rashi_lord","affected_house","affected_rashis","general_effects","political_effects","natural_effects"],"title":"EclipseAstrology","description":"Astrological significance of the eclipse in Vedic astrology."},"EclipseCategory":{"type":"string","enum":["solar","lunar"],"title":"EclipseCategory","description":"Category of eclipse - Solar or Lunar."},"EclipseNatalContact":{"properties":{"graha":{"type":"string","title":"Graha"},"graha_label":{"type":"string","title":"Graha Label"},"separation":{"type":"number","title":"Separation"},"exact":{"type":"boolean","title":"Exact"},"natal_rashi":{"type":"string","title":"Natal Rashi"},"natal_rashi_label":{"type":"string","title":"Natal Rashi Label"},"natal_bhava":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Natal Bhava"},"natal_bhava_label":{"type":"string","title":"Natal Bhava Label"},"dignity":{"type":"string","title":"Dignity"},"retrograde":{"type":"boolean","title":"Retrograde"}},"type":"object","required":["graha","graha_label","separation","exact","natal_rashi","natal_rashi_label","natal_bhava","natal_bhava_label","dignity","retrograde"],"title":"EclipseNatalContact","description":"One natal graha the eclipse degree actually lands on.\n\n`separation` is the whole reason this is a list of objects rather than a list\nof names: a contact at 0.3 degrees and one at 4.8 are not the same claim, and\nthe orb they were both judged against is reported beside them so a reader can\ndisagree with the orb rather than only with the verdict."},"EclipseNatalReading":{"properties":{"language":{"type":"string","title":"Language"},"lagna":{"type":"string","title":"Lagna"},"lagna_label":{"type":"string","title":"Lagna Label"},"lagna_degree":{"type":"number","title":"Lagna Degree"},"moon_rashi":{"type":"string","title":"Moon Rashi"},"moon_rashi_label":{"type":"string","title":"Moon Rashi Label"},"moon_nakshatra":{"type":"string","title":"Moon Nakshatra"},"moon_nakshatra_label":{"type":"string","title":"Moon Nakshatra Label"},"eclipse_longitude":{"type":"number","title":"Eclipse Longitude"},"eclipse_degree_label":{"type":"string","title":"Eclipse Degree Label"},"bhava_from_lagna":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Bhava From Lagna"},"bhava_label":{"type":"string","title":"Bhava Label"},"bhava_lord":{"type":"string","title":"Bhava Lord"},"bhava_lord_label":{"type":"string","title":"Bhava Lord Label"},"bhava_lord_rashi":{"type":"string","title":"Bhava Lord Rashi"},"bhava_lord_rashi_label":{"type":"string","title":"Bhava Lord Rashi Label"},"bhava_lord_bhava":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Bhava Lord Bhava"},"bhava_lord_bhava_label":{"type":"string","title":"Bhava Lord Bhava Label"},"bhava_lord_dignity":{"type":"string","title":"Bhava Lord Dignity"},"bhava_lord_dignity_label":{"type":"string","title":"Bhava Lord Dignity Label"},"orb_degrees":{"type":"number","title":"Orb Degrees"},"contacts":{"items":{"$ref":"#/components/schemas/EclipseNatalContact"},"type":"array","title":"Contacts"},"on_janma_nakshatra":{"type":"boolean","title":"On Janma Nakshatra"},"on_janma_rashi":{"type":"boolean","title":"On Janma Rashi"},"on_lagna_rashi":{"type":"boolean","title":"On Lagna Rashi"},"on_lagna_degree":{"type":"boolean","title":"On Lagna Degree"},"lagna_separation":{"type":"number","title":"Lagna Separation"},"mahadasha_lord":{"type":"string","title":"Mahadasha Lord"},"mahadasha_lord_label":{"type":"string","title":"Mahadasha Lord Label"},"antardasha_lord":{"type":"string","title":"Antardasha Lord"},"antardasha_lord_label":{"type":"string","title":"Antardasha Lord Label"},"mahadasha_start":{"type":"string","format":"date-time","title":"Mahadasha Start"},"mahadasha_end":{"type":"string","format":"date-time","title":"Mahadasha End"},"dasha_lord_involved":{"type":"boolean","title":"Dasha Lord Involved"},"dasha_involvement":{"type":"string","title":"Dasha Involvement"},"natal_grahan_dosha":{"type":"boolean","title":"Natal Grahan Dosha"},"eclipse_category":{"type":"string","title":"Eclipse Category"},"eclipse_type":{"type":"string","title":"Eclipse Type"},"eclipse_type_label":{"type":"string","title":"Eclipse Type Label"},"magnitude":{"type":"number","title":"Magnitude"},"intensity":{"type":"string","title":"Intensity"},"intensity_label":{"type":"string","title":"Intensity Label"},"intensity_score":{"type":"integer","title":"Intensity Score"},"factors":{"items":{"$ref":"#/components/schemas/EclipseReadingFactor"},"type":"array","title":"Factors"},"reading":{"type":"string","title":"Reading"},"sentences":{"items":{"type":"string"},"type":"array","title":"Sentences"},"basis":{"type":"string","title":"Basis"},"ayanamsa":{"type":"string","title":"Ayanamsa"}},"type":"object","required":["language","lagna","lagna_label","lagna_degree","moon_rashi","moon_rashi_label","moon_nakshatra","moon_nakshatra_label","eclipse_longitude","eclipse_degree_label","bhava_from_lagna","bhava_label","bhava_lord","bhava_lord_label","bhava_lord_rashi","bhava_lord_rashi_label","bhava_lord_bhava","bhava_lord_bhava_label","bhava_lord_dignity","bhava_lord_dignity_label","orb_degrees","on_janma_nakshatra","on_janma_rashi","on_lagna_rashi","on_lagna_degree","lagna_separation","mahadasha_lord","mahadasha_lord_label","antardasha_lord","antardasha_lord_label","mahadasha_start","mahadasha_end","dasha_lord_involved","eclipse_category","eclipse_type","eclipse_type_label","intensity","intensity_label","intensity_score","reading","basis","ayanamsa"],"title":"EclipseNatalReading","description":"One eclipse read against one person's birth chart. Phase 4.\n\nWHAT SEPARATES THIS FROM `EclipsePersonalReading`. That one is derived from a\njanma rashi, so everyone born under the same moon sign gets it word for word,\nand its `basis` says so. This one is derived from a chart: the bhava counted\nfrom the LAGNA (which moves a whole rashi about every two hours, so siblings\nborn the same morning differ), which natal grahas the eclipse degree falls on\nwithin `orb_degrees`, whether it stands in the reader's own janma nakshatra,\nand which Vimshottari lords are running at maximum.\n\nBOTH MAY BE PRESENT AT ONCE, and they can differ: `bhava_from_lagna` is\ncounted from the ascendant and `house_from_rashi` from the moon sign, and only\na reader whose lagna and moon sign coincide sees the same number twice. A\nclient that shows both must label which is which, or the response reads as\ncontradicting itself.\n\n`contacts` IS ALLOWED TO BE EMPTY, and usually is. An eclipse falls on a natal\ngraha within five degrees for a minority of charts; a reading that reports a\ncontact every time has measured nothing. The prose says so explicitly rather\nthan going quiet.\n\n`natal_grahan_dosha` is None when it was not established -- the two-day\neclipse search was skipped or failed. None and False are different answers."},"EclipsePersonalReading":{"properties":{"language":{"type":"string","title":"Language"},"rashi":{"type":"string","title":"Rashi"},"rashi_label":{"type":"string","title":"Rashi Label"},"rashi_english":{"type":"string","title":"Rashi English"},"rashi_lord":{"type":"string","title":"Rashi Lord"},"eclipse_rashi":{"type":"string","title":"Eclipse Rashi"},"eclipse_nakshatra":{"type":"string","title":"Eclipse Nakshatra"},"nakshatra_lord":{"type":"string","title":"Nakshatra Lord"},"rashi_lord_label":{"type":"string","title":"Rashi Lord Label"},"eclipse_rashi_label":{"type":"string","title":"Eclipse Rashi Label"},"eclipse_nakshatra_label":{"type":"string","title":"Eclipse Nakshatra Label"},"nakshatra_lord_label":{"type":"string","title":"Nakshatra Lord Label"},"house_from_rashi":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House From Rashi"},"house_label":{"type":"string","title":"House Label"},"is_janma_rashi":{"type":"boolean","title":"Is Janma Rashi"},"lord_rashi":{"type":"string","title":"Lord Rashi"},"lord_rashi_label":{"type":"string","title":"Lord Rashi Label"},"lord_dignity":{"type":"string","title":"Lord Dignity"},"lord_dignity_label":{"type":"string","title":"Lord Dignity Label"},"lord_retrograde":{"type":"boolean","title":"Lord Retrograde"},"lord_combust":{"type":"boolean","title":"Lord Combust"},"lord_sun_separation":{"type":"number","title":"Lord Sun Separation"},"lord_house_from_rashi":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Lord House From Rashi"},"lord_is_nakshatra_lord":{"type":"boolean","title":"Lord Is Nakshatra Lord"},"eclipse_type":{"type":"string","title":"Eclipse Type"},"eclipse_type_label":{"type":"string","title":"Eclipse Type Label"},"magnitude":{"type":"number","title":"Magnitude"},"intensity":{"type":"string","title":"Intensity"},"intensity_label":{"type":"string","title":"Intensity Label"},"intensity_score":{"type":"integer","title":"Intensity Score"},"factors":{"items":{"$ref":"#/components/schemas/EclipseReadingFactor"},"type":"array","title":"Factors"},"effect":{"type":"string","title":"Effect"},"reading":{"type":"string","title":"Reading"},"sentences":{"items":{"type":"string"},"type":"array","title":"Sentences"},"basis":{"type":"string","title":"Basis"},"ayanamsa":{"type":"string","title":"Ayanamsa"}},"type":"object","required":["language","rashi","rashi_label","rashi_english","rashi_lord","eclipse_rashi","eclipse_nakshatra","nakshatra_lord","rashi_lord_label","eclipse_rashi_label","eclipse_nakshatra_label","nakshatra_lord_label","house_from_rashi","house_label","is_janma_rashi","lord_rashi","lord_rashi_label","lord_dignity","lord_dignity_label","lord_retrograde","lord_combust","lord_sun_separation","lord_house_from_rashi","lord_is_nakshatra_lord","eclipse_type","eclipse_type_label","intensity","intensity_label","intensity_score","effect","reading","basis","ayanamsa"],"title":"EclipsePersonalReading","description":"One eclipse read for one reader's janma rashi.\n\nDERIVED FROM THIS ECLIPSE, not looked up. Five signals: the house counted\nfrom the reader's moon sign to the sign the eclipse falls in (both ends\nincluded); the eclipse's nakshatra and that nakshatra's Vimshottari lord; the\nstate of the reader's own rashi lord at greatest eclipse -- sign, dignity,\nretrogression, combustion; whether that lord is also the nakshatra lord; and\nthe depth of the eclipse. `factors` carries each signal's contribution and\n`intensity_score` is their sum.\n\nWHAT IT STILL DOES NOT READ: the birth chart. Not the lagna, not the natal\ngrahas, not the running dasha -- so every reader of a rashi sees one reading.\n`basis` says that, in the reading's own language, and a client that drops that\nfield is publishing a forecast as if it knew more than it does.\n\n`effect` is the reading's first sentence, kept under its old name so a client\nwritten before this derivation existed still renders something true. `reading`\nis the whole of it and `sentences` the same text unjoined."},"EclipsePhase":{"properties":{"phase_name":{"type":"string","title":"Phase Name"},"phase_name_sanskrit":{"type":"string","title":"Phase Name Sanskrit"},"time_utc":{"type":"string","format":"date-time","title":"Time Utc"},"time_local":{"type":"string","format":"date-time","title":"Time Local"},"altitude":{"type":"number","title":"Altitude"},"azimuth":{"type":"number","title":"Azimuth"}},"type":"object","required":["phase_name","phase_name_sanskrit","time_utc"],"title":"EclipsePhase","description":"Timing of a specific eclipse phase."},"EclipseReadingFactor":{"properties":{"code":{"type":"string","title":"Code"},"label":{"type":"string","title":"Label"},"detail":{"type":"string","title":"Detail"},"weight":{"type":"integer","title":"Weight"}},"type":"object","required":["code","label","detail","weight"],"title":"EclipseReadingFactor","description":"One signal that went into the intensity, and what it contributed.\n\nThe audit trail. `intensity_score` is the sum of these weights and nothing\nelse, so a reader told \"strongly felt\" can see which signals said so and by\nhow much. A reading that cannot be checked is indistinguishable from one that\nwas invented, and this is the difference."},"EclipseTiming":{"properties":{"penumbral_start":{"type":"string","format":"date-time","title":"Penumbral Start"},"penumbral_end":{"type":"string","format":"date-time","title":"Penumbral End"},"partial_start":{"type":"string","format":"date-time","title":"Partial Start"},"partial_end":{"type":"string","format":"date-time","title":"Partial End"},"total_start":{"type":"string","format":"date-time","title":"Total Start"},"total_end":{"type":"string","format":"date-time","title":"Total End"},"maximum":{"type":"string","format":"date-time","title":"Maximum"},"maximum_magnitude":{"type":"number","title":"Maximum Magnitude"},"total_duration_minutes":{"type":"number","title":"Total Duration Minutes"},"partial_duration_minutes":{"type":"number","title":"Partial Duration Minutes"},"penumbral_duration_minutes":{"type":"number","title":"Penumbral Duration Minutes"},"phases":{"items":{"$ref":"#/components/schemas/EclipsePhase"},"type":"array","title":"Phases"}},"type":"object","required":["maximum","maximum_magnitude"],"title":"EclipseTiming","description":"Complete timing information for an eclipse."},"EclipseType":{"type":"string","enum":["total","partial","annular","penumbral","hybrid"],"title":"EclipseType","description":"Type of eclipse."},"EclipseVisibility":{"properties":{"location_name":{"type":"string","title":"Location Name"},"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"timezone":{"type":"string","title":"Timezone"},"visibility_level":{"$ref":"#/components/schemas/VisibilityLevel"},"visible_phases":{"items":{"type":"string"},"type":"array","title":"Visible Phases"},"local_start":{"type":"string","format":"date-time","title":"Local Start"},"local_maximum":{"type":"string","format":"date-time","title":"Local Maximum"},"local_end":{"type":"string","format":"date-time","title":"Local End"},"obscuration_percent":{"type":"number","title":"Obscuration Percent"},"magnitude_local":{"type":"number","title":"Magnitude Local"},"altitude_at_start":{"type":"number","title":"Altitude At Start"},"altitude_at_maximum":{"type":"number","title":"Altitude At Maximum"},"altitude_at_end":{"type":"number","title":"Altitude At End"},"viewing_notes":{"items":{"type":"string"},"type":"array","title":"Viewing Notes"},"notes_language":{"type":"string","title":"Notes Language","default":"en"}},"type":"object","required":["location_name","latitude","longitude","timezone","visibility_level","visible_phases"],"title":"EclipseVisibility","description":"Visibility information for a specific location."},"EconomicRange":{"type":"string","enum":["budget","moderate","premium","no_constraint"],"title":"EconomicRange","description":"Economic consideration for remedy costs."},"EnergyLevel":{"type":"string","enum":["very_high","high","moderate","low","very_low"],"title":"EnergyLevel","description":"Energy levels that can be tracked."},"EventAnalysisRequest":{"properties":{"event_type":{"type":"string","enum":["marriage","career","children","wealth","foreign_travel","education","property","health","divorce","litigation","job_change"],"title":"Event Type","description":"Type of event to analyze","example":"marriage"},"date_of_birth":{"type":"string","format":"date","title":"Date Of Birth","description":"Birth date (YYYY-MM-DD)"},"time_of_birth":{"type":"string","title":"Time Of Birth","description":"Known birth time HH:MM; required for birth-based analysis"},"latitude":{"type":"number","maximum":66.56,"minimum":-66.56,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone"},"house_cusps":{"items":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0},"type":"array","maxItems":12,"minItems":12,"title":"House Cusps","description":"12 house cusp longitudes (KP Placidus preferred)"},"planet_positions":{"additionalProperties":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0},"type":"object","title":"Planet Positions","description":"Planet name → sidereal longitude (KP ayanamsa). All nine KP planets are required for a verdict; partial charts return incomplete."},"include_timing":{"type":"boolean","title":"Include Timing","description":"Attach Vimshottari MD–AD windows","default":true},"timing_years":{"type":"number","maximum":80.0,"minimum":1.0,"title":"Timing Years","description":"Years ahead to scan","default":20.0},"school":{"type":"string","enum":["classic","extended"],"title":"School","description":"Event-house school: classic | extended","default":"classic"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Must be Krishnamurti if provided — KP rejects other frames"}},"type":"object","required":["event_type"],"title":"EventAnalysisRequest"},"EventFeedbackRequest":{"properties":{"user_id":{"type":"string","title":"User Id"},"accuracy_rating":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Accuracy Rating"},"outcome_notes":{"type":"string","title":"Outcome Notes"},"actual_date":{"type":"string","format":"date","title":"Actual Date"}},"type":"object","required":["user_id"],"title":"EventFeedbackRequest"},"EventType":{"type":"string","enum":["marriage","business","travel","education","house_warming","vehicle_purchase","general"],"title":"EventType","description":"Enum for different types of events."},"FamilySevaProgress":{"properties":{"ritual_name":{"type":"string","title":"Ritual Name"},"stage":{"type":"string","enum":["preparing","travelling","arrived","started","completed"],"title":"Stage"},"stage_changed_at":{"type":"string","format":"date-time","title":"Stage Changed At"},"public_message":{"type":"string","title":"Public Message"},"preferred_date":{"type":"string","title":"Preferred Date"},"preferred_time":{"type":"string","title":"Preferred Time"},"mode":{"type":"string","title":"Mode"},"completed_steps":{"type":"integer","title":"Completed Steps"},"total_steps":{"type":"integer","title":"Total Steps"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["ritual_name","stage","stage_changed_at","public_message","completed_steps","total_steps","updated_at"],"title":"FamilySevaProgress"},"FamilyTrackingTokenResponse":{"properties":{"token":{"type":"string","title":"Token"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"type":"object","required":["token","expires_at"],"title":"FamilyTrackingTokenResponse"},"FastingCapability":{"type":"string","enum":["full_fast","water_only","fruit_fast","single_meal","light_food","cannot_fast"],"title":"FastingCapability","description":"Fasting capability level."},"FastingDetails":{"properties":{"vrat_name":{"type":"string","title":"Vrat Name"},"ruling_planet":{"type":"string","title":"Ruling Planet"},"day_of_week":{"type":"string","title":"Day Of Week"},"deity":{"type":"string","title":"Deity"},"purpose":{"type":"string","title":"Purpose"}},"type":"object","required":["vrat_name","ruling_planet","day_of_week","deity","purpose"],"title":"FastingDetails","description":"Details of a fasting practice."},"FastingRecommendation":{"properties":{"primary_fasts":{"items":{"$ref":"#/components/schemas/FastingRemedy"},"type":"array","title":"Primary Fasts"},"fasting_calendar":{"additionalProperties":{"type":"string"},"type":"object","title":"Fasting Calendar"},"special_fasting_days":{"items":{"type":"string"},"type":"array","title":"Special Fasting Days"}},"type":"object","required":["primary_fasts","fasting_calendar","special_fasting_days"],"title":"FastingRecommendation","description":"Complete fasting recommendation set."},"FastingRemedy":{"properties":{"fasting":{"$ref":"#/components/schemas/FastingDetails"},"reason":{"type":"string","title":"Reason"},"problem_addressed":{"type":"string","title":"Problem Addressed"},"duration_type":{"type":"string","title":"Duration Type"},"meal_timings":{"type":"string","title":"Meal Timings"},"foods_allowed":{"items":{"type":"string"},"type":"array","title":"Foods Allowed"},"foods_prohibited":{"items":{"type":"string"},"type":"array","title":"Foods Prohibited"},"water_allowed":{"type":"boolean","title":"Water Allowed"},"start_date":{"type":"string","format":"date","title":"Start Date"},"best_start_nakshatra":{"type":"string","title":"Best Start Nakshatra"},"minimum_weeks":{"type":"integer","title":"Minimum Weeks"},"recommended_weeks":{"type":"integer","title":"Recommended Weeks"},"puja_to_perform":{"type":"string","title":"Puja To Perform"},"mantra_to_chant":{"type":"string","title":"Mantra To Chant"},"story_to_read":{"type":"string","title":"Story To Read"},"break_fast_time":{"type":"string","title":"Break Fast Time"},"break_fast_food":{"type":"string","title":"Break Fast Food"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["fasting","reason","problem_addressed","duration_type","meal_timings","foods_allowed","foods_prohibited","water_allowed","minimum_weeks","recommended_weeks","puja_to_perform","mantra_to_chant","story_to_read","break_fast_time","break_fast_food","effectiveness_score"],"title":"FastingRemedy","description":"Fasting recommendation."},"FavorableDaysOut":{"properties":{"activity":{"type":"string","title":"Activity"},"search_range":{"$ref":"#/components/schemas/app__routers__astro_calendar__SearchRangeOut"},"location":{"$ref":"#/components/schemas/app__routers__astro_calendar__LocationOut"},"days_examined":{"type":"integer","title":"Days Examined"},"total_favorable_days":{"type":"integer","title":"Total Favorable Days"},"favorable_days":{"items":{"$ref":"#/components/schemas/app__routers__astro_calendar__FavorableDayOut"},"type":"array","title":"Favorable Days"},"best_day":{"$ref":"#/components/schemas/app__routers__astro_calendar__FavorableDayOut"},"recommendation":{"type":"string","title":"Recommendation"}},"type":"object","required":["activity","search_range","location","days_examined","total_favorable_days","favorable_days","recommendation"],"title":"FavorableDaysOut"},"FeatureFlag":{"type":"string","enum":["basic_horoscope","detailed_horoscope","kundali_chart","kundali_pdf_export","dasha_predictions","transit_analysis","ashtakavarga","shadbala","divisional_charts","personalized_remedies","gemstone_recommendations","mantra_recommendations","ritual_guidance","detailed_compatibility","kundali_matching","ai_predictions","dream_analysis","voice_horoscope","ai_chat_consultation","pdf_reports","yearly_predictions","api_access"],"title":"FeatureFlag","description":"Feature flags for gating."},"FeedbackRequest":{"properties":{"question_id":{"type":"string","title":"Question Id","description":"ID of the question"},"answer_helpful":{"type":"boolean","title":"Answer Helpful","description":"Whether the answer was helpful"},"correct_answer":{"type":"string","title":"Correct Answer","description":"Correct answer (if known)"},"feedback_text":{"type":"string","title":"Feedback Text","description":"Additional feedback text"}},"type":"object","required":["question_id","answer_helpful"],"title":"FeedbackRequest","description":"Request model for providing feedback on Prashna answers."},"FestivalFeedResponse":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"tithi":{"type":"string","title":"Tithi"},"nakshatra":{"type":"string","title":"Nakshatra"},"festivals_today":{"items":{"type":"string"},"type":"array","title":"Festivals Today"},"vrat_today":{"items":{"type":"string"},"type":"array","title":"Vrat Today"},"dasha_insight":{"type":"string","title":"Dasha Insight"},"ritual_recommendations":{"items":{"$ref":"#/components/schemas/RitualRecommendation"},"type":"array","title":"Ritual Recommendations"},"spiritual_message":{"type":"string","title":"Spiritual Message"}},"type":"object","required":["date","tithi","nakshatra","festivals_today","vrat_today","dasha_insight","ritual_recommendations","spiritual_message"],"title":"FestivalFeedResponse","description":"Schema for festival feed response."},"FindFavorableDaysRequest":{"properties":{"activity":{"allOf":[{"$ref":"#/components/schemas/ActivityType"}],"description":"Activity type. An unrecognised value used to be scored as 'general' and echoed back as though it had been understood.","example":"interview"},"start_date":{"type":"string","format":"date","title":"Start Date","description":"Start of search range"},"end_date":{"type":"string","format":"date","title":"End Date","description":"End of search range"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Latitude of the place"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Longitude of the place"},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata"},"user_id":{"type":"string","title":"User Id","description":"User ID for personalized results"},"limit":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Limit","description":"Maximum days to return","default":10}},"type":"object","required":["activity","start_date","end_date","latitude","longitude","timezone"],"title":"FindFavorableDaysRequest"},"FindFavorableDaysResponse":{"properties":{"activity":{"type":"string","title":"Activity"},"activity_name":{"type":"string","title":"Activity Name"},"activity_description":{"type":"string","title":"Activity Description"},"search_range":{"$ref":"#/components/schemas/app__schemas__advanced_muhurta__SearchRangeOut"},"days_examined":{"type":"integer","title":"Days Examined"},"min_recommended_score":{"type":"number","title":"Min Recommended Score"},"days_meeting_recommended_score":{"type":"integer","title":"Days Meeting Recommended Score"},"recommendation":{"type":"string","title":"Recommendation"},"favorable_days":{"items":{"$ref":"#/components/schemas/app__schemas__advanced_muhurta__FavorableDayOut"},"type":"array","title":"Favorable Days"}},"type":"object","required":["activity","activity_name","activity_description","search_range","days_examined","min_recommended_score","days_meeting_recommended_score","recommendation"],"title":"FindFavorableDaysResponse","description":"GET /advanced-muhurta/favorable-days\n\nThe day-level sibling of /find: the same activity vocabulary and the same\nthree day-level rules, asked over a range instead of one date. A client that\nwants \"which day\" and then \"which hour\" calls this and then /find, and the\ntwo cannot disagree about a date because both read one breakdown helper."},"FindMuhurtaResponse":{"properties":{"date":{"type":"string","title":"Date"},"activity":{"type":"string","title":"Activity"},"activity_name":{"type":"string","title":"Activity Name"},"activity_description":{"type":"string","title":"Activity Description"},"sunrise":{"type":"string","title":"Sunrise"},"sunset":{"type":"string","title":"Sunset"},"total_windows_found":{"type":"integer","title":"Total Windows Found"},"day_quality":{"type":"string","title":"Day Quality"},"day_score":{"type":"number","title":"Day Score"},"best_window":{"$ref":"#/components/schemas/BestWindowOut"},"windows":{"items":{"$ref":"#/components/schemas/MuhurtaWindowOut"},"type":"array","title":"Windows"},"inauspicious_periods":{"items":{"$ref":"#/components/schemas/InauspiciousPeriodOut"},"type":"array","title":"Inauspicious Periods"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["date","activity","activity_name","activity_description","sunrise","sunset","total_windows_found","day_quality","day_score"],"title":"FindMuhurtaResponse","description":"GET /advanced-muhurta/find"},"FirstHoraOut":{"properties":{"planet":{"type":"string","title":"Planet"},"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"duration_minutes":{"type":"integer","title":"Duration Minutes"},"note":{"type":"string","title":"Note"}},"type":"object","required":["planet","start","end","duration_minutes","note"],"title":"FirstHoraOut"},"ForecastCalendarDay":{"properties":{"date":{"type":"string","format":"date-time","title":"Date"},"tone":{"type":"string","title":"Tone"},"support_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Support Score"},"moon_sign":{"type":"string","title":"Moon Sign","default":""},"moon_house_from_rashi":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Moon House From Rashi"},"nakshatra":{"type":"string","title":"Nakshatra","default":""},"is_chandrashtama":{"type":"boolean","title":"Is Chandrashtama","default":false},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"}},"type":"object","required":["date","tone","support_score"],"title":"ForecastCalendarDay","description":"One day in the forecast calendar, derived from the sampled sidereal sky."},"ForecastDetails":{"properties":{"horizon":{"type":"string","title":"Horizon"},"range_start":{"type":"string","format":"date-time","title":"Range Start"},"range_end":{"type":"string","format":"date-time","title":"Range End"},"methods":{"items":{"type":"string"},"type":"array","title":"Methods"},"periods":{"items":{"$ref":"#/components/schemas/ForecastPeriodWindow"},"type":"array","title":"Periods"},"events":{"items":{"$ref":"#/components/schemas/ForecastEvent"},"type":"array","title":"Events"},"calendar_days":{"items":{"$ref":"#/components/schemas/ForecastCalendarDay"},"type":"array","title":"Calendar Days"},"dasha_periods":{"items":{"$ref":"#/components/schemas/DashaWindow"},"type":"array","title":"Dasha Periods"},"annual_forecasts":{"items":{"$ref":"#/components/schemas/AnnualForecastFactor"},"type":"array","title":"Annual Forecasts"},"adjacent_days":{"additionalProperties":{"$ref":"#/components/schemas/AdjacentDay"},"type":"object","title":"Adjacent Days"}},"type":"object","required":["horizon","range_start","range_end"],"title":"ForecastDetails","description":"Structured evidence and timing shared by every Rashifal horizon."},"ForecastEvent":{"properties":{"date":{"type":"string","format":"date-time","title":"Date"},"event_type":{"type":"string","title":"Event Type"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"planet":{"type":"string","title":"Planet"},"nature":{"type":"string","title":"Nature","default":"neutral"},"life_areas":{"items":{"type":"string"},"type":"array","title":"Life Areas"}},"type":"object","required":["date","event_type","title","description"],"title":"ForecastEvent","description":"Calculated change that materially alters the forecast."},"ForecastPeriodWindow":{"properties":{"label":{"type":"string","title":"Label"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"nature":{"type":"string","title":"Nature"},"support_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Support Score"},"summary":{"type":"string","title":"Summary"},"moon_sign":{"type":"string","title":"Moon Sign"},"moon_house_from_rashi":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Moon House From Rashi"},"nakshatra":{"type":"string","title":"Nakshatra"}},"type":"object","required":["label","start_date","end_date","nature","support_score","summary"],"title":"ForecastPeriodWindow","description":"One interpretable slice of a longer prediction horizon."},"ForumStats":{"properties":{"total_posts":{"type":"integer","title":"Total Posts","description":"Total number of posts in the forum"},"total_comments":{"type":"integer","title":"Total Comments","description":"Total number of comments in the forum"},"total_users":{"type":"integer","title":"Total Users","description":"Total number of users in the forum"},"posts_today":{"type":"integer","title":"Posts Today","description":"Number of posts created today"},"active_users_today":{"type":"integer","title":"Active Users Today","description":"Number of active users today"}},"type":"object","required":["total_posts","total_comments","total_users","posts_today","active_users_today"],"title":"ForumStats","description":"Schema for forum statistics."},"GanaKoota":{"properties":{"name":{"type":"string","title":"Name"},"max_points":{"type":"number","title":"Max Points"},"obtained_points":{"type":"number","title":"Obtained Points"},"percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Percentage"},"bride_value":{"type":"string","title":"Bride Value"},"groom_value":{"type":"string","title":"Groom Value"},"compatibility_status":{"type":"string","title":"Compatibility Status","description":"Good, Average, or Poor"},"description":{"type":"string","title":"Description"},"analysis":{"type":"string","title":"Analysis"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"bride_gana":{"type":"string","title":"Bride Gana","description":"Deva, Manushya, or Rakshasa"},"groom_gana":{"type":"string","title":"Groom Gana","description":"Deva, Manushya, or Rakshasa"}},"type":"object","required":["name","max_points","obtained_points","percentage","bride_value","groom_value","compatibility_status","description","analysis","bride_gana","groom_gana"],"title":"GanaKoota","description":"Gana Koota - Temperament compatibility (6 points).\n\nThree Ganas: Deva (divine), Manushya (human), Rakshasa (demon)\n\nRules:\n- Same Gana = 6 points\n- Deva-Manushya = 5 points\n- Manushya-Rakshasa = 1 point\n- Deva-Rakshasa = 0 points (with some exceptions)"},"GemstoneProperty":{"properties":{"name":{"type":"string","title":"Name"},"sanskrit_name":{"type":"string","title":"Sanskrit Name"},"ruling_planet":{"type":"string","title":"Ruling Planet"},"color":{"type":"string","title":"Color"},"minimum_carat":{"type":"number","title":"Minimum Carat"},"recommended_carat":{"type":"number","title":"Recommended Carat"},"quality_indicators":{"items":{"type":"string"},"type":"array","title":"Quality Indicators"},"metal_for_setting":{"type":"string","title":"Metal For Setting"},"finger_to_wear":{"type":"string","title":"Finger To Wear"},"hand_to_wear":{"type":"string","title":"Hand To Wear"},"price_range":{"type":"string","title":"Price Range"}},"type":"object","required":["name","sanskrit_name","ruling_planet","color","minimum_carat","recommended_carat","quality_indicators","metal_for_setting","finger_to_wear","hand_to_wear","price_range"],"title":"GemstoneProperty","description":"Properties of a gemstone."},"GemstoneRemedy":{"properties":{"gemstone":{"$ref":"#/components/schemas/GemstoneProperty"},"reason":{"type":"string","title":"Reason"},"affliction_addressed":{"$ref":"#/components/schemas/PlanetaryAffliction"},"planet":{"type":"string","title":"Planet"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"},"best_day_to_wear":{"type":"string","title":"Best Day To Wear"},"best_time_to_wear":{"type":"string","title":"Best Time To Wear"},"nakshatra_for_wearing":{"type":"string","title":"Nakshatra For Wearing"},"activation_mantra":{"type":"string","title":"Activation Mantra"},"mantra_count":{"type":"integer","title":"Mantra Count"},"alternatives":{"items":{"type":"string"},"type":"array","title":"Alternatives"},"contraindications":{"items":{"type":"string"},"type":"array","title":"Contraindications"},"trial_period_days":{"type":"integer","title":"Trial Period Days"},"care_instructions":{"type":"string","title":"Care Instructions"},"replacement_period_years":{"type":"integer","title":"Replacement Period Years"}},"type":"object","required":["gemstone","reason","affliction_addressed","planet","effectiveness_score","best_day_to_wear","best_time_to_wear","activation_mantra","mantra_count","alternatives","contraindications","trial_period_days","care_instructions","replacement_period_years"],"title":"GemstoneRemedy","description":"Gemstone recommendation."},"GemstoneRequest":{"properties":{"birth_date":{"type":"string","format":"date-time","title":"Birth Date","description":"Date and time of birth"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude","description":"Latitude of birth location"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude","description":"Longitude of birth location"},"birth_timezone":{"type":"string","title":"Birth Timezone","description":"Timezone of birth location"},"include_alternative":{"type":"boolean","title":"Include Alternative","description":"Whether to include alternative gemstones","default":true},"include_metals":{"type":"boolean","title":"Include Metals","description":"Whether to include metal recommendations","default":true}},"type":"object","required":["birth_date","birth_latitude","birth_longitude","birth_timezone"],"title":"GemstoneRequest","description":"Request model for gemstone recommendations."},"GemstoneResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in ISO format"},"primary_recommendations":{"items":{"$ref":"#/components/schemas/app__schemas__gemstone__GemstoneRecommendation"},"type":"array","title":"Primary Recommendations","description":"Primary gemstone recommendations"},"alternative_recommendations":{"items":{"$ref":"#/components/schemas/app__schemas__gemstone__GemstoneRecommendation"},"type":"array","title":"Alternative Recommendations","description":"Alternative gemstone recommendations"},"metal_recommendations":{"items":{"$ref":"#/components/schemas/MetalRecommendation"},"type":"array","title":"Metal Recommendations","description":"Metal recommendations"},"summary":{"type":"string","title":"Summary","description":"Summary of gemstone recommendations"},"wearing_instructions":{"items":{"type":"string"},"type":"array","title":"Wearing Instructions","description":"Instructions for wearing gemstones"},"planetary_analysis":{"additionalProperties":{"type":"object"},"type":"object","title":"Planetary Analysis","description":"Analysis of planetary positions and strengths"}},"type":"object","required":["birth_date","primary_recommendations","summary","wearing_instructions","planetary_analysis"],"title":"GemstoneResponse","description":"Response model for gemstone recommendations."},"GemstoneType":{"type":"string","enum":["ruby","pearl","red_coral","emerald","yellow_sapphire","diamond","blue_sapphire","hessonite","cats_eye"],"title":"GemstoneType","description":"Types of gemstones."},"GocharaAnalysis":{"properties":{"analysis_date":{"type":"string","format":"date-time","title":"Analysis Date"},"natal_moon_sign":{"type":"string","title":"Natal Moon Sign"},"natal_moon_sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Natal Moon Sign Num"},"planet_transits":{"additionalProperties":{"$ref":"#/components/schemas/PlanetTransit"},"type":"object","title":"Planet Transits"},"vedha_points":{"items":{"$ref":"#/components/schemas/VedhaPoint"},"type":"array","title":"Vedha Points"},"active_vedhas":{"type":"integer","title":"Active Vedhas"},"sade_sati":{"$ref":"#/components/schemas/SadeSatiAnalysis"},"dhaiya":{"$ref":"#/components/schemas/DhaiyaAnalysis"},"major_transits":{"items":{"$ref":"#/components/schemas/MajorTransit"},"type":"array","title":"Major Transits"},"house_effects":{"items":{"$ref":"#/components/schemas/HouseTransitEffect"},"type":"array","title":"House Effects"},"upcoming_transits":{"items":{"$ref":"#/components/schemas/TransitTimeline"},"type":"array","title":"Upcoming Transits"},"transit_compatibility":{"$ref":"#/components/schemas/TransitCompatibility"},"summary":{"type":"string","title":"Summary"},"key_themes":{"items":{"type":"string"},"type":"array","title":"Key Themes"},"favorable_periods":{"items":{"type":"string"},"type":"array","title":"Favorable Periods"},"challenging_periods":{"items":{"type":"string"},"type":"array","title":"Challenging Periods"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["analysis_date","natal_moon_sign","natal_moon_sign_num","planet_transits","vedha_points","active_vedhas","sade_sati","dhaiya","major_transits","house_effects","upcoming_transits","transit_compatibility","summary","key_themes","favorable_periods","challenging_periods","recommendations"],"title":"GocharaAnalysis","description":"Complete Gochara (Transit) Analysis"},"GocharaPrediction":{"properties":{"period_start":{"type":"string","format":"date-time","title":"Period Start"},"period_end":{"type":"string","format":"date-time","title":"Period End"},"period_type":{"type":"string","title":"Period Type"},"dominant_transits":{"items":{"$ref":"#/components/schemas/DominantTransit"},"type":"array","title":"Dominant Transits"},"overall_tone":{"$ref":"#/components/schemas/TransitNature"},"score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Score"},"career":{"type":"string","title":"Career"},"finance":{"type":"string","title":"Finance"},"health":{"type":"string","title":"Health"},"relationships":{"type":"string","title":"Relationships"},"spirituality":{"type":"string","title":"Spirituality"},"favorable_dates":{"items":{"type":"string","format":"date"},"type":"array","title":"Favorable Dates"},"challenging_dates":{"items":{"type":"string","format":"date"},"type":"array","title":"Challenging Dates"},"advice":{"type":"string","title":"Advice"}},"type":"object","required":["period_start","period_end","period_type","dominant_transits","overall_tone","score","career","finance","health","relationships","spirituality","favorable_dates","challenging_dates","advice"],"title":"GocharaPrediction","description":"Gochara-based predictions for specific period"},"GocharaPredictionRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"birth_time":{"type":"string","title":"Birth Time"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"period_type":{"type":"string","title":"Period Type","default":"monthly"},"start_date":{"type":"string","title":"Start Date"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude"],"title":"GocharaPredictionRequest","description":"Request for Gochara-based predictions"},"GocharaPredictionResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"prediction":{"$ref":"#/components/schemas/GocharaPrediction"}},"type":"object","required":["prediction"],"title":"GocharaPredictionResponse","description":"Response for Gochara predictions"},"GocharaRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in YYYY-MM-DD format"},"birth_time":{"type":"string","title":"Birth Time","description":"Birth time in HH:MM:SS format"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"analysis_date":{"type":"string","title":"Analysis Date","description":"Date to analyze transits"},"include_vedha":{"type":"boolean","title":"Include Vedha","default":true},"include_ashtakavarga":{"type":"boolean","title":"Include Ashtakavarga","default":true},"include_timeline":{"type":"boolean","title":"Include Timeline","default":true},"timeline_days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Timeline Days","default":90},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude"],"title":"GocharaRequest","description":"Request for Gochara analysis"},"GocharaResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"analysis":{"$ref":"#/components/schemas/GocharaAnalysis"},"calculation_time_ms":{"type":"number","title":"Calculation Time Ms"}},"type":"object","required":["analysis","calculation_time_ms"],"title":"GocharaResponse","description":"Response for Gochara analysis"},"GowriPeriod":{"properties":{"start":{"type":"string","title":"Start","description":"Start time in ISO format"},"end":{"type":"string","title":"End","description":"End time in ISO format"},"name":{"type":"string","title":"Name","description":"Amirdha, Dhanam, Laabam, Rogam, Soram, Sugam, Uthi or Visham"},"quality":{"type":"string","title":"Quality","description":"'auspicious' or 'inauspicious'. Never 'neutral': Gowri has no middle tier, unlike Choghadiya, whose Char is neutral. The auspicious five are what Nalla Neram names -- it is a filter over these same slots rather than a separate reckoning, so it is not a separate field"},"is_best":{"type":"boolean","title":"Is Best","description":"Amirdha alone, the most favourable of the five. One publisher's markup supports this finer distinction and its own prose does not, so it is a flag a client may ignore and still be right -- not a third quality"},"period":{"type":"string","title":"Period","description":"'day' or 'night'"},"system":{"type":"string","title":"System","description":"Ephemeris system used. It moves the boundaries, never the names: there is no Western Gowri to switch to"}},"type":"object","required":["start","end","name","quality","is_best","period"],"title":"GowriPeriod","description":"One Gowri Panchangam slot: an eighth of the daylight, or of the night.\n\nThe same geometry as ``ChoghadiyaPeriod`` and a different naming — eight\nTamil names rather than the North-Indian seven, and not a relabelling of\nthem (see ``app.core.gowri``). ``name`` is carried rather than ``type``\nbecause these are proper nouns; a client rendering both tables reads\n``type`` on one and ``name`` on the other, which is the honest signal that\nthe two vocabularies do not map onto each other.\n\nUnlike Choghadiya the grading travels on the wire. Choghadiya's seven names\nare graded the same way by everyone, so a client can hold its own table;\nGowri's are not -- one publisher's markup puts Amirdha in a class of its own\nwhile its prose and a second publisher say five good and three bad -- so a\nclient deciding for itself would be picking a side we have already picked\nwith the evidence in front of us."},"GrahaMaitriKoota":{"properties":{"name":{"type":"string","title":"Name"},"max_points":{"type":"number","title":"Max Points"},"obtained_points":{"type":"number","title":"Obtained Points"},"percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Percentage"},"bride_value":{"type":"string","title":"Bride Value"},"groom_value":{"type":"string","title":"Groom Value"},"compatibility_status":{"type":"string","title":"Compatibility Status","description":"Good, Average, or Poor"},"description":{"type":"string","title":"Description"},"analysis":{"type":"string","title":"Analysis"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"bride_moon_lord":{"type":"string","title":"Bride Moon Lord"},"groom_moon_lord":{"type":"string","title":"Groom Moon Lord"},"lord_relationship":{"type":"string","title":"Lord Relationship","description":"Friends, One-Friend-One-Neutral, Neutral, etc."}},"type":"object","required":["name","max_points","obtained_points","percentage","bride_value","groom_value","compatibility_status","description","analysis","bride_moon_lord","groom_moon_lord","lord_relationship"],"title":"GrahaMaitriKoota","description":"Graha Maitri Koota - Mental/Intellectual compatibility (5 points).\n\nBased on friendship between Moon sign lords.\n\nRules:\n- Both lords are friends = 5 points\n- One friend, one neutral = 4 points\n- Both neutral = 3 points\n- One friend, one enemy = 1 point\n- One neutral, one enemy = 0.5 points\n- Both enemies = 0 points"},"GrahanDosha":{"type":"string","enum":["janma_grahan","rashi_grahan","lagna_grahan","surya_grahan","chandra_grahan"],"title":"GrahanDosha","description":"Types of Grahan Dosha (astrological afflictions)."},"GrahanDoshaRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date/time YYYY-MM-DD or YYYY-MM-DD HH:MM (local)"},"latitude":{"type":"number","title":"Latitude","description":"Birth latitude"},"longitude":{"type":"number","title":"Longitude","description":"Birth longitude"},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone of the birth place","default":"UTC"}},"type":"object","required":["birth_date","latitude","longitude"],"title":"GrahanDoshaRequest"},"GunaMilan":{"properties":{"varna":{"type":"integer","title":"Varna"},"vasya":{"type":"integer","title":"Vasya"},"tara":{"type":"integer","title":"Tara"},"yoni":{"type":"integer","title":"Yoni"},"graha":{"type":"integer","title":"Graha"},"gana":{"type":"integer","title":"Gana"},"bhakoot":{"type":"integer","title":"Bhakoot"},"nadi":{"type":"integer","title":"Nadi"},"total_score":{"type":"integer","title":"Total Score"},"compatibility_percentage":{"type":"number","title":"Compatibility Percentage"},"description":{"type":"string","title":"Description"}},"type":"object","required":["varna","vasya","tara","yoni","graha","gana","bhakoot","nadi","total_score","compatibility_percentage","description"],"title":"GunaMilan"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthCondition":{"type":"string","enum":["diabetes","hypertension","heart_condition","kidney_issues","liver_issues","thyroid","anemia","gastric_issues","pregnancy","lactating","elderly_frail","none"],"title":"HealthCondition","description":"Health conditions affecting remedy suitability."},"Highlight":{"properties":{"id":{"type":"string","title":"Id"},"chapter":{"type":"integer","title":"Chapter"},"verse_id":{"type":"string","title":"Verse Id"},"range":{"items":{"type":"integer"},"type":"array","maxItems":2,"minItems":2,"title":"Range"},"color":{"type":"string","title":"Color"},"note":{"type":"string","title":"Note"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","chapter","verse_id","range","color","created_at"],"title":"Highlight"},"HighlightCreate":{"properties":{"chapter":{"type":"integer","title":"Chapter"},"verse_id":{"type":"string","title":"Verse Id"},"range":{"items":{"type":"integer"},"type":"array","maxItems":2,"minItems":2,"title":"Range"},"color":{"type":"string","title":"Color","default":"yellow"},"note":{"type":"string","title":"Note"}},"type":"object","required":["chapter","verse_id","range"],"title":"HighlightCreate"},"HighlightUpdate":{"properties":{"color":{"type":"string","title":"Color"},"note":{"type":"string","title":"Note"}},"type":"object","title":"HighlightUpdate"},"HoraBala":{"properties":{"planet":{"type":"string","title":"Planet"},"birth_hora_lord":{"type":"string","title":"Birth Hora Lord"},"is_hora_lord":{"type":"boolean","title":"Is Hora Lord"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","birth_hora_lord","is_hora_lord","strength_virupas"],"title":"HoraBala","description":"Hora (planetary hour) strength."},"HoraGuideEntryOut":{"properties":{"sanskrit":{"type":"string","title":"Sanskrit"},"day":{"type":"string","title":"Day"},"quality":{"type":"string","title":"Quality"},"suitable_activities":{"items":{"type":"string"},"type":"array","title":"Suitable Activities"},"avoid":{"items":{"type":"string"},"type":"array","title":"Avoid"}},"type":"object","required":["sanskrit","day","quality"],"title":"HoraGuideEntryOut","description":"One planet's hora guidance; the response keys these by planet name."},"HoraGuideResponse":{"properties":{"description":{"type":"string","title":"Description"},"calculation":{"type":"string","title":"Calculation"},"horas":{"additionalProperties":{"$ref":"#/components/schemas/HoraGuideEntryOut"},"type":"object","title":"Horas"}},"type":"object","required":["description","calculation"],"title":"HoraGuideResponse","description":"GET /advanced-muhurta/hora-guide"},"HoraOut":{"properties":{"number":{"type":"integer","title":"Number"},"lord":{"type":"string","title":"Lord"},"lord_sanskrit":{"type":"string","title":"Lord Sanskrit"},"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"is_day":{"type":"boolean","title":"Is Day"},"quality":{"type":"string","title":"Quality"},"suitable_for":{"items":{"type":"string"},"type":"array","title":"Suitable For"}},"type":"object","required":["number","lord","lord_sanskrit","start","end","is_day","quality"],"title":"HoraOut"},"HoraPeriod":{"properties":{"start":{"type":"string","title":"Start","description":"Start time in ISO format"},"end":{"type":"string","title":"End","description":"End time in ISO format"},"ruler":{"type":"string","title":"Ruler","description":"Ruling planet, in Chaldean order from the vara lord"},"type":{"type":"string","title":"Type","description":"'day' or 'night'"},"system":{"type":"string","title":"System","description":"Ephemeris system used"}},"type":"object","required":["start","end","ruler","type"],"title":"HoraPeriod","description":"One planetary hour: a twelfth of the daylight, or of the night."},"HoroscopeBriefing":{"properties":{"focus":{"type":"string","title":"Focus"},"caution":{"type":"string","title":"Caution"},"best_action":{"type":"string","title":"Best Action"},"tone":{"type":"string","title":"Tone"},"key_focus":{"type":"string","title":"Key Focus"}},"type":"object","required":["focus","caution","best_action","tone"],"title":"HoroscopeBriefing","description":"API-owned morning cues derived from Moon gochara (daily readings)."},"HoroscopeGuidance":{"properties":{"moon_house_from_rashi":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Moon House From Rashi"},"do":{"items":{"type":"string"},"type":"array","title":"Do"},"dont":{"type":"string","title":"Dont"}},"type":"object","title":"HoroscopeGuidance","description":"What the day's Moon house favours, and what it warns against.\n\nThe classical tables are asymmetric and this model does not hide it: every\nhouse lists several favoured activities, and only half of them name anything\nto avoid. `dont` is therefore null for six of the twelve houses, and that\nnull means \"this house warns against nothing\", not \"we could not find it\"."},"HoroscopeRequest":{"properties":{"rashi":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Rashi"},"zodiac_sign":{"type":"string","minLength":1,"title":"Zodiac Sign"},"sign":{"type":"string","minLength":1,"title":"Sign"},"date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"}],"title":"Date"},"year":{"type":"integer","maximum":2200.0,"minimum":1900.0,"title":"Year"},"years":{"type":"integer","maximum":10.0,"minimum":2.0,"title":"Years","description":"Number of years for a multi-year forecast"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone"},"ayanamsa":{"type":"string","minLength":1,"title":"Ayanamsa"},"language":{"type":"string","maxLength":5,"minLength":2,"title":"Language"},"birth_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date"}],"title":"Birth Date"},"birth_time":{"type":"string","title":"Birth Time","description":"HH:MM (24h), local to birth_timezone"},"birth_timezone":{"type":"string","title":"Birth Timezone"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"}},"type":"object","title":"HoroscopeRequest"},"HoroscopeResponse":{"properties":{"rashi":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Rashi"},"date":{"type":"string","format":"date-time","title":"Date"},"prediction":{"type":"string","title":"Prediction"},"lucky_number":{"type":"integer","title":"Lucky Number"},"lucky_color":{"type":"string","title":"Lucky Color"},"compatibility":{"items":{"type":"string"},"type":"array","title":"Compatibility"},"health":{"type":"string","title":"Health"},"career":{"type":"string","title":"Career"},"relationships":{"type":"string","title":"Relationships"},"finance":{"type":"string","title":"Finance"},"transits":{"items":{"$ref":"#/components/schemas/TransitInfo"},"type":"array","title":"Transits"},"lucky_direction":{"type":"string","title":"Lucky Direction"},"direction_note":{"type":"string","title":"Direction Note"},"remedy":{"type":"string","title":"Remedy"},"personalization":{"$ref":"#/components/schemas/PersonalizationBlock"},"transit_evidence":{"items":{"$ref":"#/components/schemas/HoroscopeTransitEvidence"},"type":"array","title":"Transit Evidence"},"forecast_details":{"$ref":"#/components/schemas/ForecastDetails"},"briefing":{"$ref":"#/components/schemas/HoroscopeBriefing"},"guidance":{"$ref":"#/components/schemas/HoroscopeGuidance"},"key_focus":{"type":"string","title":"Key Focus"},"narrative_source":{"type":"string","title":"Narrative Source","description":"template | realised | synthesized","default":"template"},"closing_verse":{"$ref":"#/components/schemas/ClosingVerse"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied for this reading","default":"Lahiri"},"audio_content_hash":{"type":"string","title":"Audio Content Hash"},"audio_authorization":{"type":"string","title":"Audio Authorization"}},"type":"object","required":["rashi","date","prediction","lucky_number","lucky_color","compatibility","health","career","relationships","finance","transits"],"title":"HoroscopeResponse","description":"Response model for horoscope calculations.\n\nAttributes:\n rashi: Zodiac sign (1-12)\n date: Date of calculation\n prediction: Main prediction\n lucky_number: Lucky number for the day\n lucky_color: Lucky color for the day\n compatibility: List of compatible rashis\n health: Health prediction\n career: Career prediction\n relationships: Relationship prediction\n finance: Finance prediction\n transits: Current planetary transits\n personalization: Optional birth-profile lens"},"HoroscopeTransitEvidence":{"properties":{"planet":{"type":"string","title":"Planet"},"sign":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign"},"sign_name":{"type":"string","title":"Sign Name"},"house_from_rashi":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House From Rashi"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_lord":{"type":"string","title":"Nakshatra Lord"},"dignity":{"type":"string","title":"Dignity"},"is_retrograde":{"type":"boolean","title":"Is Retrograde","default":false}},"type":"object","required":["planet","sign","sign_name","house_from_rashi"],"title":"HoroscopeTransitEvidence","description":"Calculated sidereal placement used to produce a sign-level reading."},"HouseData":{"properties":{"house_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House Num"},"sign":{"type":"string","title":"Sign"},"sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign Num"},"degree":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Degree"},"lord":{"type":"string","title":"Lord"}},"type":"object","required":["house_num","sign","sign_num","degree","lord"],"title":"HouseData","description":"House cusp data"},"HousePosition":{"properties":{"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Longitude"},"sign":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign"},"nakshatra":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Nakshatra"},"pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada"}},"type":"object","required":["house","longitude","sign","nakshatra","pada"],"title":"HousePosition"},"HouseStrength":{"properties":{"house_number":{"type":"integer","title":"House Number"},"sign":{"type":"integer","title":"Sign"},"sign_name":{"type":"string","title":"Sign Name"},"sarvashtakavarga_bindus":{"type":"integer","title":"Sarvashtakavarga Bindus"},"strength_level":{"$ref":"#/components/schemas/StrengthLevel"},"house_significations":{"items":{"type":"string"},"type":"array","title":"House Significations"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["house_number","sign","sign_name","sarvashtakavarga_bindus","strength_level","house_significations","interpretation"],"title":"HouseStrength","description":"Strength analysis for a house."},"HouseTransitEffect":{"properties":{"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"house_name":{"type":"string","title":"House Name"},"significations":{"items":{"type":"string"},"type":"array","title":"Significations"},"transiting_planets":{"items":{"type":"string"},"type":"array","title":"Transiting Planets"},"overall_effect":{"$ref":"#/components/schemas/TransitNature"},"strength":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Strength"},"predictions":{"items":{"type":"string"},"type":"array","title":"Predictions"},"timing":{"type":"string","title":"Timing"}},"type":"object","required":["house","house_name","significations","transiting_planets","overall_effect","strength","predictions","timing"],"title":"HouseTransitEffect","description":"Transit effects for a specific house"},"InauspiciousPeriodOut":{"properties":{"name":{"type":"string","title":"Name"},"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"severity":{"type":"string","title":"Severity"},"duration_minutes":{"type":"number","title":"Duration Minutes"}},"type":"object","required":["start","end"],"title":"InauspiciousPeriodOut","description":"A named period. Which fields are populated depends on the caller."},"InauspiciousTimesResponse":{"properties":{"rahu_kaal":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Rahu Kaal","description":"Time range for Rahu Kaal"},"gulika_kaal":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Gulika Kaal","description":"Time range for Gulika Kaal"},"yamaganda":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Yamaganda","description":"Time range for Yamaganda"},"varjya_kaal":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Varjya Kaal","description":"First Varjyam window of the day; null if the day has none"},"varjya_kaal_windows":{"items":{"$ref":"#/components/schemas/TimeRange"},"type":"array","title":"Varjya Kaal Windows","description":"Every Varjyam window beginning in this sunrise-to-sunrise day"},"bhadra_kaal":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Bhadra Kaal","description":"First Bhadra (Vishti karana) window; null on the many days with none"},"bhadra_kaal_windows":{"items":{"$ref":"#/components/schemas/TimeRange"},"type":"array","title":"Bhadra Kaal Windows","description":"Every Bhadra (Vishti karana) window touching this day"},"dur_muhurtam":{"items":{"$ref":"#/components/schemas/TimeRange"},"type":"array","title":"Dur Muhurtam","description":"Dur Muhurtam windows for the vara; one or two a day, Tuesday's second at night"}},"type":"object","required":["rahu_kaal","gulika_kaal","yamaganda"],"title":"InauspiciousTimesResponse","description":"Response model for inauspicious times calculations.\n\nAttributes:\n rahu_kaal: Time range for Rahu Kaal\n gulika_kaal: Time range for Gulika Kaal\n yamaganda: Time range for Yamaganda\n varjya_kaal: First Varjyam window of the day, if any\n varjya_kaal_windows: Every Varjyam window touching the day\n bhadra_kaal: First Bhadra window of the day, if any\n bhadra_kaal_windows: Every Bhadra window touching the day\n dur_muhurtam: Dur Muhurtam windows for the vara\n\nVarjyam and Bhadra are optional lists for the same reason Amrit Kaal is.\nBhadra in particular is empty on most days: it exists only while the Vishti\nkarana runs, so an always-present Bhadra would be an invented one."},"InfluenceNature":{"type":"string","enum":["highly_favorable","favorable","mixed","challenging","highly_challenging"],"title":"InfluenceNature","description":"Nature of the influence."},"InterpretedDashaPeriod":{"properties":{"level":{"type":"string","title":"Level"},"lord":{"type":"string","title":"Lord"},"parent_lord":{"type":"string","title":"Parent Lord"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"is_active":{"type":"boolean","title":"Is Active","default":false},"placement":{"$ref":"#/components/schemas/DashaPlanetPlacement"},"life_themes":{"items":{"$ref":"#/components/schemas/DashaLifeTheme"},"type":"array","title":"Life Themes"},"summary":{"type":"string","title":"Summary"}},"type":"object","required":["level","lord","start_date","end_date","placement","life_themes","summary"],"title":"InterpretedDashaPeriod"},"JaiminiAspect":{"properties":{"aspecting_sign":{"type":"string","title":"Aspecting Sign","description":"Sign casting aspect"},"aspected_sign":{"type":"string","title":"Aspected Sign","description":"Sign receiving aspect"},"aspect_type":{"allOf":[{"$ref":"#/components/schemas/JaiminiAspectType"}],"description":"Type of aspect"},"planets_in_aspecting_sign":{"items":{"type":"string"},"type":"array","title":"Planets In Aspecting Sign"},"planets_in_aspected_sign":{"items":{"type":"string"},"type":"array","title":"Planets In Aspected Sign"},"effect":{"type":"string","title":"Effect","description":"Effect of this aspect"}},"type":"object","required":["aspecting_sign","aspected_sign","aspect_type","effect"],"title":"JaiminiAspect","description":"Jaimini sign-based aspect."},"JaiminiAspectType":{"type":"string","enum":["full","partial"],"title":"JaiminiAspectType","description":"Jaimini sign-based aspects."},"JaiminiKarakaInfo":{"properties":{"karaka_type":{"allOf":[{"$ref":"#/components/schemas/app__schemas__dasha__JaiminiKaraka"}],"description":"Type of Karaka"},"planet":{"type":"string","title":"Planet","description":"Planet acting as this Karaka"},"degree":{"type":"number","title":"Degree","description":"Degree of the planet"},"sign":{"type":"string","title":"Sign","description":"Sign placement"},"house":{"type":"integer","title":"House","description":"House placement"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Karaka strength"},"significations":{"items":{"type":"string"},"type":"array","title":"Significations","description":"Life areas signified"}},"type":"object","required":["karaka_type","planet","degree","sign","house","strength"],"title":"JaiminiKarakaInfo","description":"Model for Jaimini Karaka information."},"JaiminiKarakaType":{"type":"string","enum":["atmakaraka","amatyakaraka","bhratrukaraka","matrukaraka","putrakaraka","gnatikaraka","darakaraka"],"title":"JaiminiKarakaType","description":"Jaimini Chara Karaka types (7 significators)."},"JaiminiRequest":{"properties":{"birth_date":{"type":"string","format":"date-time","title":"Birth Date","description":"Birth date and time"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude","description":"Birth latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude","description":"Birth longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","description":"Birth timezone"},"include_aspects":{"type":"boolean","title":"Include Aspects","description":"Include Jaimini aspects","default":true},"include_argalas":{"type":"boolean","title":"Include Argalas","description":"Include Argala analysis","default":true},"include_arudhas":{"type":"boolean","title":"Include Arudhas","description":"Include all Arudha Padas","default":true},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa (same Vedic set as Parashari; default Lahiri)"}},"type":"object","required":["birth_date","birth_latitude","birth_longitude","birth_timezone"],"title":"JaiminiRequest","description":"Request for Jaimini astrology analysis."},"JaiminiResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date"},"lagna_sign":{"type":"string","title":"Lagna Sign","description":"Ascendant sign"},"lagna_lord":{"type":"string","title":"Lagna Lord","description":"Ascendant lord"},"karakas":{"items":{"$ref":"#/components/schemas/app__schemas__jaimini__JaiminiKaraka"},"type":"array","title":"Karakas","description":"7 Chara Karakas"},"atmakaraka_analysis":{"type":"string","title":"Atmakaraka Analysis","description":"Detailed AK analysis"},"karakamsha":{"allOf":[{"$ref":"#/components/schemas/Karakamsha"}],"title":"Karakamsha","description":"Karakamsha analysis"},"arudha_lagna":{"allOf":[{"$ref":"#/components/schemas/ArudhaPada"}],"title":"Arudha Lagna","description":"Arudha Lagna (A1)"},"upapada_lagna":{"allOf":[{"$ref":"#/components/schemas/UpaPadaLagna"}],"title":"Upapada Lagna","description":"Upapada Lagna, the Arudha of the 12th house"},"all_arudhas":{"items":{"$ref":"#/components/schemas/ArudhaPada"},"type":"array","title":"All Arudhas","description":"All 12 Arudha Padas"},"jaimini_aspects":{"items":{"$ref":"#/components/schemas/JaiminiAspect"},"type":"array","title":"Jaimini Aspects","description":"Sign-based aspects"},"argalas":{"items":{"$ref":"#/components/schemas/Argala"},"type":"array","title":"Argalas","description":"Argala analysis"},"summary":{"type":"string","title":"Summary","description":"Overall Jaimini analysis summary"},"key_life_themes":{"items":{"type":"string"},"type":"array","title":"Key Life Themes","description":"Major life themes"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations","description":"Recommendations"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"jaimini"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["birth_date","lagna_sign","lagna_lord","karakas","atmakaraka_analysis","karakamsha","arudha_lagna","upapada_lagna","summary"],"title":"JaiminiResponse","description":"Complete Jaimini astrology analysis response."},"JanmaRashiRequest":{"properties":{"date_of_birth":{"type":"string","format":"date","title":"Date Of Birth"},"birth_time":{"type":"string","format":"time","title":"Birth Time","description":"Local clock time at birth, HH:MM or HH:MM:SS. Required: the Moon covers a sign in about 2.25 days, so a date read as midnight can be half a sign out."},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Birth place latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Birth place longitude"},"timezone":{"type":"string","title":"Timezone","description":"IANA zone of the birth place; derived from latitude/longitude when sent"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal frame; an unknown name is served as Lahiri."}},"type":"object","required":["date_of_birth","birth_time","timezone"],"title":"JanmaRashiRequest"},"JanmaRashiResponse":{"properties":{"number":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Number"},"name":{"type":"string","title":"Name"},"name_en":{"type":"string","title":"Name En"},"degrees":{"type":"number","title":"Degrees","description":"Degrees within the sign, 0-30"},"nakshatra_number":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Nakshatra Number"},"nakshatra":{"type":"string","title":"Nakshatra"},"pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada"},"ayanamsa":{"type":"string","title":"Ayanamsa"}},"type":"object","required":["number","name","name_en","degrees","nakshatra_number","nakshatra","pada","ayanamsa"],"title":"JanmaRashiResponse","description":"The Moon's sign at a birth INSTANT -- not at that day's sunrise.\n\nShared by the public rashi finder and by every person in a family\nhousehold, so a member's rashi in the dashboard and the same birth details\ntyped into the finder can never disagree.\n\n`ayanamsa` is the frame the numbers were actually computed in, echoed back\nbecause the frame decides which side of a boundary a near-cusp birth falls\non, and because an unknown requested name is served as Lahiri rather than\nrefused."},"JournalInsight":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"entry_id":{"type":"string","title":"Entry Id"},"insight_type":{"type":"string","title":"Insight Type"},"content":{"type":"string","title":"Content"},"moon_phase":{"$ref":"#/components/schemas/MoonPhase"},"moon_sign":{"$ref":"#/components/schemas/MoonSign"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","user_id","entry_id","insight_type","content","moon_phase","moon_sign","created_at","updated_at"],"title":"JournalInsight","description":"Model for journal insights."},"JournalPrompt":{"properties":{"id":{"type":"string","title":"Id"},"content":{"type":"string","title":"Content"},"moon_phase":{"$ref":"#/components/schemas/MoonPhase"},"moon_sign":{"$ref":"#/components/schemas/MoonSign"},"category":{"type":"string","title":"Category"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","content","category","created_at","updated_at"],"title":"JournalPrompt","description":"Model for a journal prompt."},"JournalStats":{"properties":{"total_entries":{"type":"integer","title":"Total Entries"},"entries_by_moon_phase":{"additionalProperties":{"type":"integer"},"type":"object","title":"Entries By Moon Phase"},"entries_by_moon_sign":{"additionalProperties":{"type":"integer"},"type":"object","title":"Entries By Moon Sign"},"mood_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Mood Distribution"},"energy_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Energy Distribution"},"ritual_distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Ritual Distribution"},"average_entry_length":{"type":"number","title":"Average Entry Length"},"most_common_insights":{"items":{"type":"string"},"type":"array","title":"Most Common Insights"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["total_entries","entries_by_moon_phase","entries_by_moon_sign","mood_distribution","energy_distribution","ritual_distribution","average_entry_length","most_common_insights","created_at","updated_at"],"title":"JournalStats","description":"Model for journal statistics."},"KPAnalysisRequest":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone"},"planet_positions":{"additionalProperties":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0},"type":"object","title":"Planet Positions","description":"Dictionary of planet names to longitudes","example":{"Sun":45.5,"Moon":120.3,"Mars":200.1,"Mercury":60.0,"Jupiter":280.5,"Venus":150.2,"Saturn":310.0,"Rahu":85.0,"Ketu":265.0}},"house_cusps":{"items":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0},"type":"array","maxItems":12,"minItems":12,"title":"House Cusps","description":"List of 12 house cusp longitudes"},"query_time":{"type":"string","format":"date-time","title":"Query Time","description":"Time for ruling planets calculation"}},"type":"object","required":["planet_positions","house_cusps"],"title":"KPAnalysisRequest"},"KPDailyTimingRequest":{"properties":{"query_time":{"type":"string","format":"date-time","title":"Query Time","description":"Moment the question is asked: an instant with an offset, or the wall-clock time at the query place"},"latitude":{"type":"number","maximum":66.56,"minimum":-66.56,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","description":"Derived from latitude/longitude; any value sent is replaced"},"event_type":{"type":"string","enum":["marriage","career","children","wealth","foreign_travel","education","property","health","divorce","litigation","job_change"],"title":"Event Type","description":"KP event type, e.g. marriage, career"},"horary_number":{"type":"integer","maximum":249.0,"minimum":1.0,"title":"Horary Number"},"include_timing":{"type":"boolean","title":"Include Timing","default":false},"school":{"type":"string","enum":["classic","extended"],"title":"School","description":"Event-house school: classic | extended","default":"classic"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Must be Krishnamurti if provided — KP rejects other frames"},"start_date":{"type":"string","format":"date","title":"Start Date"},"end_date":{"type":"string","format":"date","title":"End Date"},"birth_details":{"$ref":"#/components/schemas/KPSignificatorsTableRequest"}},"type":"object","required":["query_time","latitude","longitude","timezone","event_type","start_date","end_date"],"title":"KPDailyTimingRequest"},"KPHoraryRequest":{"properties":{"query_time":{"type":"string","format":"date-time","title":"Query Time","description":"Moment the question is asked: an instant with an offset, or the wall-clock time at the query place"},"latitude":{"type":"number","maximum":66.56,"minimum":-66.56,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","description":"Derived from latitude/longitude; any value sent is replaced"},"event_type":{"type":"string","enum":["marriage","career","children","wealth","foreign_travel","education","property","health","divorce","litigation","job_change"],"title":"Event Type","description":"KP event type, e.g. marriage, career"},"horary_number":{"type":"integer","maximum":249.0,"minimum":1.0,"title":"Horary Number"},"include_timing":{"type":"boolean","title":"Include Timing","default":false},"school":{"type":"string","enum":["classic","extended"],"title":"School","description":"Event-house school: classic | extended","default":"classic"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Must be Krishnamurti if provided — KP rejects other frames"}},"type":"object","required":["query_time","latitude","longitude","timezone","event_type"],"title":"KPHoraryRequest"},"KPLifeEvent":{"properties":{"event_type":{"type":"string","enum":["marriage","career","children","wealth","foreign_travel","education","property","health","divorce","litigation","job_change"],"title":"Event Type","description":"KP event type, e.g. marriage"},"event_date":{"type":"string","format":"date","title":"Event Date","description":"When the event occurred"},"label":{"type":"string","title":"Label","description":"Optional label, e.g. wedding"}},"type":"object","required":["event_type","event_date"],"title":"KPLifeEvent"},"KPNowRequest":{"properties":{"latitude":{"type":"number","maximum":66.56,"minimum":-66.56,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","description":"Derived from latitude/longitude; any value sent is replaced"},"query_time":{"type":"string","format":"date-time","title":"Query Time","description":"Instant to cast for (with an offset, or the place's wall clock); now if omitted"}},"type":"object","required":["latitude","longitude"],"title":"KPNowRequest","description":"The KP chart and ruling planets for one place, at one instant (now by default)."},"KPRectifyRequest":{"properties":{"date_of_birth":{"type":"string","format":"date","title":"Date Of Birth","description":"Known birth date"},"latitude":{"type":"number","maximum":66.56,"minimum":-66.56,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone"},"window_start":{"type":"string","title":"Window Start","description":"Earliest possible birth time HH:MM"},"window_end":{"type":"string","title":"Window End","description":"Latest possible birth time HH:MM"},"interval_minutes":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Interval Minutes","default":2},"query_time":{"type":"string","format":"date-time","title":"Query Time","description":"Known event/query moment whose ruling planets guide rectification"},"query_latitude":{"type":"number","maximum":66.56,"minimum":-66.56,"title":"Query Latitude"},"query_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Query Longitude"},"event_types":{"items":{"type":"string","enum":["marriage","career","children","wealth","foreign_travel","education","property","health","divorce","litigation","job_change"]},"type":"array","maxItems":8,"uniqueItems":true,"title":"Event Types","description":"Optional undated natal events to score (marriage, career, …)"},"life_events":{"items":{"$ref":"#/components/schemas/KPLifeEvent"},"type":"array","maxItems":12,"title":"Life Events","description":"Dated life events for history-based rectification (max 12)"},"limit":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Limit","default":15},"school":{"type":"string","enum":["classic","extended"],"title":"School","description":"Event-house school: classic | extended","default":"classic"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Must be Krishnamurti if provided — KP rejects other frames"}},"type":"object","required":["date_of_birth","latitude","longitude","window_start","window_end"],"title":"KPRectifyRequest"},"KPSignificatorsTableRequest":{"properties":{"date_of_birth":{"type":"string","format":"date","title":"Date Of Birth"},"time_of_birth":{"type":"string","title":"Time Of Birth","description":"Known birth time; midnight is valid"},"latitude":{"type":"number","maximum":66.56,"minimum":-66.56,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Must be Krishnamurti if provided — KP rejects other frames"}},"type":"object","required":["date_of_birth","time_of_birth","latitude","longitude"],"title":"KPSignificatorsTableRequest"},"KalaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"nathonata_bala":{"$ref":"#/components/schemas/NathonataBala"},"paksha_bala":{"$ref":"#/components/schemas/PakshaBala"},"tribhaga_bala":{"$ref":"#/components/schemas/TribhagaBala"},"abda_bala":{"$ref":"#/components/schemas/AbdaBala"},"masa_bala":{"$ref":"#/components/schemas/MasaBala"},"vara_bala":{"$ref":"#/components/schemas/VaraBala"},"hora_bala":{"$ref":"#/components/schemas/HoraBala"},"ayana_bala":{"$ref":"#/components/schemas/AyanaBala"},"yuddha_bala":{"$ref":"#/components/schemas/YuddhaBala"},"total_strength_virupas":{"type":"number","title":"Total Strength Virupas"},"total_strength_rupas":{"type":"number","title":"Total Strength Rupas"}},"type":"object","required":["planet","nathonata_bala","paksha_bala","tribhaga_bala","abda_bala","masa_bala","vara_bala","hora_bala","ayana_bala","yuddha_bala","total_strength_virupas","total_strength_rupas"],"title":"KalaBala","description":"Complete Kala Bala (Temporal Strength)."},"KalaBalaBrekdown":{"properties":{"natonnata_bala":{"type":"number","minimum":0.0,"title":"Natonnata Bala","description":"Day/Night strength"},"paksha_bala":{"type":"number","minimum":0.0,"title":"Paksha Bala","description":"Lunar phase strength"},"tribhaga_bala":{"type":"number","minimum":0.0,"title":"Tribhaga Bala","description":"Day/Night third strength"},"abda_bala":{"type":"number","minimum":0.0,"title":"Abda Bala","description":"Astrological year-lord strength","default":0},"masa_bala":{"type":"number","minimum":0.0,"title":"Masa Bala","description":"Astrological month-lord strength","default":0},"vara_bala":{"type":"number","minimum":0.0,"title":"Vara Bala","description":"Weekday lord strength"},"hora_bala":{"type":"number","minimum":0.0,"title":"Hora Bala","description":"Planetary hour strength"},"ayana_bala":{"type":"number","minimum":0.0,"title":"Ayana Bala","description":"Declination strength"},"yuddha_bala":{"type":"number","title":"Yuddha Bala","description":"Planetary-war adjustment","default":0},"total":{"type":"number","minimum":0.0,"title":"Total","description":"Total Kala Bala"}},"type":"object","required":["natonnata_bala","paksha_bala","tribhaga_bala","vara_bala","hora_bala","ayana_bala","total"],"title":"KalaBalaBrekdown","description":"Breakdown of Kala Bala (Temporal Strength) components.\n\nKala Bala measures strength from time-based factors.\n\nAttributes:\n natonnata_bala: Day/Night strength\n paksha_bala: Lunar phase strength\n tribhaga_bala: Day/Night third strength\n varsha_bala: Year lord strength\n masa_bala: Month lord strength\n vara_bala: Weekday lord strength\n hora_bala: Planetary hour strength\n ayana_bala: Declination strength\n total: Total Kala Bala"},"Karakamsha":{"properties":{"sign":{"type":"string","title":"Sign","description":"Karakamsha sign"},"sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Index","description":"Sign index"},"atmakaraka":{"type":"string","title":"Atmakaraka","description":"Atmakaraka planet"},"planets_in_karakamsha":{"items":{"type":"string"},"type":"array","title":"Planets In Karakamsha"},"swamsha":{"type":"string","title":"Swamsha","description":"Swamsha (Karakamsha in D9)","default":""},"soul_purpose":{"type":"string","title":"Soul Purpose","description":"Soul's purpose based on Karakamsha"},"spiritual_path":{"type":"string","title":"Spiritual Path","description":"Spiritual path indicated"},"career_from_karakamsha":{"items":{"type":"string"},"type":"array","title":"Career From Karakamsha","description":"Career indications"}},"type":"object","required":["sign","sign_index","atmakaraka","soul_purpose","spiritual_path"],"title":"Karakamsha","description":"Karakamsha analysis (Navamsa of Atmakaraka)."},"Karana":{"properties":{"number":{"type":"integer","maximum":11.0,"minimum":1.0,"title":"Number","description":"Karana number (1-11)"},"name":{"type":"string","title":"Name","description":"Name of the Karana"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Start time of the Karana"},"end_time":{"type":"string","format":"date-time","title":"End Time","description":"End time of the Karana"},"transition_time":{"type":"string","format":"date-time","title":"Transition Time","description":"Alias of end_time"},"spans":{"items":{"$ref":"#/components/schemas/LimbSpan"},"type":"array","title":"Spans","description":"Every karana touching the sunrise-to-sunrise day, in order"}},"type":"object","required":["number","name","start_time","end_time"],"title":"Karana","description":"Schema for Karana (half of Tithi) information."},"KendraBala":{"properties":{"planet":{"type":"string","title":"Planet"},"house":{"type":"integer","title":"House"},"is_kendra":{"type":"boolean","title":"Is Kendra"},"is_panapara":{"type":"boolean","title":"Is Panapara"},"is_apoklima":{"type":"boolean","title":"Is Apoklima"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","house","is_kendra","is_panapara","is_apoklima","strength_virupas"],"title":"KendraBala","description":"Angular house (1,4,7,10) strength."},"KundaliChart":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"ascendant":{"$ref":"#/components/schemas/HousePosition"},"planets":{"items":{"$ref":"#/components/schemas/app__schemas__kundali__PlanetPosition"},"type":"array","title":"Planets"},"houses":{"items":{"$ref":"#/components/schemas/HousePosition"},"type":"array","title":"Houses"},"current_dasha":{"$ref":"#/components/schemas/app__schemas__kundali__DashaPeriod"},"next_dasha":{"$ref":"#/components/schemas/app__schemas__kundali__DashaPeriod"},"manglik_dosha":{"type":"boolean","title":"Manglik Dosha"},"manglik_references":{"items":{"type":"string"},"type":"array","title":"Manglik References","default":[]},"kaal_sarp_dosha":{"type":"boolean","title":"Kaal Sarp Dosha"},"pitru_dosha":{"type":"boolean","title":"Pitru Dosha"}},"type":"object","required":["birth_details","ascendant","planets","houses","manglik_dosha","kaal_sarp_dosha","pitru_dosha"],"title":"KundaliChart"},"KundaliMatch":{"properties":{"person1":{"$ref":"#/components/schemas/KundaliChart"},"person2":{"$ref":"#/components/schemas/KundaliChart"},"guna_milan":{"$ref":"#/components/schemas/GunaMilan"},"score":{"type":"number","title":"Score","default":0.0},"is_compatible":{"type":"boolean","title":"Is Compatible","default":false},"aspects":{"items":{"type":"object"},"type":"array","title":"Aspects","default":[]},"manglik_compatibility":{"type":"boolean","title":"Manglik Compatibility"},"kaal_sarp_compatibility":{"type":"boolean","title":"Kaal Sarp Compatibility"},"overall_compatibility":{"type":"string","title":"Overall Compatibility"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["person1","person2","guna_milan","manglik_compatibility","kaal_sarp_compatibility","overall_compatibility","recommendations"],"title":"KundaliMatch"},"KundliSnapshotRequest":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"birth_date":{"type":"string","format":"date-time","title":"Birth Date"},"timezone":{"type":"string","maxLength":64,"minLength":1,"title":"Timezone"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"place_label":{"type":"string","maxLength":160,"minLength":1,"title":"Place Label"},"ayanamsa":{"type":"string","maxLength":32,"title":"Ayanamsa","default":"Lahiri"},"node_type":{"type":"string","enum":["mean","true"],"title":"Node Type","default":"mean"}},"type":"object","required":["name","birth_date","timezone","latitude","longitude","place_label"],"title":"KundliSnapshotRequest"},"KundliSnapshotResponse":{"properties":{"html":{"type":"string","title":"Html"},"pdf_base64":{"type":"string","title":"Pdf Base64"},"filename":{"type":"string","title":"Filename"},"reference":{"type":"string","title":"Reference"},"as_of":{"type":"string","title":"As Of"},"missing":{"items":{"type":"string"},"type":"array","title":"Missing"}},"type":"object","required":["html","filename","reference","as_of","missing"],"title":"KundliSnapshotResponse"},"LagnaResponse":{"properties":{"lagna_type":{"type":"string","title":"Lagna Type"},"longitude":{"type":"number","title":"Longitude"},"sign":{"type":"string","title":"Sign"},"sign_index":{"type":"integer","title":"Sign Index"},"degrees_in_sign":{"type":"number","title":"Degrees In Sign"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_pada":{"type":"integer","title":"Nakshatra Pada"},"significance":{"type":"string","title":"Significance"},"calculation_method":{"type":"string","title":"Calculation Method"}},"type":"object","required":["lagna_type","longitude","sign","sign_index","degrees_in_sign","nakshatra","nakshatra_pada","significance","calculation_method"],"title":"LagnaResponse","description":"Response model for a single lagna."},"LibrarySummaryEntry":{"properties":{"text_id":{"type":"string","title":"Text Id"},"last_chapter":{"type":"integer","title":"Last Chapter"},"last_position":{"type":"number","title":"Last Position"},"last_read_at":{"type":"string","title":"Last Read At"},"bookmark_count":{"type":"integer","title":"Bookmark Count"},"highlight_count":{"type":"integer","title":"Highlight Count"}},"type":"object","required":["text_id","last_chapter","last_position","bookmark_count","highlight_count"],"title":"LibrarySummaryEntry"},"LifeArea":{"type":"string","enum":["career","finance","relationships","health","education","family","spirituality","travel","legal","property"],"title":"LifeArea","description":"Life areas for predictions."},"LifeEvent":{"properties":{"event_type":{"$ref":"#/components/schemas/LifeEventType"},"event_date":{"type":"string","format":"date","title":"Event Date"},"event_time":{"type":"string","title":"Event Time","description":"Approximate time (HH:MM) if known"},"description":{"type":"string","title":"Description"},"certainty":{"type":"string","title":"Certainty","description":"exact, approximate, or uncertain","default":"exact"},"impact":{"type":"string","title":"Impact","description":"positive, negative, or neutral","default":"neutral"},"related_person":{"type":"string","title":"Related Person","description":"Related person if applicable (spouse, child, parent)"}},"type":"object","required":["event_type","event_date"],"title":"LifeEvent","description":"A significant life event used for birth time rectification.\n\nAttributes:\n event_type: Category of the life event\n event_date: Date when the event occurred\n event_time: Approximate time if known (helps narrow rectification)\n description: Brief description of the event\n certainty: How certain is the date (exact, approximate, uncertain)\n impact: Positive, negative, or neutral impact\n related_person: If event involves another person (spouse, child, etc.)"},"LifeEventType":{"type":"string","enum":["marriage","divorce","child_birth","parent_death","sibling_death","spouse_death","job_start","job_loss","promotion","business_start","major_illness","accident","surgery","property_purchase","property_sale","vehicle_purchase","education_start","graduation","foreign_travel","relocation","legal_case","award_recognition","inheritance","major_financial_gain","major_financial_loss","spiritual_initiation","other"],"title":"LifeEventType","description":"Types of significant life events used for rectification."},"LifeProblem":{"type":"string","enum":["career_obstacles","financial_issues","marriage_delay","relationship_problems","health_issues","education_problems","legal_troubles","debt_burden","childlessness","mental_stress","spiritual_growth","general_prosperity"],"title":"LifeProblem","description":"Life problems that remedies address."},"LifeStage":{"type":"string","enum":["child","teenager","young_adult","adult","middle_age","senior","pregnant","postpartum","menstruating"],"title":"LifeStage","description":"Life stage for appropriate remedies."},"LifestyleRecommendation":{"properties":{"dietary_remedies":{"$ref":"#/components/schemas/DietaryRemedy"},"behavioral_remedies":{"$ref":"#/components/schemas/BehavioralRemedy"},"exercise_recommendations":{"items":{"type":"string"},"type":"array","title":"Exercise Recommendations"},"sleep_guidelines":{"type":"string","title":"Sleep Guidelines"},"daily_routine":{"type":"string","title":"Daily Routine"}},"type":"object","required":["dietary_remedies","behavioral_remedies","exercise_recommendations","sleep_guidelines","daily_routine"],"title":"LifestyleRecommendation","description":"Complete lifestyle recommendation set."},"LimbSpan":{"properties":{"number":{"type":"integer","minimum":1.0,"title":"Number","description":"One-based number of the limb in this span"},"name":{"type":"string","title":"Name","description":"Name of the limb in this span"},"paksha":{"type":"string","title":"Paksha","description":"Shukla or Krishna; set on tithi spans only, because a tithi name alone is ambiguous -- there is a Dwitiya in each half of the month"},"start":{"type":"string","format":"date-time","title":"Start","description":"When this span began; may precede the day's sunrise"},"end":{"type":"string","format":"date-time","title":"End","description":"When this span ends; may follow the next sunrise"}},"type":"object","required":["number","name","start","end"],"title":"LimbSpan","description":"One span of one limb, the way an almanac prints it: \"Pushya upto 13:25\".\n\nA Hindu day normally carries two tithis, two nakshatras, two yogas and three\nor four karanas. The singular ``tithi``/``nakshatra``/``yoga``/``karana``\nobjects publish only the one in force at sunrise, so until this existed the\nresponse said when the current limb died and never what replaced it -- and hid\nthree karanas out of four.\n\n**Half-open, and unclipped.** A span is ``[start, end)`` and appears in the\nlist for every Hindu day it touches, so the first entry's ``start`` is\nnormally *before* that day's sunrise and the last entry's ``end`` after the\nnext one. Clipping either end would misstate the limb's real extent, and its\nextent is what its ghatis are measured against -- ``_calculate_nakshatra_windows``\ndivides exactly this span by sixty to place Varjyam and Amrit Kaal. A client\nthat wants the day's own portion intersects with sunrise and next sunrise\nitself; it cannot recover the true span from a clipped one.\n\n``end_time``/``ending_time``/``transition_time`` are three spellings of one\ninstant on the singular limbs, kept because clients already read all three.\nThey are deliberately not repeated here: one spelling in new surface area."},"LocalCircumstancesOut":{"properties":{"maximum":{"type":"string","format":"date-time","title":"Maximum","description":"Greatest coverage as seen from this place, UTC"},"first_contact":{"type":"string","format":"date-time","title":"First Contact","description":"The graha touches the Moon's limb — the disappearance begins"},"second_contact":{"type":"string","format":"date-time","title":"Second Contact"},"third_contact":{"type":"string","format":"date-time","title":"Third Contact","description":"The reappearance begins at the far limb"},"fourth_contact":{"type":"string","format":"date-time","title":"Fourth Contact"},"duration_minutes":{"type":"number","title":"Duration Minutes","description":"First to fourth contact — the graha's time behind the Moon"},"body_altitude":{"type":"number","title":"Body Altitude","description":"True altitude of the graha at maximum, degrees"},"sun_altitude":{"type":"number","title":"Sun Altitude","description":"The Sun's own altitude at maximum. Negative is a dark sky"},"sky":{"$ref":"#/components/schemas/SkyBand"},"contacts_visible":{"items":{"type":"string"},"type":"array","title":"Contacts Visible","description":"Which of the four contacts fall above this horizon; the rest happen unseen"},"maximum_visible":{"type":"boolean","title":"Maximum Visible"},"magnitude":{"type":"number","title":"Magnitude","description":"Fraction of the graha's diameter covered"},"obscuration":{"type":"number","title":"Obscuration","description":"Fraction of the graha's disc covered"},"separation_degrees":{"type":"number","title":"Separation Degrees","description":"Moon centre to graha centre at maximum"}},"type":"object","required":["maximum","body_altitude","sun_altitude","sky","maximum_visible","magnitude","obscuration","separation_degrees"],"title":"LocalCircumstancesOut"},"LocalEclipsePersonalRequest":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Observer latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Observer longitude"},"timezone":{"type":"string","title":"Timezone","description":"IANA zone every returned time is stamped in"},"category":{"$ref":"#/components/schemas/EclipseCategory"},"visible_only":{"type":"boolean","title":"Visible Only","default":false},"birth_date":{"type":"string","title":"Birth Date","description":"Birth date/time, 'YYYY-MM-DD HH:MM' in the birth place's own civil time. A date alone is accepted and read as midnight, which makes the lagna and every bhava counted from it meaningless -- send the time."},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","description":"IANA timezone of the BIRTH place, which is often not the observer's","default":"UTC"},"rashi":{"type":"string","title":"Rashi","description":"Optional janma rashi for the rashi-level block; derived from the chart when omitted"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal frame for both the eclipse and the chart","default":"Lahiri"},"language":{"type":"string","pattern":"^(en|hi)$","title":"Language","default":"en"},"check_natal_dosha":{"type":"boolean","title":"Check Natal Dosha","description":"Also establish whether the reader was born inside an eclipse visible from their birthplace. Costs a two-day eclipse search; when false, `natal_grahan_dosha` is null rather than false.","default":true}},"type":"object","required":["latitude","longitude","timezone","birth_date","birth_latitude","birth_longitude"],"title":"LocalEclipsePersonalRequest","description":"The next eclipse for one place AND one birth chart.\n\nA POST, not a GET, because of the body it carries. Birth date, birth time and\nbirth coordinates identify a person about as precisely as anything short of a\nname, and a query string is the one part of an HTTP request that is written to\naccess logs, kept in browser history and forwarded in `Referer` headers by\ndefault. The place-only reading stays a cacheable GET; adding a chart to it\nmoves it here.\n\n`rashi` is optional and is NOT required to get a reading: the janma rashi is\nread off the natal Moon, which is more reliable than a reader's own answer.\nSupply it only to have the rashi-level `personal` block computed for a sign\nthe reader has explicitly chosen -- for instance a reader who follows a\ndifferent tradition's spelling of their sign than this service derives."},"LocalEclipseReport":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"timezone":{"type":"string","title":"Timezone"},"eclipse":{"$ref":"#/components/schemas/Eclipse"},"is_visible":{"type":"boolean","title":"Is Visible"},"visibility":{"$ref":"#/components/schemas/EclipseVisibility"},"sutak_start":{"type":"string","format":"date-time","title":"Sutak Start"},"sutak_end":{"type":"string","format":"date-time","title":"Sutak End"},"sutak_duration_hours":{"type":"number","title":"Sutak Duration Hours"},"restrictions":{"items":{"type":"string"},"type":"array","title":"Restrictions"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"},"mantras":{"items":{"type":"string"},"type":"array","title":"Mantras"},"ayanamsa":{"type":"string","title":"Ayanamsa","default":"Lahiri"},"personal":{"$ref":"#/components/schemas/EclipsePersonalReading"},"individual":{"$ref":"#/components/schemas/EclipseNatalReading"}},"type":"object","required":["latitude","longitude","timezone","eclipse","is_visible","visibility"],"title":"LocalEclipseReport","description":"One eclipse as it applies at one place.\n\nThe answer to the only question a reader actually asks about a grahan: can I\nsee it from here, when does it touch and leave *here*, and does sutak apply\nto me. Assembled server-side because those three used to be three calls\n(`/next`, `/visibility`, `/sutak`), and a client stitching them together\ncould pair a local maximum with a global sutak window without noticing.\n\n`is_visible` false is a complete answer, not a degraded one: the sutak fields\nare then None because there is no observance for a grahan that cannot be seen\nhere (adrshya-grahane na sutakam), and `restrictions` is empty for the same\nreason. Render the absence as \"no sutak here\", never as an unknown time."},"LocationBasedPanchangRequest":{"properties":{"date":{"anyOf":[{"type":"string"},{"type":"string","format":"date-time"}],"title":"Date","description":"Date and time for Panchang calculation"},"use_ip_geolocation":{"type":"boolean","title":"Use Ip Geolocation","description":"Whether to use IP-based geolocation","default":true},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Latitude of the location"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Longitude of the location"},"timezone":{"type":"string","title":"Timezone","description":"Timezone of the location"},"calendar_system":{"type":"string","title":"Calendar System","description":"Preferred Hindu calendar framing","default":"vikram"},"lunar_month_system":{"type":"string","title":"Lunar Month System","description":"Amanta or Purnimanta lunar month convention"}},"type":"object","required":["date"],"title":"LocationBasedPanchangRequest","description":"Request model for location-based Panchang calculations.\n\nAttributes:\n date: Date and time for which to calculate Panchang\n use_ip_geolocation: Whether to use IP-based geolocation (default: True)\n latitude: Latitude of the location (-90 to 90), required if use_ip_geolocation is False\n longitude: Longitude of the location (-180 to 180), required if use_ip_geolocation is False\n timezone: Timezone of the location, will be auto-detected if not provided"},"LostItemAnalysis":{"properties":{"likely_direction":{"type":"string","title":"Likely Direction"},"distance":{"type":"string","title":"Distance"},"location_type":{"type":"string","title":"Location Type"},"recoverable":{"type":"boolean","title":"Recoverable"},"recovery_timing":{"type":"string","title":"Recovery Timing"},"additional_clues":{"items":{"type":"string"},"type":"array","title":"Additional Clues"}},"type":"object","required":["likely_direction","distance","location_type","recoverable","additional_clues"],"title":"LostItemAnalysis","description":"Special analysis for lost item queries.\n\nAttributes:\n likely_direction: Direction where item may be found\n distance: Estimated distance (near, far, etc.)\n location_type: Type of location (home, public, etc.)\n recoverable: Whether item is likely to be recovered\n recovery_timing: When item might be found\n additional_clues: Additional location clues"},"LunarPhaseInfo":{"properties":{"is_amavasya":{"type":"boolean","title":"Is Amavasya","description":"Whether it's Amavasya (new moon)"},"is_purnima":{"type":"boolean","title":"Is Purnima","description":"Whether it's Purnima (full moon)"},"is_shukla_paksha":{"type":"boolean","title":"Is Shukla Paksha","description":"Whether it's Shukla Paksha (bright half)"},"is_krishna_paksha":{"type":"boolean","title":"Is Krishna Paksha","description":"Whether it's Krishna Paksha (dark half)"}},"type":"object","required":["is_amavasya","is_purnima","is_shukla_paksha","is_krishna_paksha"],"title":"LunarPhaseInfo","description":"Information about the lunar phase.\n\nAttributes:\n is_amavasya: Whether it's Amavasya (new moon)\n is_purnima: Whether it's Purnima (full moon)\n is_shukla_paksha: Whether it's Shukla Paksha (bright half)\n is_krishna_paksha: Whether it's Krishna Paksha (dark half)"},"MajorTransit":{"properties":{"planet":{"type":"string","title":"Planet"},"from_sign":{"type":"string","title":"From Sign"},"to_sign":{"type":"string","title":"To Sign"},"transit_date":{"type":"string","format":"date-time","title":"Transit Date"},"house_from_moon":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House From Moon"},"transit_nature":{"$ref":"#/components/schemas/TransitNature"},"duration_months":{"type":"integer","title":"Duration Months"},"significance":{"type":"string","title":"Significance"},"predictions":{"items":{"type":"string"},"type":"array","title":"Predictions"},"favorable_activities":{"items":{"type":"string"},"type":"array","title":"Favorable Activities"},"unfavorable_activities":{"items":{"type":"string"},"type":"array","title":"Unfavorable Activities"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"}},"type":"object","required":["planet","from_sign","to_sign","transit_date","house_from_moon","transit_nature","duration_months","significance","predictions","favorable_activities","unfavorable_activities","remedies"],"title":"MajorTransit","description":"Major planetary transit (Jupiter, Saturn, Rahu/Ketu)"},"MalaDetails":{"properties":{"mala_type":{"$ref":"#/components/schemas/MalaType"},"name":{"type":"string","title":"Name"},"ruling_planet":{"type":"string","title":"Ruling Planet"},"material":{"type":"string","title":"Material"},"bead_count":{"type":"integer","title":"Bead Count","default":108},"purpose":{"type":"string","title":"Purpose"},"price_range":{"type":"string","title":"Price Range"}},"type":"object","required":["mala_type","name","ruling_planet","material","purpose","price_range"],"title":"MalaDetails","description":"Details of a sacred mala."},"MalaRecommendation":{"properties":{"primary_mala":{"$ref":"#/components/schemas/MalaRemedy"},"supporting_malas":{"items":{"$ref":"#/components/schemas/MalaRemedy"},"type":"array","title":"Supporting Malas"},"wearing_guide":{"type":"string","title":"Wearing Guide"}},"type":"object","required":["primary_mala","supporting_malas","wearing_guide"],"title":"MalaRecommendation","description":"Complete mala recommendation set."},"MalaRemedy":{"properties":{"mala":{"$ref":"#/components/schemas/MalaDetails"},"reason":{"type":"string","title":"Reason"},"problem_addressed":{"type":"string","title":"Problem Addressed"},"shastra_note":{"type":"string","title":"Shastra Note"},"wearing_method":{"type":"string","title":"Wearing Method"},"activation_mantra":{"type":"string","title":"Activation Mantra"},"mantra_count":{"type":"integer","title":"Mantra Count"},"best_day_to_wear":{"type":"string","title":"Best Day To Wear"},"care_instructions":{"items":{"type":"string"},"type":"array","title":"Care Instructions"},"do_not_combine_with":{"items":{"type":"string"},"type":"array","title":"Do Not Combine With","default":[]},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["mala","reason","problem_addressed","shastra_note","wearing_method","activation_mantra","mantra_count","best_day_to_wear","care_instructions","effectiveness_score"],"title":"MalaRemedy","description":"Mala wearing / japa recommendation."},"MalaType":{"type":"string","enum":["rudraksha","karunguli","spatika","tulasi","sandalwood","lotus_seed"],"title":"MalaType","description":"Sacred mala / bead types for planetary upayas."},"ManglikDoshaAnalysis":{"properties":{"is_manglik":{"type":"boolean","title":"Is Manglik"},"level":{"$ref":"#/components/schemas/ManglikLevel"},"mars_house_from_lagna":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Mars House From Lagna"},"mars_house_from_moon":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Mars House From Moon"},"mars_house_from_venus":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Mars House From Venus"},"affected_from":{"items":{"type":"string"},"type":"array","title":"Affected From","description":"Which references show Manglik (Lagna, Moon, Venus)"},"dosha_intensity_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Dosha Intensity Score"},"cancellation_rules_applicable":{"items":{"type":"string"},"type":"array","title":"Cancellation Rules Applicable"},"is_cancelled":{"type":"boolean","title":"Is Cancelled","default":false},"cancellation_explanation":{"type":"string","title":"Cancellation Explanation"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"},"compatibility_note":{"type":"string","title":"Compatibility Note"}},"type":"object","required":["is_manglik","level","mars_house_from_lagna","mars_house_from_moon","mars_house_from_venus","dosha_intensity_score","compatibility_note"],"title":"ManglikDoshaAnalysis","description":"Comprehensive Manglik Dosha analysis.\n\nMars in houses 1, 2, 4, 7, 8, or 12 from Lagna, Moon, or Venus\ncreates Manglik Dosha.\n\nAttributes:\n is_manglik: Whether Manglik dosha is present\n level: Intensity level of the dosha\n mars_houses: Houses where Mars is placed (from Lagna, Moon, Venus)\n affected_from: Which reference points show dosha (Lagna, Moon, Venus)\n cancellation_rules: Rules that might cancel the dosha\n is_cancelled: Whether dosha is effectively cancelled\n remedies: Suggested remedies\n compatibility_note: Note about matching with partner"},"ManglikLevel":{"type":"string","enum":["none","low","moderate","high","severe"],"title":"ManglikLevel","description":"Levels of Manglik dosha intensity."},"MantraDetails":{"properties":{"mantra_text":{"type":"string","title":"Mantra Text"},"mantra_meaning":{"type":"string","title":"Mantra Meaning"},"devanagari":{"type":"string","title":"Devanagari"},"transliteration":{"type":"string","title":"Transliteration"},"source":{"type":"string","title":"Source"},"deity":{"type":"string","title":"Deity"},"ruling_planet":{"type":"string","title":"Ruling Planet"}},"type":"object","required":["mantra_text","mantra_meaning","source","deity"],"title":"MantraDetails","description":"Details of a mantra."},"MantraItem":{"properties":{"title":{"type":"string","title":"Title"},"deity":{"type":"string","title":"Deity"},"planet":{"type":"string","title":"Planet"},"mantra_text":{"type":"string","title":"Mantra Text"},"chant_count":{"type":"integer","title":"Chant Count"},"video_url":{"type":"string","title":"Video Url"},"audio_url":{"type":"string","title":"Audio Url"},"explanation":{"type":"string","title":"Explanation"},"timing_suggestion":{"type":"string","title":"Timing Suggestion"}},"type":"object","required":["title","deity","mantra_text","chant_count"],"title":"MantraItem"},"MantraRecommendation":{"properties":{"primary_mantra":{"$ref":"#/components/schemas/MantraRemedy"},"supporting_mantras":{"items":{"$ref":"#/components/schemas/MantraRemedy"},"type":"array","title":"Supporting Mantras"},"daily_practice_schedule":{"type":"string","title":"Daily Practice Schedule"},"expected_results_timeline":{"type":"string","title":"Expected Results Timeline"}},"type":"object","required":["primary_mantra","supporting_mantras","daily_practice_schedule","expected_results_timeline"],"title":"MantraRecommendation","description":"Complete mantra recommendation set."},"MantraRemedy":{"properties":{"mantra":{"$ref":"#/components/schemas/MantraDetails"},"reason":{"type":"string","title":"Reason"},"problem_addressed":{"type":"string","title":"Problem Addressed"},"minimum_count":{"type":"integer","title":"Minimum Count"},"recommended_count":{"type":"integer","title":"Recommended Count"},"total_count_for_siddhi":{"type":"integer","title":"Total Count For Siddhi"},"best_time":{"type":"string","title":"Best Time"},"best_days":{"items":{"type":"string"},"type":"array","title":"Best Days"},"best_nakshatra":{"type":"string","title":"Best Nakshatra"},"start_day":{"type":"string","title":"Start Day"},"direction_to_face":{"type":"string","title":"Direction To Face"},"asana_recommended":{"type":"string","title":"Asana Recommended"},"mala_type":{"type":"string","title":"Mala Type"},"mala_beads":{"type":"integer","title":"Mala Beads"},"dietary_restrictions":{"items":{"type":"string"},"type":"array","title":"Dietary Restrictions"},"duration_days":{"type":"integer","title":"Duration Days"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["mantra","reason","problem_addressed","minimum_count","recommended_count","total_count_for_siddhi","best_time","best_days","start_day","direction_to_face","asana_recommended","mala_type","mala_beads","dietary_restrictions","duration_days","effectiveness_score"],"title":"MantraRemedy","description":"Mantra prescription."},"MantraResponse":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"mantras":{"items":{"$ref":"#/components/schemas/MantraItem"},"type":"array","title":"Mantras"},"devotional_message":{"type":"string","title":"Devotional Message"}},"type":"object","required":["date","mantras"],"title":"MantraResponse"},"MarriageAnalysisResponse":{"properties":{"upapada_lagna":{"allOf":[{"$ref":"#/components/schemas/UpaPadaLagna"}],"title":"Upapada Lagna","description":"Upapada analysis"},"darakaraka":{"allOf":[{"$ref":"#/components/schemas/app__schemas__jaimini__JaiminiKaraka"}],"title":"Darakaraka","description":"Darakaraka analysis"},"seventh_house_analysis":{"type":"object","title":"Seventh House Analysis","description":"7th house from various lagnas"},"spouse_characteristics":{"items":{"type":"string"},"type":"array","title":"Spouse Characteristics"},"marriage_timing_indicators":{"items":{"type":"string"},"type":"array","title":"Marriage Timing Indicators"},"compatibility_factors":{"items":{"type":"string"},"type":"array","title":"Compatibility Factors"},"potential_challenges":{"items":{"type":"string"},"type":"array","title":"Potential Challenges"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"jaimini"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["upapada_lagna","darakaraka","seventh_house_analysis"],"title":"MarriageAnalysisResponse","description":"Jaimini marriage analysis using Upapada and Darakaraka."},"MasaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"is_month_lord":{"type":"boolean","title":"Is Month Lord"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","is_month_lord","strength_virupas"],"title":"MasaBala","description":"Month lord strength."},"MatchingReportRequest":{"properties":{"ayanamsa":{"type":"string","title":"Ayanamsa","default":"Lahiri"},"bride_birth_datetime":{"type":"string","format":"date-time","title":"Bride Birth Datetime"},"bride_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Bride Latitude"},"bride_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Bride Longitude"},"bride_timezone":{"type":"string","title":"Bride Timezone","default":"UTC"},"groom_birth_datetime":{"type":"string","format":"date-time","title":"Groom Birth Datetime"},"groom_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Groom Latitude"},"groom_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Groom Longitude"},"groom_timezone":{"type":"string","title":"Groom Timezone","default":"UTC"},"include_navamsa":{"type":"boolean","title":"Include Navamsa","default":false},"include_manglik":{"type":"boolean","enum":[true],"title":"Include Manglik","default":true},"include_dasha":{"type":"boolean","enum":[false],"title":"Include Dasha","default":false},"include_remedies":{"type":"boolean","enum":[true],"title":"Include Remedies","default":true},"bride_name":{"type":"string","maxLength":120,"minLength":1,"title":"Bride Name","default":"Person A"},"groom_name":{"type":"string","maxLength":120,"minLength":1,"title":"Groom Name","default":"Person B"},"bride_place_label":{"type":"string","maxLength":160,"title":"Bride Place Label","default":"Coordinates supplied"},"groom_place_label":{"type":"string","maxLength":160,"title":"Groom Place Label","default":"Coordinates supplied"}},"type":"object","required":["bride_birth_datetime","bride_latitude","bride_longitude","groom_birth_datetime","groom_latitude","groom_longitude"],"title":"MatchingReportRequest","description":"Request model for comprehensive compatibility matching.\n\nAttributes:\n bride_birth_datetime: Bride's birth date and time\n bride_latitude: Bride's birth latitude\n bride_longitude: Bride's birth longitude\n bride_timezone: Bride's birth timezone\n groom_birth_datetime: Groom's birth date and time\n groom_latitude: Groom's birth latitude\n groom_longitude: Groom's birth longitude\n groom_timezone: Groom's birth timezone\n include_navamsa: Include Navamsa compatibility\n include_manglik: Include detailed Manglik analysis\n include_dasha: Include dasha compatibility\n include_remedies: Include remedies for doshas\n ayanamsa: Sidereal frame for both charts (default Lahiri)"},"MatchingRequest":{"properties":{"ayanamsa":{"type":"string","title":"Ayanamsa"},"bride_birth_datetime":{"type":"string","format":"date-time","title":"Bride Birth Datetime"},"bride_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Bride Latitude"},"bride_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Bride Longitude"},"bride_timezone":{"type":"string","title":"Bride Timezone","default":"UTC"},"groom_birth_datetime":{"type":"string","format":"date-time","title":"Groom Birth Datetime"},"groom_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Groom Latitude"},"groom_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Groom Longitude"},"groom_timezone":{"type":"string","title":"Groom Timezone","default":"UTC"},"include_navamsa":{"type":"boolean","title":"Include Navamsa","default":true},"include_manglik":{"type":"boolean","title":"Include Manglik","default":true},"include_dasha":{"type":"boolean","title":"Include Dasha","default":true},"include_remedies":{"type":"boolean","title":"Include Remedies","default":true}},"type":"object","required":["bride_birth_datetime","bride_latitude","bride_longitude","groom_birth_datetime","groom_latitude","groom_longitude"],"title":"MatchingRequest","description":"Request model for comprehensive compatibility matching.\n\nAttributes:\n bride_birth_datetime: Bride's birth date and time\n bride_latitude: Bride's birth latitude\n bride_longitude: Bride's birth longitude\n bride_timezone: Bride's birth timezone\n groom_birth_datetime: Groom's birth date and time\n groom_latitude: Groom's birth latitude\n groom_longitude: Groom's birth longitude\n groom_timezone: Groom's birth timezone\n include_navamsa: Include Navamsa compatibility\n include_manglik: Include detailed Manglik analysis\n include_dasha: Include dasha compatibility\n include_remedies: Include remedies for doshas\n ayanamsa: Sidereal frame for both charts (default Lahiri)"},"MatchingResponse":{"properties":{"bride_details":{"additionalProperties":{"type":"string"},"type":"object","title":"Bride Details"},"groom_details":{"additionalProperties":{"type":"string"},"type":"object","title":"Groom Details"},"ashta_koota":{"$ref":"#/components/schemas/AshtaKootaScore"},"manglik_analysis":{"additionalProperties":{"$ref":"#/components/schemas/ManglikDoshaAnalysis"},"type":"object","title":"Manglik Analysis"},"nadi_dosha_analysis":{"$ref":"#/components/schemas/NadiDoshaAnalysis"},"bhakoot_dosha_analysis":{"$ref":"#/components/schemas/BhakootDoshaAnalysis"},"navamsa_compatibility":{"$ref":"#/components/schemas/NavamsaCompatibility"},"planet_compatibility":{"items":{"$ref":"#/components/schemas/PlanetWiseCompatibility"},"type":"array","title":"Planet Compatibility"},"dasha_compatibility":{"$ref":"#/components/schemas/DashaCompatibility"},"summary":{"$ref":"#/components/schemas/MatchingSummary"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"},"auspicious_dates":{"items":{"type":"string"},"type":"array","title":"Auspicious Dates"}},"type":"object","required":["bride_details","groom_details","ashta_koota","manglik_analysis","nadi_dosha_analysis","summary","recommendations"],"title":"MatchingResponse","description":"Complete compatibility matching response.\n\nAttributes:\n bride_details: Bride's chart summary\n groom_details: Groom's chart summary\n ashta_koota: Complete 8-fold matching\n manglik_analysis: Detailed Manglik analysis for both\n nadi_dosha_analysis: Detailed Nadi dosha analysis\n bhakoot_dosha_analysis: Detailed Bhakoot analysis\n navamsa_compatibility: D9 chart compatibility\n planet_compatibility: Planet-wise analysis\n dasha_compatibility: Dasha timing analysis\n summary: Executive summary\n recommendations: Detailed recommendations\n remedies: Suggested remedies for any doshas\n auspicious_dates: ALWAYS EMPTY. See the field note below."},"MatchingSummary":{"properties":{"overall_score":{"type":"number","title":"Overall Score"},"compatibility_level":{"$ref":"#/components/schemas/CompatibilityLevel"},"recommendation":{"type":"string","title":"Recommendation","description":"Highly Recommended, Recommended, Proceed with Caution, Not Recommended"},"key_strengths":{"items":{"type":"string"},"type":"array","title":"Key Strengths"},"key_concerns":{"items":{"type":"string"},"type":"array","title":"Key Concerns"},"critical_doshas":{"items":{"type":"string"},"type":"array","title":"Critical Doshas"},"dosha_remedies_available":{"type":"boolean","title":"Dosha Remedies Available"},"final_verdict":{"type":"string","title":"Final Verdict"}},"type":"object","required":["overall_score","compatibility_level","recommendation","key_strengths","key_concerns","critical_doshas","dosha_remedies_available","final_verdict"],"title":"MatchingSummary","description":"Executive summary of the matching analysis.\n\nAttributes:\n overall_score: Total Guna score (out of 36)\n compatibility_level: Rating (Excellent to Poor)\n recommendation: Marriage recommendation\n key_strengths: Main positive factors\n key_concerns: Main areas of concern\n critical_doshas: Any critical doshas present\n final_verdict: Final recommendation"},"MeetingRahuKaalOut":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"warning":{"type":"string","title":"Warning"}},"type":"object","required":["start","end","warning"],"title":"MeetingRahuKaalOut"},"MeetingSlotOut":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"quality":{"type":"string","title":"Quality"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["start","end","quality","reason"],"title":"MeetingSlotOut"},"MeetingTimeOut":{"properties":{"date":{"type":"string","title":"Date"},"location":{"$ref":"#/components/schemas/app__routers__astro_calendar__LocationOut"},"available_slots":{"items":{"$ref":"#/components/schemas/MeetingSlotOut"},"type":"array","title":"Available Slots"},"rahu_kaal":{"$ref":"#/components/schemas/MeetingRahuKaalOut"},"best_planetary_hour":{"$ref":"#/components/schemas/FirstHoraOut"},"recommendation":{"type":"string","title":"Recommendation"}},"type":"object","required":["date","location","available_slots","rahu_kaal","best_planetary_hour","recommendation"],"title":"MeetingTimeOut"},"MeetingTimeRequest":{"properties":{"target_date":{"type":"string","format":"date","title":"Target Date","description":"Date for the meeting"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Latitude of the place"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Longitude of the place"},"timezone":{"type":"string","title":"Timezone","description":"IANA timezone, e.g. Asia/Kolkata"},"duration_minutes":{"type":"integer","maximum":480.0,"minimum":15.0,"title":"Duration Minutes","description":"Meeting duration in minutes","default":60},"user_id":{"type":"string","title":"User Id","description":"User ID for personalized suggestions"}},"type":"object","required":["target_date","latitude","longitude","timezone"],"title":"MeetingTimeRequest"},"MetalRecommendation":{"properties":{"metal_type":{"type":"string","title":"Metal Type","description":"Type of metal"},"ruling_planet":{"type":"string","title":"Ruling Planet","description":"Planet ruled by this metal"},"benefits":{"items":{"type":"string"},"type":"array","title":"Benefits","description":"Benefits of wearing this metal"},"precautions":{"items":{"type":"string"},"type":"array","title":"Precautions","description":"Precautions when wearing this metal"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Strength of the recommendation (0-1)"}},"type":"object","required":["metal_type","ruling_planet","benefits","precautions","strength"],"title":"MetalRecommendation","description":"Model for a metal recommendation."},"MethodComparison":{"properties":{"method":{"$ref":"#/components/schemas/RectificationMethod"},"suggested_time":{"type":"string","format":"date-time","title":"Suggested Time"},"confidence":{"type":"number","title":"Confidence"},"ascendant":{"type":"string","title":"Ascendant"},"agrees_with_consensus":{"type":"boolean","title":"Agrees With Consensus"}},"type":"object","required":["method","suggested_time","confidence","ascendant","agrees_with_consensus"],"title":"MethodComparison","description":"Comparison of results from different rectification methods.\n\nAttributes:\n method: The rectification method\n suggested_time: Time suggested by this method\n confidence: Confidence score\n ascendant: Ascendant for this time\n agrees_with_consensus: Whether agrees with final result"},"MonthDayOut":{"properties":{"date":{"type":"string","title":"Date"},"day":{"type":"integer","title":"Day"},"weekday":{"type":"string","title":"Weekday"},"quality":{"type":"string","title":"Quality"},"score":{"type":"integer","title":"Score"},"tithi":{"type":"string","title":"Tithi"},"paksha":{"type":"string","title":"Paksha"},"moon_sign":{"type":"string","title":"Moon Sign"}},"type":"object","required":["date","day","weekday","quality","score","tithi","paksha","moon_sign"],"title":"MonthDayOut"},"MonthSummaryOut":{"properties":{"excellent_days":{"items":{"type":"integer"},"type":"array","title":"Excellent Days"},"days_to_avoid":{"items":{"type":"integer"},"type":"array","title":"Days To Avoid"},"best_period":{"$ref":"#/components/schemas/BestPeriodOut"}},"type":"object","required":["excellent_days","days_to_avoid","best_period"],"title":"MonthSummaryOut"},"MonthlyCalendarOut":{"properties":{"year":{"type":"integer","title":"Year"},"month":{"type":"integer","title":"Month"},"month_name":{"type":"string","title":"Month Name"},"location":{"$ref":"#/components/schemas/app__routers__astro_calendar__LocationOut"},"days":{"items":{"$ref":"#/components/schemas/MonthDayOut"},"type":"array","title":"Days"},"summary":{"$ref":"#/components/schemas/MonthSummaryOut"}},"type":"object","required":["year","month","month_name","location","days","summary"],"title":"MonthlyCalendarOut"},"MonthlyPrediction":{"properties":{"month":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"overall_rating":{"type":"string","title":"Overall Rating"},"score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Score"},"key_themes":{"items":{"type":"string"},"type":"array","title":"Key Themes","default":[]},"favorable_dates":{"items":{"type":"integer"},"type":"array","title":"Favorable Dates","default":[]},"challenging_dates":{"items":{"type":"integer"},"type":"array","title":"Challenging Dates","default":[]},"career":{"type":"string","title":"Career"},"finance":{"type":"string","title":"Finance"},"health":{"type":"string","title":"Health"},"relationships":{"type":"string","title":"Relationships"},"advice":{"type":"string","title":"Advice"}},"type":"object","required":["month","start_date","end_date","overall_rating","score","career","finance","health","relationships","advice"],"title":"MonthlyPrediction","description":"Prediction for one Tajika month of the Varshaphal year.\n\n``month`` is the month's index within the varsha, 1 to 12, counted from the\nsolar return -- not a calendar month. Its span is ``start_date`` (the masa\npravesha) to ``end_date`` (the next one), in the chart's timezone."},"MonthlyPredictionRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"month":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month","description":"Month (1-12); default: current month"},"year":{"type":"integer","maximum":9999.0,"minimum":1.0,"title":"Year","description":"Year; default: current year"}},"type":"object","required":["birth_details"],"title":"MonthlyPredictionRequest","description":"Request for monthly prediction."},"MoodType":{"type":"string","enum":["very_positive","positive","neutral","negative","very_negative"],"title":"MoodType","description":"Types of moods that can be tracked."},"MoonAnalysis":{"properties":{"longitude":{"type":"number","title":"Longitude"},"sign":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign"},"sign_name":{"type":"string","title":"Sign Name"},"nakshatra":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Nakshatra"},"nakshatra_name":{"type":"string","title":"Nakshatra Name"},"tithi":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Tithi"},"paksha":{"type":"string","title":"Paksha","description":"Shukla or Krishna"},"is_waxing":{"type":"boolean","title":"Is Waxing"},"is_strong":{"type":"boolean","title":"Is Strong"},"strength_factors":{"items":{"type":"string"},"type":"array","title":"Strength Factors"}},"type":"object","required":["longitude","sign","sign_name","nakshatra","nakshatra_name","tithi","paksha","is_waxing","is_strong","strength_factors"],"title":"MoonAnalysis","description":"Moon-based analysis for Prashna.\n\nThe Moon is crucial in Prashna - it represents the mind of the querent\nand the essence of the question.\n\nAttributes:\n longitude: Moon's longitude\n sign: Moon's sign\n sign_name: Sign name\n nakshatra: Moon's nakshatra\n nakshatra_name: Nakshatra name\n tithi: Lunar day (1-30)\n paksha: Bright (Shukla) or Dark (Krishna) fortnight\n is_waxing: Whether Moon is waxing\n is_strong: Overall Moon strength assessment\n moon_day_lord: Lord of the lunar day\n strength_factors: List of strength/weakness factors"},"MoonJournalEntry":{"properties":{"date":{"type":"string","format":"date-time","title":"Date","description":"Date of the journal entry"},"moon_sign":{"type":"string","title":"Moon Sign","description":"Moon sign for the day"},"mood":{"allOf":[{"$ref":"#/components/schemas/MoodType"}],"description":"Mood for the day"},"energy_level":{"allOf":[{"$ref":"#/components/schemas/EnergyLevel"}],"description":"Energy level for the day"},"journal_text":{"type":"string","title":"Journal Text","description":"Journal text for the day"},"rituals_performed":{"items":{"$ref":"#/components/schemas/RitualType"},"type":"array","description":"Rituals performed for the day"},"other_ritual":{"type":"string","title":"Other Ritual","description":"Description of other ritual performed"},"gratitude_points":{"items":{"type":"string"},"type":"array","title":"Gratitude Points","description":"Points of gratitude for the day"},"challenges":{"items":{"type":"string"},"type":"array","title":"Challenges","description":"Challenges faced for the day"},"insights":{"items":{"type":"string"},"type":"array","title":"Insights","description":"Insights gained for the day"},"astro_affirmation":{"type":"string","title":"Astro Affirmation","description":"Astro affirmation for the day"},"user_id":{"type":"string","title":"User Id","description":"User ID of the journal entry owner"},"rashifal_context":{"allOf":[{"$ref":"#/components/schemas/RashifalJournalContext"}],"title":"Rashifal Context","description":"Rashiphal reading context when this began as an observation"}},"type":"object","required":["date","moon_sign","mood","energy_level","journal_text","astro_affirmation","user_id"],"title":"MoonJournalEntry","description":"Model for a daily moon journal entry."},"MoonJournalHistoryResponse":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/MoonJournalEntry"},"type":"array","title":"Entries","description":"List of journal entries"},"mood_summary":{"additionalProperties":{"type":"integer"},"type":"object","title":"Mood Summary","description":"Summary of moods over time"},"energy_summary":{"additionalProperties":{"type":"integer"},"type":"object","title":"Energy Summary","description":"Summary of energy levels over time"},"ritual_summary":{"additionalProperties":{"type":"integer"},"type":"object","title":"Ritual Summary","description":"Summary of rituals performed over time"}},"type":"object","required":["entries","mood_summary","energy_summary","ritual_summary"],"title":"MoonJournalHistoryResponse","description":"Response model for moon journal history."},"MoonJournalRequest":{"properties":{"date":{"type":"string","format":"date-time","title":"Date","description":"Date of the journal entry (defaults to today)"},"mood":{"allOf":[{"$ref":"#/components/schemas/MoodType"}],"description":"Mood for the day"},"energy_level":{"allOf":[{"$ref":"#/components/schemas/EnergyLevel"}],"description":"Energy level for the day"},"journal_text":{"type":"string","title":"Journal Text","description":"Journal text for the day"},"rituals_performed":{"items":{"$ref":"#/components/schemas/RitualType"},"type":"array","description":"Rituals performed for the day"},"other_ritual":{"type":"string","title":"Other Ritual","description":"Description of other ritual performed"},"gratitude_points":{"items":{"type":"string"},"type":"array","title":"Gratitude Points","description":"Points of gratitude for the day"},"challenges":{"items":{"type":"string"},"type":"array","title":"Challenges","description":"Challenges faced for the day"},"insights":{"items":{"type":"string"},"type":"array","title":"Insights","description":"Insights gained for the day"},"rashifal_context":{"allOf":[{"$ref":"#/components/schemas/RashifalJournalContext"}],"title":"Rashifal Context","description":"Optional Rashiphal reading context to preserve during migration"}},"type":"object","required":["mood","energy_level","journal_text"],"title":"MoonJournalRequest","description":"Request model for creating or updating a moon journal entry."},"MoonJournalResponse":{"properties":{"entry":{"allOf":[{"$ref":"#/components/schemas/MoonJournalEntry"}],"title":"Entry","description":"The journal entry"},"moon_sign_qualities":{"additionalProperties":{"type":"string"},"type":"object","title":"Moon Sign Qualities","description":"Qualities of the moon sign"},"journal_prompt":{"type":"string","title":"Journal Prompt","description":"Journal prompt for the day"},"astro_affirmation":{"type":"string","title":"Astro Affirmation","description":"Astro affirmation for the day"},"recommended_rituals":{"items":{"$ref":"#/components/schemas/RitualType"},"type":"array","description":"Recommended rituals for the day"},"mood_trend":{"additionalProperties":{"type":"integer"},"type":"object","title":"Mood Trend","description":"Mood trend over the past week"}},"type":"object","required":["entry","moon_sign_qualities","journal_prompt","astro_affirmation","recommended_rituals","mood_trend"],"title":"MoonJournalResponse","description":"Response model for a moon journal entry."},"MoonPhase":{"type":"string","enum":["new_moon","waxing_crescent","first_quarter","waxing_gibbous","full_moon","waning_gibbous","last_quarter","waning_crescent"],"title":"MoonPhase","description":"Phases of the moon."},"MoonRashi":{"properties":{"number":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Number","description":"Rashi number (1-12)"},"name":{"type":"string","title":"Name","description":"Sanskrit name, e.g. Tula"},"name_en":{"type":"string","title":"Name En","description":"English name, e.g. Libra"},"degrees":{"type":"number","exclusiveMaximum":30.0,"minimum":0.0,"title":"Degrees","description":"Degrees traversed within the sign"}},"type":"object","required":["number","name","name_en","degrees"],"title":"MoonRashi","description":"The Moon's sidereal sign at the calculation instant.\n\nNot one of the five angas, but published alongside them because it is the\nJanma Rashi whenever the instant is a birth, and clients were otherwise\ninferring it from ``nakshatra.pada``."},"MoonSign":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces"],"title":"MoonSign","description":"Zodiac signs for the moon."},"MuddaDasha":{"properties":{"planet":{"type":"string","title":"Planet"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"duration_days":{"type":"integer","title":"Duration Days"},"is_current":{"type":"boolean","title":"Is Current","default":false},"sub_lord":{"type":"string","title":"Sub Lord"},"predictions":{"items":{"type":"string"},"type":"array","title":"Predictions","default":[]}},"type":"object","required":["planet","start_date","end_date","duration_days"],"title":"MuddaDasha","description":"Mudda Dasha (Annual Planetary Period)"},"MuhuratPeriod":{"properties":{"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"},"score":{"$ref":"#/components/schemas/MuhuratScore"},"description":{"type":"string","title":"Description"}},"type":"object","required":["start_time","end_time","score","description"],"title":"MuhuratPeriod","description":"Model for a Muhurat period."},"MuhuratRequest":{"properties":{"timezone":{"type":"string","title":"Timezone","description":"IANA timezone the returned times are expressed in","default":"Asia/Kolkata"},"date":{"type":"string","format":"date","title":"Date"},"event_type":{"allOf":[{"$ref":"#/components/schemas/EventType"}],"description":"Type of event the muhurat is for"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Latitude of the location"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Longitude of the location"},"duration_hours":{"type":"number","maximum":24.0,"minimum":0.016666666666666666,"title":"Duration Hours","description":"Length of the event, in hours (at least one minute)","default":2.0},"max_results":{"type":"integer","exclusiveMinimum":0.0,"title":"Max Results","description":"Cap on the number of periods returned; all of them if unset"}},"type":"object","required":["date","event_type","latitude","longitude"],"title":"MuhuratRequest","description":"Request model for Muhurat calculation.\n\nTHIS MODEL AGREED WITH NEITHER THE ROUTER NOR THE CLIENT, AND SO /muhurat/find\nHAD NO WORKING FORM. It declared ``muhurat_type`` and no location at all,\nwhile the route handler read ``event_type``, ``latitude``, ``longitude``,\n``timezone`` and ``duration_hours`` off it and xmukha's findBasicMuhurat sent\nexactly that second set. So the client's request was rejected 422 for a\nmissing ``muhurat_type``, and a request shaped the way this model asked got a\n500 on ``'MuhuratRequest' object has no attribute 'event_type'``. Both paths\nwere dead, in opposite directions, which is why neither was ever reported as\nthe other's symptom.\n\nThe location is required rather than defaulted. Every time in the response\nderives from the local sunrise, so a request without coordinates has no\nanswer -- and quietly substituting New Delhi's, which the service wrapper\nused to do, produces times that are wrong by hours while looking entirely\nordinary."},"MuhuratResponse":{"properties":{"date":{"type":"string","title":"Date"},"muhurat_type":{"$ref":"#/components/schemas/EventType"},"description":{"type":"string","title":"Description"},"sunrise":{"type":"string","title":"Sunrise"},"sunset":{"type":"string","title":"Sunset"},"periods":{"items":{"$ref":"#/components/schemas/MuhuratPeriod"},"type":"array","title":"Periods"},"general_recommendations":{"items":{"type":"string"},"type":"array","title":"General Recommendations"}},"type":"object","required":["date","muhurat_type","description","sunrise","sunset","periods","general_recommendations"],"title":"MuhuratResponse","description":"Response model for Muhurat calculation."},"MuhuratScore":{"properties":{"overall":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Overall","description":"Overall auspiciousness score"},"planet_strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Planet Strength","description":"Score based on planetary positions"},"house_strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"House Strength","description":"Score based on house placements"},"aspect_strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Aspect Strength","description":"Score based on planetary aspects"}},"type":"object","required":["overall","planet_strength","house_strength","aspect_strength"],"title":"MuhuratScore","description":"Model for Muhurat scores."},"MuhurtaData":{"properties":{"current_muhurta":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Current Muhurta"},"muhurta_name":{"type":"string","title":"Muhurta Name"},"is_auspicious":{"type":"boolean","title":"Is Auspicious"},"choghadiya":{"type":"string","title":"Choghadiya"},"choghadiya_quality":{"type":"string","title":"Choghadiya Quality"},"abhijit_muhurta":{"type":"boolean","title":"Abhijit Muhurta"},"time_until_next_good":{"type":"integer","title":"Time Until Next Good"}},"type":"object","required":["current_muhurta","muhurta_name","is_auspicious","choghadiya","choghadiya_quality","abhijit_muhurta"],"title":"MuhurtaData","description":"Muhurta (auspicious timing) data.\n\nAttributes:\n current_muhurta: Current muhurta number (1-30)\n muhurta_name: Name of current muhurta period\n is_auspicious: Whether current muhurta is auspicious\n choghadiya: Current choghadiya period\n choghadiya_quality: Quality of current choghadiya\n abhijit_muhurta: Whether it's Abhijit Muhurta (most auspicious)\n time_until_next_good: Minutes until next auspicious period"},"MuhurtaRecommendation":{"properties":{"activity":{"type":"string","title":"Activity"},"recommended_dates":{"items":{"type":"string","format":"date"},"type":"array","title":"Recommended Dates"},"best_time_windows":{"items":{"type":"string"},"type":"array","title":"Best Time Windows"},"avoid_dates":{"items":{"type":"string","format":"date"},"type":"array","title":"Avoid Dates"},"reasoning":{"type":"string","title":"Reasoning"}},"type":"object","required":["activity","recommended_dates","best_time_windows","avoid_dates","reasoning"],"title":"MuhurtaRecommendation","description":"Auspicious timing recommendation."},"MuhurtaWindowOut":{"properties":{"start_time":{"type":"string","title":"Start Time"},"end_time":{"type":"string","title":"End Time"},"duration_minutes":{"type":"integer","title":"Duration Minutes"},"score":{"type":"number","title":"Score"},"quality":{"type":"string","title":"Quality"},"suitability":{"type":"string","title":"Suitability"},"reasons":{"items":{"type":"object"},"type":"array","title":"Reasons"},"strengths":{"items":{"type":"string"},"type":"array","title":"Strengths"},"weaknesses":{"items":{"type":"string"},"type":"array","title":"Weaknesses"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"component_scores":{"additionalProperties":{"type":"number"},"type":"object","title":"Component Scores"},"score_weights":{"additionalProperties":{"type":"number"},"type":"object","title":"Score Weights"},"factors":{"type":"object","title":"Factors"},"planetary_balas":{"items":{"type":"object"},"type":"array","title":"Planetary Balas"}},"type":"object","required":["start_time","end_time","duration_minutes","score","quality","suitability"],"title":"MuhurtaWindowOut","description":"One candidate window. Mirrors AdvancedMuhurtaWindow in muhurtham.ts."},"MultiDashaResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in ISO format"},"systems_analyzed":{"items":{"type":"string"},"type":"array","title":"Systems Analyzed","description":"Dasha systems compared"},"current_periods":{"additionalProperties":{"type":"string"},"type":"object","title":"Current Periods","description":"Current period label for every analyzed system"},"vimshottari_current":{"type":"string","title":"Vimshottari Current","description":"Current Vimshottari period"},"yogini_current":{"type":"string","title":"Yogini Current","description":"Current Yogini period"},"chara_current":{"type":"string","title":"Chara Current","description":"Current Chara period"},"narayana_current":{"type":"string","title":"Narayana Current","description":"Current Narayana period"},"combined_analysis":{"type":"string","title":"Combined Analysis","description":"Combined analysis from all systems"},"key_periods":{"items":{"type":"object"},"type":"array","title":"Key Periods","description":"Key upcoming periods across systems"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations","description":"Combined recommendations"}},"type":"object","required":["birth_date","systems_analyzed","combined_analysis"],"title":"MultiDashaResponse","description":"Response model for comparing multiple dasha systems."},"MultiStyleChartRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"styles":{"items":{"type":"string"},"type":"array","title":"Styles","description":"List of styles: north_indian, south_indian, east_indian","default":["south_indian"]},"language":{"type":"string","title":"Language","default":"english"},"include_divisional":{"type":"boolean","title":"Include Divisional","default":false},"divisional_charts":{"items":{"type":"string"},"type":"array","title":"Divisional Charts","description":"Divisional charts: D2, D3, D7, D9, D10, D12","default":["D9"]},"node_type":{"type":"string","title":"Node Type","description":"Rahu/Ketu node model: 'mean' (default) or 'true'"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_details"],"title":"MultiStyleChartRequest","description":"Request for generating chart in multiple regional styles at once.\n\nAttributes:\n birth_details: Birth details for chart calculation\n styles: List of regional styles to generate\n language: Language for labels\n include_divisional: Whether to include divisional charts\n divisional_charts: Which divisional charts to include"},"MultiStyleChartResponse":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"charts":{"additionalProperties":{"$ref":"#/components/schemas/ChartLayoutData"},"type":"object","title":"Charts"},"divisional_charts":{"additionalProperties":{"additionalProperties":{"$ref":"#/components/schemas/ChartLayoutData"},"type":"object"},"type":"object","title":"Divisional Charts"},"planetary_data":{"items":{"$ref":"#/components/schemas/app__schemas__kundali__PlanetPosition"},"type":"array","title":"Planetary Data"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["birth_details","charts","planetary_data"],"title":"MultiStyleChartResponse","description":"Response with chart data in multiple regional styles.\n\nAttributes:\n birth_details: Original birth details\n charts: Dictionary of style -> chart layout data\n divisional_charts: Dictionary of chart_type -> style -> layout\n planetary_data: Common planetary data across all charts"},"MunthaAnalysis":{"properties":{"sign":{"type":"string","title":"Sign"},"sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign Num"},"degree":{"type":"number","exclusiveMaximum":30.0,"minimum":0.0,"title":"Degree"},"house_position":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House Position"},"lord":{"type":"string","title":"Lord"},"lord_strength":{"type":"string","title":"Lord Strength"},"result":{"$ref":"#/components/schemas/MunthaResult"},"interpretation":{"type":"string","title":"Interpretation"},"favorable_months":{"items":{"type":"integer"},"type":"array","title":"Favorable Months","default":[]}},"type":"object","required":["sign","sign_num","degree","house_position","lord","lord_strength","result","interpretation"],"title":"MunthaAnalysis","description":"Muntha (progressed ascendant) analysis"},"MunthaRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"birth_time":{"type":"string","title":"Birth Time"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"year":{"type":"integer","title":"Year"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Tajika sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude","year"],"title":"MunthaRequest","description":"Request for Muntha calculation only"},"MunthaResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"muntha":{"$ref":"#/components/schemas/MunthaAnalysis"},"year_lord":{"$ref":"#/components/schemas/VarshaLord"}},"type":"object","required":["muntha","year_lord"],"title":"MunthaResponse","description":"Response for Muntha calculation"},"MunthaResult":{"type":"string","enum":["excellent","good","moderate","challenging","difficult"],"title":"MunthaResult","description":"Muntha placement results"},"NabhasyogaSummary":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"yogas":{"items":{"$ref":"#/components/schemas/YogaData"},"type":"array","title":"Yogas"},"planetary_distribution":{"type":"string","title":"Planetary Distribution"},"dominant_pattern":{"type":"string","title":"Dominant Pattern"}},"type":"object","required":["total_count","yogas","planetary_distribution"],"title":"NabhasyogaSummary","description":"Summary of Nabhas (pattern) Yogas.\n\nAttributes:\n total_count: Number of pattern yogas present\n yogas: List of individual pattern yoga details\n planetary_distribution: How planets are distributed\n dominant_pattern: The dominant pattern type"},"NadiDoshaAnalysis":{"properties":{"bride_nadi":{"type":"string","title":"Bride Nadi"},"groom_nadi":{"type":"string","title":"Groom Nadi"},"has_nadi_dosha":{"type":"boolean","title":"Has Nadi Dosha"},"dosha_status":{"$ref":"#/components/schemas/DoshaStatus"},"exception_rules_checked":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Exception Rules Checked"},"applicable_exceptions":{"items":{"type":"string"},"type":"array","title":"Applicable Exceptions"},"is_fully_cancelled":{"type":"boolean","title":"Is Fully Cancelled"},"is_partially_cancelled":{"type":"boolean","title":"Is Partially Cancelled"},"remaining_effects":{"items":{"type":"string"},"type":"array","title":"Remaining Effects"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"}},"type":"object","required":["bride_nadi","groom_nadi","has_nadi_dosha","dosha_status","exception_rules_checked","applicable_exceptions","is_fully_cancelled","is_partially_cancelled"],"title":"NadiDoshaAnalysis","description":"Detailed Nadi Dosha analysis with exception rules.\n\nSame Nadi between bride and groom creates Nadi Dosha,\nbut there are many exception rules.\n\nException Rules:\n1. Same nakshatra but different pada - Cancelled\n2. Same rashi but different nakshatra - Cancelled\n3. If bride's nakshatra comes before groom's in same pada - Cancelled\n4. Specific nakshatra combinations - Cancelled"},"NadiKoota":{"properties":{"name":{"type":"string","title":"Name"},"max_points":{"type":"number","title":"Max Points"},"obtained_points":{"type":"number","title":"Obtained Points"},"percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Percentage"},"bride_value":{"type":"string","title":"Bride Value"},"groom_value":{"type":"string","title":"Groom Value"},"compatibility_status":{"type":"string","title":"Compatibility Status","description":"Good, Average, or Poor"},"description":{"type":"string","title":"Description"},"analysis":{"type":"string","title":"Analysis"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"bride_nadi":{"type":"string","title":"Bride Nadi","description":"Aadi, Madhya, or Antya"},"groom_nadi":{"type":"string","title":"Groom Nadi","description":"Aadi, Madhya, or Antya"},"has_nadi_dosha":{"type":"boolean","title":"Has Nadi Dosha"},"nadi_dosha_exceptions":{"items":{"type":"string"},"type":"array","title":"Nadi Dosha Exceptions","description":"Exception rules that might cancel Nadi dosha"},"is_dosha_cancelled":{"type":"boolean","title":"Is Dosha Cancelled","default":false}},"type":"object","required":["name","max_points","obtained_points","percentage","bride_value","groom_value","compatibility_status","description","analysis","bride_nadi","groom_nadi","has_nadi_dosha"],"title":"NadiKoota","description":"Nadi Koota - Health/Genetic compatibility (8 points).\n\nThree Nadis: Aadi (Vata), Madhya (Pitta), Antya (Kapha)\n\nRules:\n- Different Nadi = 8 points\n- Same Nadi = 0 points (Nadi Dosha - affects progeny)\n\nIMPORTANT: Nadi Dosha has many exception rules that can cancel it."},"NaisargikaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"strength_virupas":{"type":"number","title":"Strength Virupas"},"strength_rupas":{"type":"number","title":"Strength Rupas"},"rank":{"type":"integer","title":"Rank"}},"type":"object","required":["planet","strength_virupas","strength_rupas","rank"],"title":"NaisargikaBala","description":"Natural Strength (fixed values)."},"Nakshatra":{"properties":{"number":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Number","description":"Nakshatra number (1-27)"},"name":{"type":"string","title":"Name","description":"Name of the Nakshatra"},"pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada","description":"Pada (quarter) of the Nakshatra"},"lord":{"type":"string","title":"Lord","description":"Planetary lord of this nakshatra"},"progress":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Progress","description":"How far the Moon is through this nakshatra at sunrise (0-1)"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Start time of the Nakshatra"},"end_time":{"type":"string","format":"date-time","title":"End Time","description":"End time of the Nakshatra"},"ending_time":{"type":"string","format":"date-time","title":"Ending Time","description":"Alias of end_time"},"transition_time":{"type":"string","format":"date-time","title":"Transition Time","description":"Alias of end_time"},"system":{"type":"string","title":"System","description":"Ephemeris system used for the naming"},"spans":{"items":{"$ref":"#/components/schemas/LimbSpan"},"type":"array","title":"Spans","description":"Every nakshatra touching the sunrise-to-sunrise day, in order"}},"type":"object","required":["number","name","pada","start_time","end_time"],"title":"Nakshatra","description":"Schema for Nakshatra (lunar mansion) information."},"NakshatraCategoryOut":{"properties":{"name":{"type":"string","title":"Name"},"nakshatras":{"items":{"type":"string"},"type":"array","title":"Nakshatras"},"suitable_for":{"items":{"type":"string"},"type":"array","title":"Suitable For"},"description":{"type":"string","title":"Description"}},"type":"object","required":["name","description"],"title":"NakshatraCategoryOut"},"NakshatraGuideResponse":{"properties":{"total_categories":{"type":"integer","title":"Total Categories"},"categories":{"additionalProperties":{"$ref":"#/components/schemas/NakshatraCategoryOut"},"type":"object","title":"Categories"}},"type":"object","required":["total_categories"],"title":"NakshatraGuideResponse","description":"GET /advanced-muhurta/nakshatra-guide"},"NakshatraInfo":{"properties":{"number":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Number"},"name":{"type":"string","title":"Name"},"english_name":{"type":"string","title":"English Name"},"ruling_planet":{"type":"string","title":"Ruling Planet"},"deity":{"type":"string","title":"Deity"},"symbol":{"type":"string","title":"Symbol"},"auspicious_syllables":{"items":{"type":"string"},"type":"array","title":"Auspicious Syllables"},"pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada"},"pada_syllable":{"type":"string","title":"Pada Syllable"},"qualities":{"items":{"type":"string"},"type":"array","title":"Qualities"}},"type":"object","required":["number","name","english_name","ruling_planet","deity","symbol","auspicious_syllables","pada","pada_syllable","qualities"],"title":"NakshatraInfo","description":"Information about the birth nakshatra.\n\nAttributes:\n number: Nakshatra number (1-27)\n name: Sanskrit name\n english_name: English translation\n ruling_planet: Planet ruling this nakshatra\n deity: Presiding deity\n symbol: Symbol of the nakshatra\n auspicious_syllables: Syllables for naming\n pada: Current pada (1-4)\n pada_syllable: Specific syllable for this pada\n qualities: Key qualities of this nakshatra"},"NakshatraVedha":{"properties":{"natal_nakshatra":{"type":"string","title":"Natal Nakshatra"},"natal_pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Natal Pada"},"transiting_nakshatras":{"items":{"type":"string"},"type":"array","title":"Transiting Nakshatras"},"vedha_nakshatras":{"items":{"type":"string"},"type":"array","title":"Vedha Nakshatras"},"vedha_active":{"type":"boolean","title":"Vedha Active"},"effect_on_natal":{"type":"string","title":"Effect On Natal"}},"type":"object","required":["natal_nakshatra","natal_pada","transiting_nakshatras","vedha_nakshatras","vedha_active","effect_on_natal"],"title":"NakshatraVedha","description":"Nakshatra-specific Vedha analysis"},"NameCategory":{"type":"string","enum":["traditional","modern","mythological","nature","virtue","celestial","divine"],"title":"NameCategory","description":"Category of the name."},"NameOrigin":{"type":"string","enum":["sanskrit","hindi","tamil","telugu","kannada","malayalam","bengali","gujarati","marathi","punjabi","modern","universal"],"title":"NameOrigin","description":"Origin/language of the name."},"NameSuggestion":{"properties":{"name_id":{"type":"string","title":"Name Id"},"name_iast":{"type":"string","title":"Name Iast"},"name_devanagari":{"type":"string","title":"Name Devanagari"},"source_references":{"type":"string","title":"Source References"},"source_urls":{"type":"string","title":"Source Urls"},"exact_pada_match":{"type":"boolean","title":"Exact Pada Match"},"name":{"type":"string","title":"Name"},"meaning":{"type":"string","title":"Meaning"},"gender":{"$ref":"#/components/schemas/app__schemas__baby_name__Gender"},"origin":{"$ref":"#/components/schemas/NameOrigin"},"category":{"$ref":"#/components/schemas/NameCategory"},"starting_syllable":{"type":"string","title":"Starting Syllable"},"nakshatra_compatible":{"type":"boolean","title":"Nakshatra Compatible","default":true},"rashi_compatible":{"type":"boolean","title":"Rashi Compatible","default":true},"numerology":{"$ref":"#/components/schemas/NumerologyAnalysis"},"auspiciousness_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Auspiciousness Score"},"pronunciation_hint":{"type":"string","title":"Pronunciation Hint"},"alternate_spellings":{"items":{"type":"string"},"type":"array","title":"Alternate Spellings"}},"type":"object","required":["name","meaning","gender","origin","category","starting_syllable","auspiciousness_score"],"title":"NameSuggestion","description":"A single name suggestion with analysis.\n\nAttributes:\n name: The suggested name\n meaning: Meaning of the name\n gender: Gender suitability\n origin: Language/cultural origin\n category: Category of name\n starting_syllable: The auspicious starting sound\n nakshatra_compatible: Whether matches birth nakshatra\n rashi_compatible: Whether matches birth rashi\n numerology: Numerological analysis\n auspiciousness_score: Overall auspiciousness (0-100)\n pronunciation_hint: How to pronounce\n alternate_spellings: Other ways to spell"},"NamedYoga":{"properties":{"grahas":{"items":{"type":"string"},"type":"array","title":"Grahas"},"name":{"type":"string","title":"Name"},"meaning":{"type":"string","title":"Meaning"}},"type":"object","required":["grahas","name","meaning"],"title":"NamedYoga"},"NarayanaDashaPeriod":{"properties":{"sign":{"type":"string","title":"Sign","description":"Zodiac sign ruling this period"},"sign_lord":{"type":"string","title":"Sign Lord","description":"Lord of the sign"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date of the period"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End date of the period"},"duration_years":{"type":"integer","title":"Duration Years","description":"Duration in years"},"lagna_relation":{"type":"string","title":"Lagna Relation","description":"Relation to Lagna"},"arudha_relation":{"type":"string","title":"Arudha Relation","description":"Relation to Arudha Lagna"},"predictions":{"items":{"type":"string"},"type":"array","title":"Predictions","description":"Predictions for this period"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Strength of the period"},"material_prosperity":{"type":"string","title":"Material Prosperity","description":"Expected material prosperity level"}},"type":"object","required":["sign","sign_lord","start_date","end_date","duration_years","lagna_relation","arudha_relation","strength","material_prosperity"],"title":"NarayanaDashaPeriod","description":"Model for Narayana Dasha period."},"NarayanaDashaResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in ISO format"},"dasha_system":{"type":"string","title":"Dasha System","description":"Dasha system used","default":"narayana"},"arudha_lagna":{"type":"string","title":"Arudha Lagna","description":"Arudha Lagna sign"},"periods":{"items":{"$ref":"#/components/schemas/NarayanaDashaPeriod"},"type":"array","title":"Periods","description":"Narayana Dasha periods"},"current_period":{"allOf":[{"$ref":"#/components/schemas/NarayanaDashaPeriod"}],"title":"Current Period","description":"Current period"},"next_period":{"allOf":[{"$ref":"#/components/schemas/NarayanaDashaPeriod"}],"title":"Next Period","description":"Next period"},"summary":{"type":"string","title":"Summary","description":"Summary of Narayana Dasha"},"prosperity_timeline":{"items":{"type":"object"},"type":"array","title":"Prosperity Timeline","description":"Material prosperity timeline"}},"type":"object","required":["birth_date","arudha_lagna","periods","summary"],"title":"NarayanaDashaResponse","description":"Response model for Narayana Dasha calculations."},"NatalTransitAspect":{"properties":{"transit_planet":{"type":"string","title":"Transit Planet"},"natal_planet":{"type":"string","title":"Natal Planet"},"aspect_type":{"type":"string","title":"Aspect Type"},"orb":{"type":"number","title":"Orb"},"is_applying":{"type":"boolean","title":"Is Applying"},"nature":{"$ref":"#/components/schemas/InfluenceNature"},"effect_description":{"type":"string","title":"Effect Description"}},"type":"object","required":["transit_planet","natal_planet","aspect_type","orb","is_applying","nature","effect_description"],"title":"NatalTransitAspect","description":"Aspect between transit planet and natal planet."},"NathonataBala":{"properties":{"planet":{"type":"string","title":"Planet"},"is_day_birth":{"type":"boolean","title":"Is Day Birth"},"is_diurnal_planet":{"type":"boolean","title":"Is Diurnal Planet"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","is_day_birth","is_diurnal_planet","strength_virupas"],"title":"NathonataBala","description":"Day/Night birth strength."},"NavamsaChart":{"properties":{"ascendant":{"type":"string","title":"Ascendant"},"ascendant_sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Ascendant Sign Index"},"planets":{"additionalProperties":{"$ref":"#/components/schemas/NavamsaPlacement"},"type":"object","title":"Planets"},"seventh_sign":{"type":"string","title":"Seventh Sign"},"seventh_lord":{"type":"string","title":"Seventh Lord"},"seventh_lord_placement":{"$ref":"#/components/schemas/NavamsaPlacement"}},"type":"object","required":["ascendant","ascendant_sign_index","planets","seventh_sign","seventh_lord","seventh_lord_placement"],"title":"NavamsaChart"},"NavamsaCompatibility":{"properties":{"bride_navamsa_lagna":{"type":"string","title":"Bride Navamsa Lagna"},"groom_navamsa_lagna":{"type":"string","title":"Groom Navamsa Lagna"},"bride_navamsa_moon":{"type":"string","title":"Bride Navamsa Moon"},"groom_navamsa_moon":{"type":"string","title":"Groom Navamsa Moon"},"lagna_compatibility":{"type":"string","title":"Lagna Compatibility"},"bride_venus_navamsa":{"type":"string","title":"Bride Venus Navamsa"},"groom_venus_navamsa":{"type":"string","title":"Groom Venus Navamsa"},"venus_compatibility":{"type":"string","title":"Venus Compatibility"},"bride_seventh_lord":{"type":"string","title":"Bride Seventh Lord"},"groom_seventh_lord":{"type":"string","title":"Groom Seventh Lord"},"seventh_house_analysis":{"type":"string","title":"Seventh House Analysis"},"relationship_indicators":{"items":{"type":"string"},"type":"array","title":"Relationship Indicators"},"compatibility_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Compatibility Score","description":"No numerical D9 compatibility score is assigned"},"interpretation":{"type":"string","title":"Interpretation"},"bride_chart":{"$ref":"#/components/schemas/NavamsaChart"},"groom_chart":{"$ref":"#/components/schemas/NavamsaChart"},"methodology":{"type":"string","title":"Methodology","default":""}},"type":"object","required":["bride_navamsa_lagna","groom_navamsa_lagna","bride_navamsa_moon","groom_navamsa_moon","lagna_compatibility","bride_venus_navamsa","groom_venus_navamsa","venus_compatibility","bride_seventh_lord","groom_seventh_lord","seventh_house_analysis","relationship_indicators","interpretation"],"title":"NavamsaCompatibility","description":"Navamsa (D9) chart-based compatibility analysis.\n\nThe Navamsa chart is crucial for marriage analysis.\n\nAttributes:\n bride_navamsa_lagna: Bride's D9 ascendant\n groom_navamsa_lagna: Groom's D9 ascendant\n lagna_compatibility: Compatibility of D9 lagnas\n venus_analysis: Venus placement in both D9 charts\n seventh_lord_analysis: 7th lord position analysis\n relationship_indicators: Key indicators for relationship\n compatibility_score: D9-based compatibility score"},"NavamsaPlacement":{"properties":{"sign":{"type":"string","title":"Sign"},"sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Index"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"}},"type":"object","required":["sign","sign_index","house"],"title":"NavamsaPlacement"},"NeechabhangaAnalysis":{"properties":{"debilitated_planets":{"items":{"type":"string"},"type":"array","title":"Debilitated Planets"},"cancellations":{"items":{"$ref":"#/components/schemas/NeechabhangaCancellation"},"type":"array","title":"Cancellations"},"neechabhanga_raja_yoga":{"type":"boolean","title":"Neechabhanga Raja Yoga","default":false}},"type":"object","required":["debilitated_planets"],"title":"NeechabhangaAnalysis","description":"Analysis of debilitation cancellation.\n\nAttributes:\n debilitated_planets: Planets in debilitation\n cancellations: Details of any cancellations\n neechabhanga_raja_yoga: Whether this forms Raja Yoga"},"NeechabhangaCancellation":{"properties":{"planet":{"type":"string","title":"Planet"},"debilitation_sign":{"type":"string","title":"Debilitation Sign"},"cancellation_factors":{"items":{"type":"string"},"type":"array","title":"Cancellation Factors"}},"type":"object","required":["planet","debilitation_sign"],"title":"NeechabhangaCancellation","description":"One debilitated planet and the factors that cancel its weakness."},"NivasShool":{"properties":{"homahuti":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Homahuti","description":"Which planet receives the fire offering, by the count from the Sun's nakshatra to the Moon's in blocks of three"},"agni_vasa":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Agni Vasa","description":"Where Agni dwells -- Prithvi, Patala or Akasha -- by weekday and tithi together. The row that decides whether a homa happens at all."},"shiva_vasa":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Shiva Vasa","description":"Shiva's abode by tithi: Kailash, Gowri, Sabha, Krida, Nandi, Bhojana or Shmashana"},"chandra_vasa":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Chandra Vasa","description":"The quarter the Moon dwells in, by its rashi's trine"},"rahu_vasa":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Rahu Vasa","description":"The quarter Rahu dwells in, by weekday. Seven weekdays name seven of the eight directions; no day of the week is North-East."},"disha_shool":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Disha Shool","description":"The direction not to set out in, by weekday. The one rule here that also carries a `parihara`, and on six weekdays of seven -- see this model's own description."},"nakshatra_shool":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Nakshatra Shool","description":"The direction barred by the Moon's nakshatra. Only four of the twenty-seven carry one, so `spans` is empty on most days."},"kumbha_chakra":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Kumbha Chakra","description":"The part of the pot the Moon stands in -- Mouth, a direction, Womb, Bottom or Throat -- by the same count Homahuti reads"},"baana":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Baana","description":"The arrow in force -- Mrityu, Agni, Raja, Chora or Roga -- by the Sun's whole degree within its sign. Four of the nine degrees carry none, so `spans` can be empty or cover part of the day."},"bhadra_vasa":{"allOf":[{"$ref":"#/components/schemas/NivasShoolRule"}],"title":"Bhadra Vasa","description":"Where the Bhadra dwells while it runs -- Swarga, Mrityu or Patala -- by the Moon's rashi. In force ONLY during a Vishti karana, so `spans` is empty on the majority of days and that is the row's answer, not a gap: it means no Bhadra today. Its window is the Bhadra Kaal window this response publishes among the inauspicious periods. 'Patala' here is not Agnivasa's Patala and 'Mrityu' is not Baana's Mrityu."}},"type":"object","title":"NivasShool","description":"The ten Nivas and Shool rules of a printed panchangam.\n\nWhere a thing dwells (*nivas*) and which way is barred (*shool*): the rows a\npurohit reads before fixing a homa or starting a journey. Every table behind\nthem was solved against a committed almanac corpus rather than written from\nmemory -- see ``app/core/nivas_shool.py`` and\n``tests/fixtures/derive_nivas_shool.py`` -- and the ten read eight different\nkeys, so none of them can be checked against another.\n\nValues are bare tokens: \"Sabha\", \"Prithvi\", \"North-West\", \"Mercury\". The\nalmanac's prepositions and glosses (\"in Sabha\", \"Prithvi (Earth)\") are\nrendering and live in the client's dictionary, and the planet names are the\nones the rest of this API uses rather than the Sanskrit the source prints.\n\nEach field is Optional and null means \"this rule could not be solved for this\nday\", never \"it holds nothing\" -- that is an empty ``spans`` on a present\nrule. Nothing here is derived from another field, so one failing rule does not\nwithhold the other eight.\n\n**Disha Shool's parihara is the one field here the almanac did not supply.**\nThe remedy -- what to take before travelling the barred way -- is a real part\nof the rule and no panchang publisher we read prints it, Drik included, so it\ncould not come from the corpus. It is instead what three independent published\nretellings of the rule *unanimously* say, and only that: six of the seven\nvaras, with each source naming extras the others do not and none of those\nshipping. The seventh, Friday, is absent because the three conflict on it, and\nan absent cell is the only honest way to say so -- picking the majority reading\nand printing it under our own name is exactly the failure the corpus method\nexists to prevent. ``app/core/nivas_shool.py`` names the three sources and the\nconflict; every other value in this block came out of the almanac."},"NivasShoolRule":{"properties":{"value":{"type":"string","title":"Value","description":"The value in force at this day's sunrise; null if the rule holds none then"},"spans":{"items":{"$ref":"#/components/schemas/NivasShoolSpan"},"type":"array","title":"Spans","description":"Every stretch of this Hindu day that carries a value, in order, day-clipped and merged. Empty when the rule holds nothing all day."},"parihara":{"type":"string","title":"Parihara","description":"What the tradition says to take before setting out in the barred direction anyway -- 'Ghee', 'Mirror', 'Jaggery', 'Coriander', 'Curd' or 'Urad Dal'. Disha Shool only, and null on Fridays. NOT from the almanac corpus the rest of this block is derived from; see `DISHA_SHOOL_PARIHARA` in `app/core/nivas_shool.py` for the three sources and the one cell they conflict on."}},"type":"object","title":"NivasShoolRule","description":"One rule's answer for the day: the sunrise value and every stretch of it.\n\n``value`` is what a panchangam keys its row on -- the value in force at\nsunrise. ``spans`` is the whole day, so a client can print \"Sabha upto 17:03,\nthen Krida\" rather than only the first half of that sentence. Eight of the\nten rules turn inside a day often enough that publishing ``value`` alone\nwould disagree with the printed page most days of the year: over the two\nalmanac months this was derived against, Shivavasa turned on 60 days of 62 and\nAgnivasa on 43.\n\n``value`` is null, with ``spans`` non-empty, exactly when a rule that can hold\nnothing holds nothing at sunrise and something later -- Nakshatra Shool, Baana\nand Bhadravasa are the three. ``spans`` is empty when the rule holds nothing\nall day, which for all three is the ordinary case: 23 of the 27 nakshatras\ncarry no shool at all, and 42 of the corpus's 79 days never enter a Bhadra.\n\n``parihara`` is a value on Disha Shool and null on the other nine, because it\nis the only one of the ten with a remedy to publish. Null there too on a\nFriday, which is a statement about the sources rather than about the day -- see\n:class:`NivasShool`. The service builds the row without the key at all where\nthere is nothing to say and this model fills the null, which is the ordinary\ndefault and not a third meaning: a reader can only see \"a remedy\" or \"none\"."},"NivasShoolSpan":{"properties":{"value":{"type":"string","title":"Value","description":"The value this rule holds over the span"},"start":{"type":"string","format":"date-time","title":"Start","description":"When this stretch begins; at or after this day's sunrise"},"end":{"type":"string","format":"date-time","title":"End","description":"When this stretch ends; at or before the next sunrise"}},"type":"object","required":["value","start","end"],"title":"NivasShoolSpan","description":"One stretch of the day over which one Nivas or Shool rule holds one value.\n\nHalf-open ``[start, end)`` and **clipped to the day**, like\n:class:`AnandadiSpan` and unlike :class:`LimbSpan`. The reason is the same one\nthe Anandadi rows give and then some: these values are functions of keys that\ncan hold for days -- Kumbha Chakra's North covers four counts, so four\nnakshatras, up to a week -- and no almanac prints that extent. The row a\npanchangam prints is this day's row.\n\nAdjacent stretches with the same value are ONE span, not two. The Moon\ncrossing from count 12 to count 13 leaves Kumbha Chakra in the West and the\nalmanac prints one line; publishing two would show a turn that did not happen."},"NumerologyAnalysis":{"properties":{"destiny_number":{"type":"integer","maximum":9.0,"minimum":1.0,"title":"Destiny Number"},"soul_number":{"type":"integer","maximum":9.0,"minimum":1.0,"title":"Soul Number"},"personality_number":{"type":"integer","maximum":9.0,"minimum":1.0,"title":"Personality Number"},"overall_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Overall Score"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["destiny_number","soul_number","personality_number","overall_score","interpretation"],"title":"NumerologyAnalysis","description":"Numerological analysis of a name.\n\nAttributes:\n destiny_number: Sum of all letters reduced to single digit\n soul_number: Sum of vowels\n personality_number: Sum of consonants\n overall_score: Compatibility score (0-100)\n interpretation: Brief interpretation"},"OccultationEventOut":{"properties":{"event_id":{"type":"string","title":"Event Id"},"body":{"type":"string","title":"Body","description":"The graha covered, or the nakshatra whose star it is"},"body_display":{"type":"string","title":"Body Display"},"body_kind":{"$ref":"#/components/schemas/OccultedBodyKind"},"global_maximum":{"type":"string","format":"date-time","title":"Global Maximum","description":"Greatest coverage somewhere on Earth — always present"},"central_latitude":{"type":"number","title":"Central Latitude","description":"Where the covering runs centrally, when there is a central line"},"central_longitude":{"type":"number","title":"Central Longitude"},"magnitude":{"type":"number","title":"Magnitude"},"obscuration":{"type":"number","title":"Obscuration"},"separation_degrees":{"type":"number","title":"Separation Degrees"},"moon_illumination":{"type":"number","title":"Moon Illumination","description":"Lit fraction of the Moon: a dark limb is the cleanest form of this sight"},"longitude":{"type":"number","title":"Longitude","description":"Sidereal longitude of the covered body"},"degree_in_rashi":{"type":"number","title":"Degree In Rashi"},"rashi":{"type":"string","title":"Rashi"},"rashi_display":{"type":"string","title":"Rashi Display"},"rashi_index":{"type":"integer","title":"Rashi Index"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_display":{"type":"string","title":"Nakshatra Display"},"retrograde":{"type":"boolean","title":"Retrograde"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"visible_here":{"type":"boolean","title":"Visible Here","description":"False when the place sees none of it, and then `local` is absent"},"local":{"$ref":"#/components/schemas/LocalCircumstancesOut"},"why_not":{"type":"string","title":"Why Not","description":"Why this place sees nothing, when it sees nothing"},"reading":{"$ref":"#/components/schemas/OccultationReading"},"all_rashis":{"items":{"$ref":"#/components/schemas/OccultationReading"},"type":"array","title":"All Rashis"},"remedies":{"$ref":"#/components/schemas/OccultationRemedy"},"omen":{"allOf":[{"$ref":"#/components/schemas/StarOmen"}],"title":"Omen","description":"Star occultations only, and they carry no per-rashi reading"}},"type":"object","required":["event_id","body","body_kind","global_maximum","moon_illumination","longitude","degree_in_rashi","rashi","rashi_index","nakshatra","retrograde","ayanamsa","visible_here"],"title":"OccultationEventOut"},"OccultationReading":{"properties":{"rashi":{"type":"string","title":"Rashi"},"rashi_hi":{"type":"string","title":"Rashi Hi"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"domain":{"type":"string","title":"Domain"},"intensity":{"type":"string","title":"Intensity"},"intensity_label":{"type":"string","title":"Intensity Label"},"intensity_score":{"type":"integer","title":"Intensity Score"},"factors":{"items":{"type":"object"},"type":"array","title":"Factors","description":"Every signal and its weight, so the score can be checked rather than believed"},"sentences":{"items":{"type":"string"},"type":"array","title":"Sentences"},"effect":{"type":"string","title":"Effect"},"lord":{"type":"object","title":"Lord"},"visible":{"type":"boolean","title":"Visible","description":"False where the covering passes below this horizon — read as astronomy, not omen"},"basis":{"type":"string","title":"Basis"},"language":{"type":"string","title":"Language"}},"type":"object","required":["rashi","house","domain","intensity","intensity_label","intensity_score","sentences","effect","lord","visible","basis","language"],"title":"OccultationReading"},"OccultationRemedy":{"properties":{"for_graha":{"type":"string","title":"For Graha"},"for_graha_display":{"type":"string","title":"For Graha Display"},"why":{"type":"string","title":"Why"},"mantra":{"type":"object","title":"Mantra"},"daan":{"items":{"type":"string"},"type":"array","title":"Daan"},"day":{"type":"string","title":"Day"},"no_sutak":{"type":"string","title":"No Sutak","description":"Stated every time: the Moon in front of a graha is not the Moon in front of the Sun"}},"type":"object","required":["for_graha","for_graha_display","why","mantra","no_sutak"],"title":"OccultationRemedy"},"OccultationResult":{"properties":{"total_count":{"type":"integer","title":"Total Count","description":"Occultations found in the horizon, anywhere on Earth"},"visible_count":{"type":"integer","title":"Visible Count","description":"Of those, how many this place actually sees. Often none for years"},"graha_count":{"type":"integer","title":"Graha Count"},"star_count":{"type":"integer","title":"Star Count"},"searched_from":{"type":"string","format":"date-time","title":"Searched From"},"searched_to":{"type":"string","format":"date-time","title":"Searched To"},"horizon_years":{"type":"integer","title":"Horizon Years"},"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"rashi":{"type":"string","title":"Rashi"},"language":{"type":"string","title":"Language"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes","description":"What could not be computed at all — e.g. a nakshatra star this deployment has no catalogue for"},"events":{"items":{"$ref":"#/components/schemas/OccultationEventOut"},"type":"array","title":"Events"}},"type":"object","required":["total_count","visible_count","graha_count","star_count","searched_from","searched_to","horizon_years","ayanamsa","language","events"],"title":"OccultationResult"},"OccultedBodyKind":{"type":"string","enum":["graha","star"],"title":"OccultedBodyKind","description":"An enumeration."},"OjhayugmaRashiBala":{"properties":{"planet":{"type":"string","title":"Planet"},"rashi_sign":{"type":"integer","title":"Rashi Sign"},"navamsha_sign":{"type":"integer","title":"Navamsha Sign"},"is_odd_sign_rashi":{"type":"boolean","title":"Is Odd Sign Rashi"},"is_odd_sign_navamsha":{"type":"boolean","title":"Is Odd Sign Navamsha"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","rashi_sign","navamsha_sign","is_odd_sign_rashi","is_odd_sign_navamsha","strength_virupas"],"title":"OjhayugmaRashiBala","description":"Odd/Even sign strength."},"OperationsProvider":{"properties":{"id":{"type":"string","title":"Id"},"display_name":{"type":"string","title":"Display Name"},"title":{"type":"string","title":"Title"}},"type":"object","required":["id","display_name"],"title":"OperationsProvider"},"PakshaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"is_shukla_paksha":{"type":"boolean","title":"Is Shukla Paksha"},"moon_phase_strength":{"type":"number","title":"Moon Phase Strength"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","is_shukla_paksha","moon_phase_strength","strength_virupas"],"title":"PakshaBala","description":"Lunar fortnight strength."},"PanchaMahapurushaYoga":{"properties":{"name":{"type":"string","title":"Name"},"planet":{"type":"string","title":"Planet"},"is_present":{"type":"boolean","title":"Is Present"},"strength":{"type":"string","title":"Strength"},"strength_percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Strength Percentage","default":0.0},"house":{"type":"integer","title":"House"},"sign":{"type":"string","title":"Sign"},"is_exalted":{"type":"boolean","title":"Is Exalted","default":false},"is_own_sign":{"type":"boolean","title":"Is Own Sign","default":false},"physical_effects":{"type":"string","title":"Physical Effects","default":""},"personality_effects":{"type":"string","title":"Personality Effects","default":""},"career_effects":{"type":"string","title":"Career Effects","default":""},"wealth_effects":{"type":"string","title":"Wealth Effects","default":""},"status_effects":{"type":"string","title":"Status Effects","default":""}},"type":"object","required":["name","planet","is_present","strength"],"title":"PanchaMahapurushaYoga","description":"Detailed data for Pancha Mahapurusha yogas.\n\nThese are 5 special yogas formed by Mars, Mercury, Jupiter,\nVenus, or Saturn in own/exalted sign in Kendra.\n\nAttributes:\n name: Yoga name (Ruchaka, Bhadra, Hamsa, Malavya, Shasha)\n planet: The planet forming this yoga\n is_present: Whether this yoga exists in the chart\n strength: Strength of the yoga\n house: House where planet is placed\n sign: Sign where planet is placed\n is_exalted: Whether planet is exalted\n is_own_sign: Whether planet is in own sign\n physical_effects: Physical characteristics bestowed\n personality_effects: Personality traits\n career_effects: Career indications\n wealth_effects: Wealth indications\n status_effects: Status/position indications"},"PanchakaBand":{"properties":{"name":{"type":"string","title":"Name","description":"Mrityu, Agni, Raja, Chora, Roga, or Shubha"},"is_shubha":{"type":"boolean","title":"Is Shubha","description":"True when this stretch carries none of the five"},"tithi":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Tithi","description":"The tithi in force, 1..30 counted continuously from Shukla Pratipada"},"nakshatra":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Nakshatra","description":"The Moon's nakshatra, on the 27-fold division"},"lagna":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Lagna","description":"The rising rashi, 1 = Mesha"},"lagna_name":{"type":"string","title":"Lagna Name","description":"That rashi's Sanskrit name"},"start":{"type":"string","format":"date-time","title":"Start","description":"When this band begins; at or after this day's sunrise"},"end":{"type":"string","format":"date-time","title":"End","description":"When it ends; at or before the next sunrise"}},"type":"object","required":["name","is_shubha","tithi","nakshatra","lagna","lagna_name","start","end"],"title":"PanchakaBand","description":"One stretch of the day over which the five-fold Panchaka rule holds.\n\n``name`` is one of \"Mrityu\", \"Agni\", \"Raja\", \"Chora\", \"Roga\" -- the five --\nor \"Shubha\" for the stretches that carry none of them, which is what the\ntable's own title means: *Panchaka Rahita*, without the five. Shubha is a\npositive answer and not an absence, so ``is_shubha`` carries it as a boolean\nrather than leaving a client to compare strings.\n\nThe three intra-day factors travel with the band, and that is not debug\noutput. Two ADJACENT bands can carry the same name -- see the field\ndescription on `PanchangResponse.panchaka` -- and a reader looking at \"Shubha\nupto 12:45, Shubha upto 14:32\" needs to see that the rising sign changed\nbetween them, or the table reads as a bug rather than as the almanac's own row.\nThe fourth factor is the vara, which is constant for the whole Hindu day and\npublished once, at the top of this response.\n\nNOT the same rule as `/advanced-muhurta/panchaka`. That one asks whether the\nMoon stands in the last 60 degrees of the zodiac and answers once for the whole\nday, which is what a reader asking \"is today Panchak\" usually means. This is\nthe band schedule a printed almanac prints. The two will disagree about the\nsame day, often, and neither is a better version of the other."},"PanchakaResponse":{"properties":{"date":{"type":"string","title":"Date"},"has_panchaka":{"type":"boolean","title":"Has Panchaka"},"panchaka_type":{"type":"string","title":"Panchaka Type"},"severity":{"type":"string","title":"Severity"},"affected_activities":{"items":{"type":"string"},"type":"array","title":"Affected Activities"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"},"description":{"type":"string","title":"Description"}},"type":"object","required":["date","has_panchaka","severity","description"],"title":"PanchakaResponse","description":"GET /advanced-muhurta/panchaka"},"PanchangCabinetOffice":{"properties":{"office":{"type":"string","title":"Office","description":"raja, mantri, senadhipati, …"},"lord":{"type":"string","title":"Lord","description":"Graha ruling the office, e.g. Jupiter"},"anchor":{"type":"string","title":"Anchor","description":"lunar_new_year, sankranti or nakshatra"},"anchor_date":{"type":"string","format":"date","title":"Anchor Date"}},"type":"object","required":["office","lord","anchor","anchor_date"],"title":"PanchangCabinetOffice","description":"One of the ten offices, and the moment its lord was read from.\n\n`anchor_date` is the sunrise-to-sunrise day whose vara lord the office is,\npublished so the assignment can be checked rather than taken on faith."},"PanchangCalendarContext":{"properties":{"community_observances":{"items":{"$ref":"#/components/schemas/CommunityObservance"},"type":"array","title":"Community Observances"},"selected":{"$ref":"#/components/schemas/PanchangSelectedCalendar"},"amanta":{"$ref":"#/components/schemas/PanchangMonthFraming"},"purnimanta":{"$ref":"#/components/schemas/PanchangMonthFraming"},"traditional_years":{"$ref":"#/components/schemas/PanchangTraditionalYears"},"epoch":{"$ref":"#/components/schemas/PanchangEpochCounts"},"mantri_mandala":{"$ref":"#/components/schemas/PanchangMantriMandala"},"solar_month":{"$ref":"#/components/schemas/PanchangSolarMonthDay"}},"type":"object","required":["selected","amanta","purnimanta","traditional_years"],"title":"PanchangCalendarContext"},"PanchangEpochCounts":{"properties":{"rata_die":{"type":"integer","title":"Rata Die","description":"Days since 1 January 1 CE (proleptic Gregorian)"},"julian_day":{"type":"number","title":"Julian Day","description":"JD at 00:00 UT of the civil date"},"modified_julian_day":{"type":"integer","title":"Modified Julian Day"},"kali_ahargana":{"type":"integer","title":"Kali Ahargana","description":"Elapsed days from the Kali Yuga epoch, JD 588465.5. Not the Kalpa ahargana used internally as a Kalachakra seed."},"julian_calendar_date":{"type":"string","format":"date","title":"Julian Calendar Date","description":"The same day in the Julian calendar, 13 days behind at present"},"national_civil_date":{"$ref":"#/components/schemas/PanchangNationalCivilDate"},"julian_day_convention":{"type":"string","title":"Julian Day Convention"},"kali_ahargana_epoch_jd":{"type":"number","title":"Kali Ahargana Epoch Jd"}},"type":"object","required":["rata_die","julian_day","modified_julian_day","kali_ahargana","julian_calendar_date","national_civil_date","julian_day_convention","kali_ahargana_epoch_jd"],"title":"PanchangEpochCounts","description":"Day counts a reader can check our idea of the day against.\n\nAll exact integer arithmetic on the Rata Die day number, so the only thing\nthat can be wrong here is the date itself — which is the point of publishing\nthem."},"PanchangMantriMandala":{"properties":{"year_start":{"type":"string","format":"date","title":"Year Start","description":"Chaitra Shukla Pratipada it turns on"},"samvatsara":{"type":"string","title":"Samvatsara"},"offices":{"items":{"$ref":"#/components/schemas/PanchangCabinetOffice"},"type":"array","title":"Offices"},"day_boundary":{"type":"string","title":"Day Boundary","description":"sunrise — each office reads a sunrise-to-sunrise day"}},"type":"object","required":["year_start","offices","day_boundary"],"title":"PanchangMantriMandala","description":"The samvatsara's cabinet — a property of the year, not of the day."},"PanchangMonthFraming":{"properties":{"month_roman":{"type":"string","title":"Month Roman"},"month_label":{"type":"string","title":"Month Label"},"paksha":{"type":"string","title":"Paksha"},"is_adhika_masa":{"type":"boolean","title":"Is Adhika Masa","default":false},"is_kshaya_masa":{"type":"boolean","title":"Is Kshaya Masa","default":false},"sankranti_count":{"type":"integer","title":"Sankranti Count","default":1},"is_shunya_masa":{"type":"boolean","title":"Is Shunya Masa"},"shunya_masa_rule":{"type":"string","title":"Shunya Masa Rule"},"month_start":{"type":"string","title":"Month Start"}},"type":"object","required":["month_roman","month_label","month_start"],"title":"PanchangMonthFraming"},"PanchangNationalCivilDate":{"properties":{"saka_year":{"type":"integer","title":"Saka Year"},"month_index":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month Index"},"month":{"type":"string","title":"Month"},"day":{"type":"integer","maximum":31.0,"minimum":1.0,"title":"Day"}},"type":"object","required":["saka_year","month_index","month","day"],"title":"PanchangNationalCivilDate","description":"The Indian National Calendar's date — tropical and arithmetic.\n\nNot a second opinion on the solar month: Chaitra 1 is fixed to 21/22 March\nand the month lengths are fixed, so it agrees with no sankranti."},"PanchangQueryLocation":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","maxLength":100,"title":"Timezone"}},"type":"object","required":["latitude","longitude","timezone"],"title":"PanchangQueryLocation"},"PanchangQueryRequest":{"properties":{"question":{"type":"string","maxLength":500,"minLength":1,"title":"Question"},"location":{"$ref":"#/components/schemas/PanchangQueryLocation"},"asked_at":{"type":"string","format":"date-time","title":"Asked At"}},"type":"object","required":["question","location"],"title":"PanchangQueryRequest","description":"Answer a natural-language Panchang question.\n\nDeliberately unauthenticated and unpersisted: an almanac lookup does not\ndepend on who is asking, so it must not be gated behind the querent\ndemographics that the horary inquiry flow requires."},"PanchangQueryResponse":{"properties":{"question":{"type":"string","title":"Question"},"answer":{"type":"string","title":"Answer"},"aspects":{"items":{"type":"string"},"type":"array","title":"Aspects"},"aspect_labels":{"items":{"type":"string"},"type":"array","title":"Aspect Labels"},"date":{"type":"string","title":"Date","description":"Resolved target date, YYYY-MM-DD"},"resolved_date_label":{"type":"string","title":"Resolved Date Label"},"location":{"$ref":"#/components/schemas/PanchangQueryLocation"},"display_payload":{"type":"object","title":"Display Payload"},"panchang":{"type":"object","title":"Panchang"}},"type":"object","required":["question","answer","date","resolved_date_label","location"],"title":"PanchangQueryResponse"},"PanchangRegionalCalendar":{"properties":{"system":{"type":"string","title":"System","description":"Regional calendar system, e.g. tamil"},"month":{"type":"string","title":"Month","description":"Civil month name in the regional calendar"},"weekday":{"type":"string","title":"Weekday","description":"Civil weekday name in the regional calendar"},"year":{"type":"string","title":"Year","description":"Civil year, as a string"}},"type":"object","required":["system","month","weekday","year"],"title":"PanchangRegionalCalendar","description":"The requested regional calendar's names for this CIVIL date.\n\nThinner than :class:`PanchangCalendarContext` and not a substitute for it:\nthese are the Gregorian month and weekday rendered in a regional script, not\na lunar month. ``year`` is the civil year as a string, which is the shape\n``get_regional_date_format`` returns.\n\nDeclared because the drift guard found it undeclared, which is a latent loss\nrather than a live one: today only ``/export/pdf`` passes\n``regional_calendar`` through to the service, and that path streams a PDF\nwithout going near this model. The first JSON endpoint to accept the\nparameter would have computed this block and had it deleted on the way out."},"PanchangRequest":{"properties":{"date":{"anyOf":[{"type":"string"},{"type":"string","format":"date-time"}],"title":"Date","description":"Date and time for Panchang calculation"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Latitude of the location"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Longitude of the location"},"timezone":{"type":"string","title":"Timezone","description":"Timezone of the location","default":"UTC"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa","default":"Lahiri"},"calendar_system":{"type":"string","title":"Calendar System","description":"Calendar framing: vikram, saka, gujarati, marathi, kannada, telugu, tamil, malayalam, bengali, or odia","default":"vikram"},"lunar_month_system":{"type":"string","title":"Lunar Month System","description":"Preferred lunar month convention: amanta or purnimanta"}},"type":"object","required":["date","latitude","longitude"],"title":"PanchangRequest","description":"Request model for Panchang calculations.\n\nAttributes:\n date: Date and time for which to calculate Panchang\n latitude: Latitude of the location (-90 to 90)\n longitude: Longitude of the location (-180 to 180)\n timezone: Timezone of the location (default: the zone of the coordinates)"},"PanchangResponse":{"properties":{"date":{"type":"string","title":"Date","description":"Date of the Panchang calculation"},"tithi":{"allOf":[{"$ref":"#/components/schemas/Tithi"}],"title":"Tithi","description":"Information about the Tithi"},"nakshatra":{"allOf":[{"$ref":"#/components/schemas/Nakshatra"}],"title":"Nakshatra","description":"Information about the Nakshatra"},"moon_rashi":{"allOf":[{"$ref":"#/components/schemas/MoonRashi"}],"title":"Moon Rashi","description":"The Moon's sidereal sign — the Janma Rashi for a birth instant"},"yoga":{"allOf":[{"$ref":"#/components/schemas/Yoga"}],"title":"Yoga","description":"Information about the Yoga"},"karana":{"allOf":[{"$ref":"#/components/schemas/Karana"}],"title":"Karana","description":"Information about the Karana"},"vara":{"allOf":[{"$ref":"#/components/schemas/VaraInfo"}],"title":"Vara","description":"Information about the Vara"},"sunrise":{"type":"string","title":"Sunrise","description":"Sunrise time in ISO format"},"sunset":{"type":"string","title":"Sunset","description":"Sunset time in ISO format"},"sun_times_are_observed":{"type":"boolean","title":"Sun Times Are Observed","description":"False when the sun neither rose nor set at this place on this date, so sunrise and sunset are a notional twelve-hour day centred on the sun's culmination and every daylight window is conventional","default":true},"night_windows_are_observed":{"type":"boolean","title":"Night Windows Are Observed","description":"False when the previous sunset or the next sunrise was substituted, making Brahma Muhurta, Nishita Muhurta, Godhuli and both sandhyas conventional even where this day's own sun times are observed","default":true},"sun_times_note":{"type":"string","title":"Sun Times Note","description":"Why the sun times are conventional, when they are"},"moonrise":{"type":"string","title":"Moonrise","description":"Moonrise time in ISO format"},"moonset":{"type":"string","title":"Moonset","description":"Moonset time in ISO format"},"rahu_kaal":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Rahu Kaal","description":"Time range for Rahu Kaal"},"abhijit_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Abhijit Muhurat","description":"Time range for Abhijit Muhurat; null on Wednesday"},"gulika_kaal":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Gulika Kaal","description":"Time range for Gulika Kaal"},"yamaganda":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Yamaganda","description":"Time range for Yamaganda"},"vijaya_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Vijaya Muhurat","description":"Vijaya Muhurta: the 11th of the 15 daylight muhurtas"},"nishita_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Nishita Muhurat","description":"Nishita Muhurta: the 8th of the 15 night muhurtas, around solar midnight"},"brahma_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Brahma Muhurat","description":"Brahma Muhurta: the 14th muhurta of the preceding night"},"godhuli_muhurat":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Godhuli Muhurat","description":"Godhuli Muhurta: one night ghatika beginning at sunset"},"pratah_sandhya":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Pratah Sandhya","description":"Dawn sandhya: three night ghatikas ending at sunrise"},"sayahna_sandhya":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Sayahna Sandhya","description":"Dusk sandhya: three night ghatikas beginning at sunset"},"pradosh_kaal":{"allOf":[{"$ref":"#/components/schemas/TimeRange"}],"title":"Pradosh Kaal","description":"Pradosh Kaal: three night muhurtas beginning at sunset"},"dur_muhurtam":{"items":{"$ref":"#/components/schemas/TimeRange"},"type":"array","title":"Dur Muhurtam","description":"Dur Muhurtam windows for the vara; one or two a day, Tuesday's second at night"},"amrit_kaal_windows":{"items":{"$ref":"#/components/schemas/TimeRange"},"type":"array","title":"Amrit Kaal Windows","description":"Every Amrit Kaal window beginning in this sunrise-to-sunrise day"},"varjya_kaal_windows":{"items":{"$ref":"#/components/schemas/TimeRange"},"type":"array","title":"Varjya Kaal Windows","description":"Every Varjyam window beginning in this sunrise-to-sunrise day"},"bhadra_kaal_windows":{"items":{"$ref":"#/components/schemas/TimeRange"},"type":"array","title":"Bhadra Kaal Windows","description":"Every Bhadra (Vishti karana) window touching this day; usually empty"},"lunar_phase":{"allOf":[{"$ref":"#/components/schemas/LunarPhaseInfo"}],"title":"Lunar Phase","description":"Information about the lunar phase"},"hora":{"items":{"$ref":"#/components/schemas/HoraPeriod"},"type":"array","title":"Hora","description":"24 planetary hours: 12 of daylight then 12 of night"},"choghadiya":{"items":{"$ref":"#/components/schemas/ChoghadiyaPeriod"},"type":"array","title":"Choghadiya","description":"16 choghadiyas: 8 of daylight then 8 of night"},"gowri":{"items":{"$ref":"#/components/schemas/GowriPeriod"},"type":"array","title":"Gowri","description":"16 Gowri Panchangam slots: 8 of daylight then 8 of night"},"sandhi":{"type":"object","title":"Sandhi","description":"Junction periods (gandanta, abhukta mula) and their advice"},"scores":{"additionalProperties":{"type":"number"},"type":"object","title":"Scores","description":"Per-activity auspiciousness scores for the day, 0-1"},"ephemeris_system":{"type":"string","title":"Ephemeris System","description":"Ephemeris system used"},"month_start_date":{"type":"string","title":"Month Start Date","description":"Start of the current lunar month, ISO format"},"is_dst":{"type":"boolean","title":"Is Dst","description":"Whether the location is on daylight saving time on this day"},"dst_offset_hours":{"type":"number","title":"Dst Offset Hours","description":"Daylight saving offset in hours, 0.0 when not in effect"},"timezone":{"type":"string","title":"Timezone","description":"Timezone used for the calculation"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Latitude used for the calculation"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Longitude used for the calculation"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa used","default":"Lahiri"},"lunar_month":{"type":"string","title":"Lunar Month","description":"Lunar month under the requested convention, prefixed \"Adhika \" when intercalary. Match on is_adhika_masa rather than parsing this."},"is_adhika_masa":{"type":"boolean","title":"Is Adhika Masa","description":"True when the lunar month is intercalary — no sankranti falls inside the lunation. Festivals are not observed in an Adhika masa."},"month_start_system":{"type":"string","title":"Month Start System","description":"Amanta or Purnimanta"},"ritu":{"type":"string","title":"Ritu","description":"Season under the sāyana (tropical) reckoning, which is the row Drik Panchang prints as \"Drik Ritu\". Vasanta opens at tropical Pisces, so the seasons hinge on the equinoxes and solstices."},"vedic_ritu":{"type":"string","title":"Vedic Ritu","description":"Season under the lunar reckoning (\"Vedic Ritu\"), two Amanta months to a season. Usually differs from ritu — both are published because both are in common use."},"ayana":{"type":"string","title":"Ayana","description":"Half-year under the sāyana (tropical) reckoning, which is the row Drik Panchang prints as plain \"Ayana\": Uttarayana from the December solstice to the June one. NOT the popular Uttarayana — that is vedic_ayana, three weeks later."},"vedic_ayana":{"type":"string","title":"Vedic Ayana","description":"Half-year under the nirayana (sidereal) reckoning (\"Vedic Ayana\"), turning at Makara and Karka Sankranti. Moves with ayanamsa, unlike vedic_ritu, which is lunar."},"day_duration_seconds":{"type":"number","title":"Day Duration Seconds","description":"Dinamana — sunrise to sunset, in seconds. Conventional when sun_times_are_observed is false."},"night_duration_seconds":{"type":"number","title":"Night Duration Seconds","description":"Ratrimana — this sunset to the NEXT sunrise, in seconds. Does not sum with day_duration_seconds to exactly 86400: the day length changes overnight."},"madhyahna":{"type":"string","title":"Madhyahna","description":"Solar noon in ISO format — the midpoint of sunrise and sunset, so it is checkable against those two fields"},"surya_nakshatra":{"allOf":[{"$ref":"#/components/schemas/SuryaNakshatra"}],"title":"Surya Nakshatra","description":"The Sun's sidereal nakshatra and pada at sunrise"},"ayanamsa_degrees":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Ayanamsa Degrees","description":"Size of the named ayanamsa at this sunrise, as applied: tropical − this == sidereal for every longitude in this response. The true value (nutation included), so it runs ~18″ under Drik's printed Lahiri, which is mean and a different Lahiri variant."},"regional_calendar":{"allOf":[{"$ref":"#/components/schemas/PanchangRegionalCalendar"}],"title":"Regional Calendar","description":"Civil month and weekday in the requested regional calendar, when one was named"},"calendar_context":{"allOf":[{"$ref":"#/components/schemas/PanchangCalendarContext"}],"title":"Calendar Context","description":"Selected calendar month plus Vikram, Shaka and Kali Yuga years"},"anandadi":{"items":{"$ref":"#/components/schemas/AnandadiSpan"},"type":"array","title":"Anandadi","description":"Every Anandadi span touching this day, with its Tamil verdict. One of the 28 members is in force at every instant, so this is a graded cycle like the five limbs and not a list of coincidences."},"special_yogas":{"items":{"$ref":"#/components/schemas/SpecialYoga"},"type":"array","title":"Special Yogas","description":"Every special yoga in force at any point of this Hindu day, with the window it holds -- Amrit Siddhi, the Pushkaras, Ravi Yoga, the doshas and the rest. One entry per window, so a yoga firing twice appears twice; the three Tamil verdicts are in `anandadi` instead. Present only for the single-day endpoint."},"chandrashtama":{"items":{"$ref":"#/components/schemas/ChandrashtamaRow"},"type":"array","title":"Chandrashtama","description":"Whose Chandrashtama this day is -- one row per rashi the Moon transits between this sunrise and the next, each naming the afflicted rashi and its janma nakshatras by pada. Needs no chart; the personal alert that reads a saved Moon is a separate, narrower thing. Present only for the single-day endpoint."},"nivas_shool":{"allOf":[{"$ref":"#/components/schemas/NivasShool"}],"title":"Nivas Shool","description":"The nine Nivas and Shool rows -- where Agni, Shiva, the Moon and Rahu dwell, which directions the weekday and the nakshatra bar, the fire's recipient, the pot and the arrow. Each carries the value at sunrise and every stretch of the day, because most of them turn intra-day. Present only for the single-day endpoint."},"udaya_lagna":{"items":{"$ref":"#/components/schemas/UdayaLagnaRow"},"type":"array","title":"Udaya Lagna","description":"Which rashi is rising, and until when, from this sunrise to the next. Day-clipped. Thirteen rows usually and fourteen about once a month: twelve are the full circuit, and what follows them is the few minutes the Hindu day runs past one sidereal rotation, which is one more sign on the morning when the sign rising at sunrise has less than that left. The one table here that depends on the latitude as well as the instant. Present only for the single-day endpoint."},"panchaka":{"items":{"$ref":"#/components/schemas/PanchakaBand"},"type":"array","title":"Panchaka","description":"Panchaka Rahita as a band schedule: which of the five afflictions is in force, and when, cut at every tithi, nakshatra and lagna ingress of the Hindu day. Fifteen bands on an average day and sixteen when a limb turns twice. \n\nTWO THINGS A CLIENT MUST NOT DO. Do not merge adjacent bands sharing a name: every ingress advances the rule's sum by one and so changes the name, except at the Meena->Mesha and Amavasya->Pratipada wraps, where it falls by 11 and by 29 -- both -2 modulo 9 -- and can land inside Shubha twice running. The source prints those twice, twelve times in the month this was derived against. And do not collapse a short band: they can be one minute long, and the same source prints two of them zero-length. \n\nNot the same rule as `/advanced-muhurta/panchaka`, which asks about the Moon's longitude and answers once a day. Present only for the single-day endpoint."}},"type":"object","required":["date","tithi","nakshatra","yoga","karana","vara","sunrise","sunset","rahu_kaal","gulika_kaal","yamaganda","lunar_phase"],"title":"PanchangResponse","description":"Response model for Panchang calculations.\n\nAttributes:\n date: Date of the Panchang calculation\n tithi: Information about the Tithi\n nakshatra: Information about the Nakshatra\n yoga: Information about the Yoga\n karana: Information about the Karana\n vara: Information about the Vara\n sunrise: Sunrise time in ISO format\n sunset: Sunset time in ISO format\n rahu_kaal: Time range for Rahu Kaal\n abhijit_muhurat: Time range for Abhijit Muhurat, or null on Wednesday\n gulika_kaal: Time range for Gulika Kaal\n yamaganda: Time range for Yamaganda\n lunar_phase: Information about the lunar phase"},"PanchangSelectedCalendar":{"properties":{"system":{"type":"string","title":"System"},"system_name":{"type":"string","title":"System Name"},"reckoning":{"type":"string","title":"Reckoning"},"month_start":{"type":"string","title":"Month Start"},"era_name":{"type":"string","title":"Era Name"},"era_year":{"type":"integer","title":"Era Year"},"month_roman":{"type":"string","title":"Month Roman"},"month_native":{"type":"string","title":"Month Native"},"month_index":{"type":"integer","title":"Month Index"},"paksha":{"type":"string","title":"Paksha"},"is_adhika_masa":{"type":"boolean","title":"Is Adhika Masa","default":false},"is_kshaya_masa":{"type":"boolean","title":"Is Kshaya Masa","default":false},"sankranti_count":{"type":"integer","title":"Sankranti Count","default":1},"is_shunya_masa":{"type":"boolean","title":"Is Shunya Masa"},"shunya_masa_rule":{"type":"string","title":"Shunya Masa Rule"},"samvatsara":{"type":"string","title":"Samvatsara"},"month_label":{"type":"string","title":"Month Label"},"new_year_anchor":{"type":"string","title":"New Year Anchor"},"solar_rashi":{"type":"string","title":"Solar Rashi"}},"type":"object","required":["system","system_name","reckoning","month_start","era_name","era_year","month_roman","month_index","month_label","new_year_anchor"],"title":"PanchangSelectedCalendar"},"PanchangSolarMonthDay":{"properties":{"day":{"type":"integer","maximum":32.0,"minimum":1.0,"title":"Day"},"rashi_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Rashi Index"},"rashi":{"type":"string","title":"Rashi"},"started_on":{"type":"string","format":"date","title":"Started On","description":"Civil date of the opening sankranti"},"sankranti_at":{"type":"string","format":"date-time","title":"Sankranti At","description":"The ingress instant, in local time"},"sankranti_today":{"type":"boolean","title":"Sankranti Today","description":"Whether that ingress falls on this civil day"},"day_boundary":{"type":"string","title":"Day Boundary"},"next_sankranti_at":{"type":"string","format":"date-time","title":"Next Sankranti At"},"next_rashi":{"type":"string","title":"Next Rashi"}},"type":"object","required":["day","rashi_index","rashi","started_on","sankranti_at","sankranti_today","day_boundary"],"title":"PanchangSolarMonthDay","description":"Day of the solar month: Pravishte in Punjab, Gate in Nepal.\n\nDay 1 is the civil date of the sankranti instant, counted by civil day, so a\nmonth carries 29 to 32 days and `day_boundary` is not the sunrise the rest of\nthe panchang uses."},"PanchangTraditionalYears":{"properties":{"vikram_samvat":{"type":"integer","title":"Vikram Samvat"},"shaka_samvat":{"type":"integer","title":"Shaka Samvat"},"kali_yuga":{"type":"integer","title":"Kali Yuga"},"samvatsara":{"type":"string","title":"Samvatsara"},"kali_yuga_convention":{"type":"string","title":"Kali Yuga Convention"}},"type":"object","required":["vikram_samvat","shaka_samvat","kali_yuga","kali_yuga_convention"],"title":"PanchangTraditionalYears"},"PanchangaData":{"properties":{"tithi":{"type":"string","title":"Tithi"},"tithi_lord":{"type":"string","title":"Tithi Lord"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_lord":{"type":"string","title":"Nakshatra Lord"},"yoga_name":{"type":"string","title":"Yoga Name"},"karana":{"type":"string","title":"Karana"},"vara":{"type":"string","title":"Vara"},"vara_lord":{"type":"string","title":"Vara Lord"},"hora_lord":{"type":"string","title":"Hora Lord"}},"type":"object","required":["tithi","tithi_lord","nakshatra","nakshatra_lord","yoga_name","karana","vara","vara_lord","hora_lord"],"title":"PanchangaData","description":"Varsha Pravesh Panchanga elements"},"Participant":{"properties":{"graha":{"type":"string","title":"Graha"},"graha_display":{"type":"string","title":"Graha Display","description":"The graha in the reader's script"},"longitude":{"type":"number","title":"Longitude","description":"Sidereal longitude at the peak, degrees"},"degree_in_rashi":{"type":"number","title":"Degree In Rashi"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_display":{"type":"string","title":"Nakshatra Display"},"retrograde":{"type":"boolean","title":"Retrograde"},"latitude":{"type":"number","title":"Latitude","description":"Ecliptic latitude — the yuddha verdict rests on it"},"entered":{"type":"string","format":"date-time","title":"Entered","description":"First sampled inside this rashi, UTC"},"left":{"type":"string","format":"date-time","title":"Left","description":"Last sampled inside this rashi, UTC"}},"type":"object","required":["graha","longitude","degree_in_rashi","nakshatra","retrograde","latitude","entered","left"],"title":"Participant"},"PersonalCalendarOut":{"properties":{"period_start":{"type":"string","title":"Period Start"},"period_end":{"type":"string","title":"Period End"},"location":{"$ref":"#/components/schemas/app__routers__astro_calendar__LocationOut"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"days":{"items":{"$ref":"#/components/schemas/CalendarDayOut"},"type":"array","title":"Days"},"selected_day":{"$ref":"#/components/schemas/DayAnalysisOut"},"power_days":{"items":{"$ref":"#/components/schemas/PowerDayOut"},"type":"array","title":"Power Days"},"unavailable_dates":{"items":{"type":"string"},"type":"array","title":"Unavailable Dates"}},"type":"object","required":["period_start","period_end","location","ayanamsa","days","power_days","unavailable_dates"],"title":"PersonalCalendarOut"},"PersonalCalendarRequest":{"properties":{"target_date":{"type":"string","format":"date","title":"Target Date"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","format":"iana-timezone","title":"Timezone","example":"Asia/Kolkata"},"chart":{"$ref":"#/components/schemas/PersonalChartInput"},"ayanamsa":{"type":"string","enum":["lahiri","true_chitrapaksha","krishnamurti","krishnamurti_2","raman","yukteshwar","usha_shashi","jn_bhasin"],"title":"Ayanamsa","default":"lahiri"},"view":{"type":"string","enum":["day","week","month"],"title":"View","default":"month"}},"type":"object","required":["target_date","latitude","longitude","timezone","chart"],"title":"PersonalCalendarRequest"},"PersonalChartInput":{"properties":{"moon_sign":{"type":"string","enum":["Aries","Taurus","Gemini","Cancer","Leo","Virgo","Libra","Scorpio","Sagittarius","Capricorn","Aquarius","Pisces"],"title":"Moon Sign"},"ascendant":{"type":"string","enum":["Aries","Taurus","Gemini","Cancer","Leo","Virgo","Libra","Scorpio","Sagittarius","Capricorn","Aquarius","Pisces"],"title":"Ascendant"}},"type":"object","required":["moon_sign","ascendant"],"title":"PersonalChartInput"},"PersonalMeetingRequest":{"properties":{"target_date":{"type":"string","format":"date","title":"Target Date"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","format":"iana-timezone","title":"Timezone","example":"Asia/Kolkata"},"chart":{"$ref":"#/components/schemas/PersonalChartInput"},"ayanamsa":{"type":"string","enum":["lahiri","true_chitrapaksha","krishnamurti","krishnamurti_2","raman","yukteshwar","usha_shashi","jn_bhasin"],"title":"Ayanamsa","default":"lahiri"},"view":{"type":"string","enum":["day","week","month"],"title":"View","default":"month"},"duration_minutes":{"type":"integer","maximum":480.0,"minimum":15.0,"title":"Duration Minutes","default":60}},"type":"object","required":["target_date","latitude","longitude","timezone","chart"],"title":"PersonalMeetingRequest"},"PersonalizationBlock":{"properties":{"natal_moon_sign":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Natal Moon Sign"},"natal_moon_sign_name":{"type":"string","title":"Natal Moon Sign Name"},"natal_nakshatra":{"type":"string","title":"Natal Nakshatra"},"natal_pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Natal Pada"},"natal_navamsha_rashi":{"type":"string","title":"Natal Navamsha Rashi"},"mahadasha":{"type":"string","title":"Mahadasha"},"antardasha":{"type":"string","title":"Antardasha"},"pratyantardasha":{"type":"string","title":"Pratyantardasha"},"mahadasha_start":{"type":"string","format":"date-time","title":"Mahadasha Start"},"mahadasha_end":{"type":"string","format":"date-time","title":"Mahadasha End"},"antardasha_start":{"type":"string","format":"date-time","title":"Antardasha Start"},"antardasha_end":{"type":"string","format":"date-time","title":"Antardasha End"},"pratyantardasha_start":{"type":"string","format":"date-time","title":"Pratyantardasha Start"},"pratyantardasha_end":{"type":"string","format":"date-time","title":"Pratyantardasha End"},"dasha_note":{"type":"string","title":"Dasha Note"},"section_notes":{"additionalProperties":{"type":"string"},"type":"object","title":"Section Notes"},"transit_qualifiers":{"items":{"$ref":"#/components/schemas/TransitQualifier"},"type":"array","title":"Transit Qualifiers"},"tara_bala":{"$ref":"#/components/schemas/TaraBala"},"chandra_bala":{"$ref":"#/components/schemas/ChandraBala"},"favorable_days":{"items":{"$ref":"#/components/schemas/DayStrength"},"type":"array","title":"Favorable Days"},"caution_days":{"items":{"$ref":"#/components/schemas/DayStrength"},"type":"array","title":"Caution Days"},"personal_summary":{"type":"string","title":"Personal Summary"}},"type":"object","required":["natal_moon_sign","natal_moon_sign_name","natal_nakshatra","mahadasha","antardasha","dasha_note"],"title":"PersonalizationBlock","description":"Birth-profile lens attached when the request carries birth details."},"PersonalizedDailyPrediction":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"moon_sign":{"type":"string","title":"Moon Sign"},"ascendant":{"type":"string","title":"Ascendant"},"transit_impact":{"$ref":"#/components/schemas/TransitImpact"},"dasha_influence":{"$ref":"#/components/schemas/DashaInfluence"},"active_yogas":{"items":{"$ref":"#/components/schemas/YogaActivation"},"type":"array","title":"Active Yogas"},"overall_day_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Overall Day Score"},"overall_prediction":{"type":"string","title":"Overall Prediction"},"career_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"finance_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"relationship_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"health_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"auspicious_hours":{"items":{"type":"string"},"type":"array","title":"Auspicious Hours"},"inauspicious_hours":{"items":{"type":"string"},"type":"array","title":"Inauspicious Hours"},"lucky_number":{"type":"integer","title":"Lucky Number"},"lucky_color":{"type":"string","title":"Lucky Color"},"lucky_direction":{"type":"string","title":"Lucky Direction"},"recommended_mantra":{"type":"string","title":"Recommended Mantra"},"daily_remedy":{"type":"string","title":"Daily Remedy"}},"type":"object","required":["date","birth_details","moon_sign","ascendant","transit_impact","dasha_influence","active_yogas","overall_day_score","overall_prediction","career_prediction","finance_prediction","relationship_prediction","health_prediction","auspicious_hours","inauspicious_hours","lucky_number","lucky_color","lucky_direction"],"title":"PersonalizedDailyPrediction","description":"Comprehensive personalized daily prediction."},"PersonalizedDailyResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"prediction":{"$ref":"#/components/schemas/PersonalizedDailyPrediction"}},"type":"object","required":["prediction"],"title":"PersonalizedDailyResponse","description":"Response for daily prediction."},"PersonalizedMonthlyPrediction":{"properties":{"month":{"type":"integer","title":"Month"},"year":{"type":"integer","title":"Year"},"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"moon_sign":{"type":"string","title":"Moon Sign"},"ascendant":{"type":"string","title":"Ascendant"},"transit_impact":{"$ref":"#/components/schemas/TransitImpact"},"dasha_influence":{"$ref":"#/components/schemas/DashaInfluence"},"active_yogas":{"items":{"$ref":"#/components/schemas/YogaActivation"},"type":"array","title":"Active Yogas"},"overall_month_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Overall Month Score"},"monthly_summary":{"type":"string","title":"Monthly Summary"},"monthly_theme":{"type":"string","title":"Monthly Theme"},"career_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"finance_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"relationship_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"health_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"education_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"spiritual_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"week_summaries":{"items":{"type":"string"},"type":"array","title":"Week Summaries"},"best_weeks":{"items":{"type":"integer"},"type":"array","title":"Best Weeks"},"auspicious_dates":{"items":{"type":"string","format":"date"},"type":"array","title":"Auspicious Dates"},"challenging_dates":{"items":{"type":"string","format":"date"},"type":"array","title":"Challenging Dates"},"new_moon_effects":{"type":"string","title":"New Moon Effects"},"full_moon_effects":{"type":"string","title":"Full Moon Effects"},"timing_guidance":{"$ref":"#/components/schemas/TimingGuidance"},"monthly_remedies":{"items":{"type":"string"},"type":"array","title":"Monthly Remedies"}},"type":"object","required":["month","year","birth_details","moon_sign","ascendant","transit_impact","dasha_influence","active_yogas","overall_month_score","monthly_summary","monthly_theme","career_prediction","finance_prediction","relationship_prediction","health_prediction","week_summaries","best_weeks","auspicious_dates","challenging_dates","new_moon_effects","full_moon_effects","timing_guidance","monthly_remedies"],"title":"PersonalizedMonthlyPrediction","description":"Comprehensive personalized monthly prediction."},"PersonalizedMonthlyResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"prediction":{"$ref":"#/components/schemas/PersonalizedMonthlyPrediction"}},"type":"object","required":["prediction"],"title":"PersonalizedMonthlyResponse","description":"Response for monthly prediction."},"PersonalizedPredictionRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"prediction_date":{"type":"string","format":"date","title":"Prediction Date"}},"type":"object","required":["birth_details"],"title":"PersonalizedPredictionRequest","description":"Request for personalized prediction."},"PersonalizedWeeklyPrediction":{"properties":{"start_date":{"type":"string","format":"date","title":"Start Date"},"end_date":{"type":"string","format":"date","title":"End Date"},"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"moon_sign":{"type":"string","title":"Moon Sign"},"ascendant":{"type":"string","title":"Ascendant"},"transit_impact":{"$ref":"#/components/schemas/TransitImpact"},"dasha_influence":{"$ref":"#/components/schemas/DashaInfluence"},"active_yogas":{"items":{"$ref":"#/components/schemas/YogaActivation"},"type":"array","title":"Active Yogas"},"overall_week_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Overall Week Score"},"weekly_summary":{"type":"string","title":"Weekly Summary"},"weekly_theme":{"type":"string","title":"Weekly Theme"},"career_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"finance_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"relationship_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"health_prediction":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"best_days":{"items":{"type":"string","format":"date"},"type":"array","title":"Best Days"},"challenging_days":{"items":{"type":"string","format":"date"},"type":"array","title":"Challenging Days"},"day_ratings":{"additionalProperties":{"type":"integer"},"type":"object","title":"Day Ratings"},"important_transits":{"items":{"type":"string"},"type":"array","title":"Important Transits"},"weekly_advice":{"type":"string","title":"Weekly Advice"}},"type":"object","required":["start_date","end_date","birth_details","moon_sign","ascendant","transit_impact","dasha_influence","active_yogas","overall_week_score","weekly_summary","weekly_theme","career_prediction","finance_prediction","relationship_prediction","health_prediction","best_days","challenging_days","day_ratings","important_transits","weekly_advice"],"title":"PersonalizedWeeklyPrediction","description":"Comprehensive personalized weekly prediction."},"PersonalizedWeeklyResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"prediction":{"$ref":"#/components/schemas/PersonalizedWeeklyPrediction"}},"type":"object","required":["prediction"],"title":"PersonalizedWeeklyResponse","description":"Response for weekly prediction."},"PersonalizedYearlyPrediction":{"properties":{"year":{"type":"integer","title":"Year"},"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"moon_sign":{"type":"string","title":"Moon Sign"},"ascendant":{"type":"string","title":"Ascendant"},"dasha_influence":{"$ref":"#/components/schemas/DashaInfluence"},"yearly_theme":{"type":"string","title":"Yearly Theme"},"keyword_for_year":{"type":"string","title":"Keyword For Year"},"overall_year_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Overall Year Score"},"yearly_summary":{"type":"string","title":"Yearly Summary"},"saturn_transit_analysis":{"type":"string","title":"Saturn Transit Analysis"},"jupiter_transit_analysis":{"type":"string","title":"Jupiter Transit Analysis"},"rahu_ketu_analysis":{"type":"string","title":"Rahu Ketu Analysis"},"eclipse_impacts":{"items":{"type":"string"},"type":"array","title":"Eclipse Impacts"},"q1_prediction":{"type":"string","title":"Q1 Prediction"},"q1_score":{"type":"integer","title":"Q1 Score"},"q2_prediction":{"type":"string","title":"Q2 Prediction"},"q2_score":{"type":"integer","title":"Q2 Score"},"q3_prediction":{"type":"string","title":"Q3 Prediction"},"q3_score":{"type":"integer","title":"Q3 Score"},"q4_prediction":{"type":"string","title":"Q4 Prediction"},"q4_score":{"type":"integer","title":"Q4 Score"},"career_yearly":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"finance_yearly":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"relationship_yearly":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"health_yearly":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"family_yearly":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"spiritual_yearly":{"$ref":"#/components/schemas/app__schemas__predictions__LifeAreaPrediction"},"best_months":{"items":{"type":"string"},"type":"array","title":"Best Months"},"challenging_months":{"items":{"type":"string"},"type":"array","title":"Challenging Months"},"transformation_periods":{"items":{"type":"string"},"type":"array","title":"Transformation Periods"},"major_opportunities":{"items":{"type":"string"},"type":"array","title":"Major Opportunities"},"potential_challenges":{"items":{"type":"string"},"type":"array","title":"Potential Challenges"},"activated_yogas":{"items":{"$ref":"#/components/schemas/YogaActivation"},"type":"array","title":"Activated Yogas"},"dormant_yogas":{"items":{"type":"string"},"type":"array","title":"Dormant Yogas"},"lucky_numbers":{"items":{"type":"integer"},"type":"array","title":"Lucky Numbers"},"lucky_colors":{"items":{"type":"string"},"type":"array","title":"Lucky Colors"},"lucky_gemstone":{"type":"string","title":"Lucky Gemstone"},"lucky_days":{"items":{"type":"string"},"type":"array","title":"Lucky Days"},"lucky_directions":{"items":{"type":"string"},"type":"array","title":"Lucky Directions"},"yearly_remedies":{"items":{"type":"string"},"type":"array","title":"Yearly Remedies"},"recommended_mantras":{"items":{"type":"string"},"type":"array","title":"Recommended Mantras"},"recommended_charities":{"items":{"type":"string"},"type":"array","title":"Recommended Charities"}},"type":"object","required":["year","birth_details","moon_sign","ascendant","dasha_influence","yearly_theme","keyword_for_year","overall_year_score","yearly_summary","saturn_transit_analysis","jupiter_transit_analysis","rahu_ketu_analysis","eclipse_impacts","q1_prediction","q1_score","q2_prediction","q2_score","q3_prediction","q3_score","q4_prediction","q4_score","career_yearly","finance_yearly","relationship_yearly","health_yearly","family_yearly","spiritual_yearly","best_months","challenging_months","transformation_periods","major_opportunities","potential_challenges","activated_yogas","dormant_yogas","lucky_numbers","lucky_colors","lucky_gemstone","lucky_days","lucky_directions","yearly_remedies","recommended_mantras","recommended_charities"],"title":"PersonalizedYearlyPrediction","description":"Comprehensive personalized yearly prediction."},"PersonalizedYearlyResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"prediction":{"$ref":"#/components/schemas/PersonalizedYearlyPrediction"}},"type":"object","required":["prediction"],"title":"PersonalizedYearlyResponse","description":"Response for yearly prediction."},"PlanResponse":{"properties":{"plan_id":{"type":"string","title":"Plan Id"},"tier":{"type":"string","title":"Tier"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"price":{"type":"number","title":"Price"},"currency":{"type":"string","title":"Currency"},"billing_cycle":{"type":"string","title":"Billing Cycle"},"trial_days":{"type":"integer","title":"Trial Days"},"features":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Features"},"limits":{"additionalProperties":{"type":"integer"},"type":"object","title":"Limits"},"is_popular":{"type":"boolean","title":"Is Popular","default":false}},"type":"object","required":["plan_id","tier","name","description","price","currency","billing_cycle","trial_days","features","limits"],"title":"PlanResponse","description":"Plan response."},"PlanetAshtakavargaSummary":{"properties":{"planet":{"type":"string","title":"Planet"},"natal_sign":{"type":"integer","title":"Natal Sign"},"natal_sign_name":{"type":"string","title":"Natal Sign Name"},"natal_sign_bindus":{"type":"integer","title":"Natal Sign Bindus"},"total_bindus":{"type":"integer","title":"Total Bindus"},"strongest_sign":{"type":"integer","title":"Strongest Sign"},"strongest_sign_name":{"type":"string","title":"Strongest Sign Name"},"strongest_sign_bindus":{"type":"integer","title":"Strongest Sign Bindus"},"weakest_sign":{"type":"integer","title":"Weakest Sign"},"weakest_sign_name":{"type":"string","title":"Weakest Sign Name"},"weakest_sign_bindus":{"type":"integer","title":"Weakest Sign Bindus"},"favorable_transits":{"items":{"type":"string"},"type":"array","title":"Favorable Transits"},"challenging_transits":{"items":{"type":"string"},"type":"array","title":"Challenging Transits"}},"type":"object","required":["planet","natal_sign","natal_sign_name","natal_sign_bindus","total_bindus","strongest_sign","strongest_sign_name","strongest_sign_bindus","weakest_sign","weakest_sign_name","weakest_sign_bindus","favorable_transits","challenging_transits"],"title":"PlanetAshtakavargaSummary","description":"Summary of Ashtakavarga for one planet."},"PlanetBinduRow":{"properties":{"reference":{"type":"string","title":"Reference"},"bindus":{"items":{"type":"integer"},"type":"array","title":"Bindus"}},"type":"object","required":["reference","bindus"],"title":"PlanetBinduRow","description":"Bindu contributions from one reference planet/lagna."},"PlanetCellInfo":{"properties":{"planet":{"type":"string","title":"Planet"},"abbreviation":{"type":"string","title":"Abbreviation"},"symbol":{"type":"string","title":"Symbol"},"cell_row":{"type":"integer","title":"Cell Row"},"cell_col":{"type":"integer","title":"Cell Col"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"sign":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign"},"sign_name":{"type":"string","title":"Sign Name"},"longitude":{"type":"number","title":"Longitude"},"is_retrograde":{"type":"boolean","title":"Is Retrograde","default":false},"retrograde_symbol":{"type":"string","title":"Retrograde Symbol","default":""}},"type":"object","required":["planet","abbreviation","symbol","cell_row","cell_col","house","sign","sign_name","longitude"],"title":"PlanetCellInfo","description":"Planet placement information for chart rendering.\n\nAttributes:\n planet: Planet name\n abbreviation: Short form for display\n symbol: Unicode symbol for planet\n cell_row: Row where planet should be displayed\n cell_col: Column where planet should be displayed\n house: House number (1-12)\n sign: Sign index (0-11)\n sign_name: Sign name\n longitude: Exact longitude\n is_retrograde: Whether planet is retrograde\n retrograde_symbol: Symbol to show if retrograde (ℛ)"},"PlanetInChakra":{"properties":{"planet":{"type":"string","title":"Planet"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_cell":{"items":{},"type":"array","title":"Nakshatra Cell"},"rashi":{"type":"string","title":"Rashi"},"rashi_cell":{"items":{},"type":"array","title":"Rashi Cell"},"vedha_causing":{"items":{"$ref":"#/components/schemas/SBCVedha"},"type":"array","title":"Vedha Causing"}},"type":"object","required":["planet","nakshatra","nakshatra_cell","rashi","rashi_cell","vedha_causing"],"title":"PlanetInChakra","description":"Planet position in Sarvatobhadra Chakra"},"PlanetPositionRequest":{"properties":{"longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Longitude","description":"Planet longitude in degrees"}},"type":"object","required":["longitude"],"title":"PlanetPositionRequest"},"PlanetPositions":{"properties":{"Sun":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Sun"},"Moon":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Moon"},"Mars":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Mars"},"Mercury":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Mercury"},"Jupiter":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Jupiter"},"Venus":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Venus"},"Saturn":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Saturn"},"Rahu":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Rahu"},"Ketu":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Ketu"}},"type":"object","required":["Sun","Moon","Mars","Mercury","Jupiter","Venus","Saturn","Rahu","Ketu"],"title":"PlanetPositions","description":"Planet positions for dosha analysis."},"PlanetPositionsRequest":{"properties":{"planet_positions":{"additionalProperties":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0},"type":"object","title":"Planet Positions","description":"Dictionary of planet names to longitudes (0 <= x < 360)","example":{"Sun":45.5,"Moon":120.3,"Mars":200.1,"Mercury":60.0,"Jupiter":280.5,"Venus":150.2,"Saturn":310.0}},"benefics":{"items":{"type":"string"},"type":"array","title":"Benefics","description":"List of benefic planets (default: Jupiter, Venus, Mercury, Moon)","example":["Jupiter","Venus","Mercury","Moon"]},"malefics":{"items":{"type":"string"},"type":"array","title":"Malefics","description":"List of malefic planets (default: Saturn, Mars, Sun, Rahu, Ketu)","example":["Saturn","Mars","Sun","Rahu","Ketu"]},"ascendant":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Ascendant","description":"Lagna longitude. Dala and Akriti yogas are counted from the ascendant and are omitted without it; supplying it also stops every chart being judged as though the lagna were Aries."}},"type":"object","required":["planet_positions"],"title":"PlanetPositionsRequest"},"PlanetShadbala":{"properties":{"planet":{"type":"string","title":"Planet"},"sthana_bala":{"$ref":"#/components/schemas/SthanaBala"},"dig_bala":{"$ref":"#/components/schemas/DigBala"},"kala_bala":{"$ref":"#/components/schemas/KalaBala"},"chesta_bala":{"$ref":"#/components/schemas/ChestaBala"},"naisargika_bala":{"$ref":"#/components/schemas/NaisargikaBala"},"drik_bala":{"$ref":"#/components/schemas/DrikBala"},"total_shadbala_virupas":{"type":"number","title":"Total Shadbala Virupas"},"total_shadbala_rupas":{"type":"number","title":"Total Shadbala Rupas"},"required_strength_rupas":{"type":"number","title":"Required Strength Rupas"},"ishta_phala":{"type":"number","title":"Ishta Phala"},"kashta_phala":{"type":"number","title":"Kashta Phala"},"strength_ratio":{"type":"number","title":"Strength Ratio"},"strength_category":{"$ref":"#/components/schemas/StrengthCategory"},"planetary_state":{"$ref":"#/components/schemas/PlanetaryState"},"strongest_bala":{"type":"string","title":"Strongest Bala"},"weakest_bala":{"type":"string","title":"Weakest Bala"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["planet","sthana_bala","dig_bala","kala_bala","chesta_bala","naisargika_bala","drik_bala","total_shadbala_virupas","total_shadbala_rupas","required_strength_rupas","ishta_phala","kashta_phala","strength_ratio","strength_category","planetary_state","strongest_bala","weakest_bala","interpretation"],"title":"PlanetShadbala","description":"Complete Shadbala for a single planet."},"PlanetTransit":{"properties":{"planet":{"type":"string","title":"Planet"},"current_sign":{"type":"string","title":"Current Sign"},"current_sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Current Sign Num"},"current_degree":{"type":"number","exclusiveMaximum":30.0,"minimum":0.0,"title":"Current Degree"},"current_nakshatra":{"type":"string","title":"Current Nakshatra"},"is_retrograde":{"type":"boolean","title":"Is Retrograde","default":false},"speed":{"type":"number","title":"Speed","default":0.0},"house_from_moon":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House From Moon"},"transit_nature":{"$ref":"#/components/schemas/TransitNature"},"significance":{"$ref":"#/components/schemas/TransitSignificance"},"entered_sign":{"type":"string","format":"date-time","title":"Entered Sign"},"exits_sign":{"type":"string","format":"date-time","title":"Exits Sign"},"days_in_sign":{"type":"integer","title":"Days In Sign"},"previous_sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Previous Sign Num"},"ashtakavarga_bindus":{"type":"integer","maximum":8.0,"minimum":0.0,"title":"Ashtakavarga Bindus"},"effects":{"items":{"type":"string"},"type":"array","title":"Effects"},"areas_affected":{"items":{"type":"string"},"type":"array","title":"Areas Affected"}},"type":"object","required":["planet","current_sign","current_sign_num","current_degree","current_nakshatra","house_from_moon","transit_nature","significance","entered_sign","exits_sign","days_in_sign","effects","areas_affected"],"title":"PlanetTransit","description":"Individual planet transit information"},"PlanetWiseCompatibility":{"properties":{"planet":{"type":"string","title":"Planet"},"bride_sign":{"type":"string","title":"Bride Sign"},"bride_house":{"type":"integer","title":"Bride House"},"bride_strength":{"type":"string","title":"Bride Strength"},"groom_sign":{"type":"string","title":"Groom Sign"},"groom_house":{"type":"integer","title":"Groom House"},"groom_strength":{"type":"string","title":"Groom Strength"},"mutual_aspect":{"type":"boolean","title":"Mutual Aspect"},"conjunction_possible":{"type":"boolean","title":"Conjunction Possible"},"compatibility":{"type":"string","title":"Compatibility","description":"Good, Neutral, or Challenging"},"influence_on_marriage":{"type":"string","title":"Influence On Marriage"}},"type":"object","required":["planet","bride_sign","bride_house","bride_strength","groom_sign","groom_house","groom_strength","mutual_aspect","conjunction_possible","compatibility","influence_on_marriage"],"title":"PlanetWiseCompatibility","description":"Planet-by-planet compatibility analysis.\n\nCompares the position and strength of each planet\nbetween the two charts.\n\nAttributes:\n planet: Planet name\n bride_position: Bride's planet position\n groom_position: Groom's planet position\n aspect_relation: How planets aspect each other\n compatibility: Compatibility assessment\n influence_on_marriage: How this affects marriage"},"PlanetaryAffliction":{"type":"string","enum":["weak","combust","retrograde","afflicted","dasha_active","transit_stress"],"title":"PlanetaryAffliction","description":"Types of planetary afflictions."},"PlanetaryAnalysis":{"properties":{"planet":{"type":"string","title":"Planet"},"status":{"type":"string","title":"Status"},"afflictions":{"items":{"$ref":"#/components/schemas/PlanetaryAffliction"},"type":"array"},"strength_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Strength Score"},"needs_remedy":{"type":"boolean","title":"Needs Remedy"},"remedy_urgency":{"$ref":"#/components/schemas/RemedyUrgency"}},"type":"object","required":["planet","status","afflictions","strength_score","needs_remedy","remedy_urgency"],"title":"PlanetaryAnalysis","description":"Analysis of a planet's condition."},"PlanetaryInfluence":{"properties":{"planet":{"type":"string","title":"Planet"},"strength":{"type":"string","title":"Strength"},"influence":{"type":"string","title":"Influence"},"suggested_sounds":{"items":{"type":"string"},"type":"array","title":"Suggested Sounds"}},"type":"object","required":["planet","strength","influence","suggested_sounds"],"title":"PlanetaryInfluence","description":"Strong planetary influences in the birth chart.\n\nAttributes:\n planet: Planet name\n strength: Strength assessment\n influence: How it influences naming\n suggested_sounds: Sounds associated with this planet"},"PlanetaryPosition":{"properties":{"planet":{"type":"string","title":"Planet"},"longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Longitude"},"sign":{"type":"string","title":"Sign"},"sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign Num"},"degree_in_sign":{"type":"number","exclusiveMaximum":30.0,"minimum":0.0,"title":"Degree In Sign"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Nakshatra Pada"},"is_retrograde":{"type":"boolean","title":"Is Retrograde","default":false},"speed":{"type":"number","title":"Speed","default":0.0},"hadda_lord":{"type":"string","title":"Hadda Lord"},"drekkana_lord":{"type":"string","title":"Drekkana Lord"}},"type":"object","required":["planet","longitude","sign","sign_num","degree_in_sign","nakshatra","nakshatra_pada"],"title":"PlanetaryPosition","description":"Planetary position in annual chart"},"PlanetaryShadbala":{"properties":{"planet":{"type":"string","title":"Planet"},"sthana_bala":{"$ref":"#/components/schemas/SthanaBalaBrekdown"},"dig_bala":{"type":"number","title":"Dig Bala","description":"Directional strength"},"kala_bala":{"$ref":"#/components/schemas/KalaBalaBrekdown"},"chesta_bala":{"type":"number","title":"Chesta Bala","description":"Motional strength"},"naisargika_bala":{"type":"number","title":"Naisargika Bala","description":"Natural strength"},"drik_bala":{"type":"number","title":"Drik Bala","description":"Aspectual strength"},"total_shadbala":{"type":"number","title":"Total Shadbala","description":"Total Shadbala in Shashtiamsas"},"total_in_rupas":{"type":"number","title":"Total In Rupas","description":"Total in Rupas (Shadbala/60)"},"minimum_required":{"type":"number","title":"Minimum Required","description":"Minimum required Shadbala"},"strength_ratio":{"type":"number","title":"Strength Ratio","description":"Percentage of minimum required"},"strength_assessment":{"type":"string","title":"Strength Assessment","description":"Strength classification"},"ishta_phala":{"type":"number","title":"Ishta Phala","description":"Constructive tendency, 0-60"},"kashta_phala":{"type":"number","title":"Kashta Phala","description":"Difficult tendency, 0-60"},"planetary_state":{"type":"string","title":"Planetary State"},"strongest_bala":{"type":"string","title":"Strongest Bala"},"weakest_bala":{"type":"string","title":"Weakest Bala"}},"type":"object","required":["planet","sthana_bala","dig_bala","kala_bala","chesta_bala","naisargika_bala","drik_bala","total_shadbala","total_in_rupas","minimum_required","strength_ratio","strength_assessment"],"title":"PlanetaryShadbala","description":"Complete Shadbala data for a single planet.\n\nShadbala consists of 6 main strength components:\n1. Sthana Bala (Positional) - from sign/house placement\n2. Dig Bala (Directional) - from house direction\n3. Kala Bala (Temporal) - from time factors\n4. Chesta Bala (Motional) - from planetary motion\n5. Naisargika Bala (Natural) - inherent strength\n6. Drik Bala (Aspectual) - from aspects received\n\nAttributes:\n planet: Planet name\n sthana_bala: Positional strength breakdown\n dig_bala: Directional strength\n kala_bala: Temporal strength breakdown\n chesta_bala: Motional strength\n naisargika_bala: Natural strength\n drik_bala: Aspectual strength\n total_shadbala: Sum of all 6 balas\n total_in_rupas: Total strength in Rupas (÷60)\n minimum_required: Minimum strength required\n strength_ratio: Ratio of actual to required\n strength_assessment: Very Strong/Strong/Adequate/Weak/Very Weak"},"PlanetaryState":{"type":"string","enum":["exalted","own_sign","moolatrikona","friendly","neutral","enemy","debilitated"],"title":"PlanetaryState","description":"Planetary state based on Shadbala."},"PlanetaryStrength":{"properties":{"planet":{"type":"string","title":"Planet"},"sign":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign"},"sign_name":{"type":"string","title":"Sign Name"},"bindus_in_current_sign":{"type":"integer","maximum":8.0,"minimum":0.0,"title":"Bindus In Current Sign"},"strength_assessment":{"type":"string","title":"Strength Assessment","description":"Good, Average, or Weak based on bindu count"},"transit_favorability":{"type":"string","title":"Transit Favorability","description":"Assessment of transit effects"}},"type":"object","required":["planet","sign","sign_name","bindus_in_current_sign","strength_assessment","transit_favorability"],"title":"PlanetaryStrength","description":"Ashtakavarga-based strength assessment for a planet.\n\nAttributes:\n planet: Planet name\n sign: Current sign of the planet\n sign_name: Human-readable sign name\n bindus_in_current_sign: BAV bindus in the planet's current sign\n strength_assessment: Good (4+), Average (3), or Weak (<3)\n transit_favorability: How favorable transits through this sign will be"},"PlansListResponse":{"properties":{"plans":{"items":{"type":"object"},"type":"array","title":"Plans"}},"type":"object","required":["plans"],"title":"PlansListResponse","description":"List of available plans."},"PostListResponse":{"properties":{"posts":{"items":{"$ref":"#/components/schemas/PostResponse"},"type":"array","title":"Posts","description":"List of posts"},"total":{"type":"integer","title":"Total","description":"Total number of posts"},"page":{"type":"integer","title":"Page","description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","description":"Number of posts per page"},"has_more":{"type":"boolean","title":"Has More","description":"Whether there are more pages"}},"type":"object","required":["posts","total","page","per_page","has_more"],"title":"PostListResponse","description":"Schema for paginated post list response."},"PostResponse":{"properties":{"title":{"type":"string","maxLength":300,"minLength":5,"title":"Title","description":"Title of the post, between 5 and 300 characters"},"content":{"type":"string","minLength":20,"title":"Content","description":"Main content of the post, minimum 20 characters"},"category":{"allOf":[{"$ref":"#/components/schemas/TopicCategory"}],"description":"Category of the post"},"topic":{"type":"string","maxLength":100,"title":"Topic","description":"Free-text topic within the category"},"post_type":{"allOf":[{"$ref":"#/components/schemas/PostType"}],"description":"Type of the post"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","description":"List of tags associated with the post"},"chart_data":{"type":"object","title":"Chart Data","description":"Astrological chart data if applicable"},"images":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","title":"Images","description":"List of image URLs associated with the post"},"id":{"type":"string","title":"Id","description":"Unique identifier of the post"},"author_id":{"type":"string","title":"Author Id","description":"ID of the post author"},"author_name":{"type":"string","title":"Author Name","description":"Name of the post author"},"status":{"allOf":[{"$ref":"#/components/schemas/PostStatus"}],"description":"Current status of the post"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp when the post was created"},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"Timestamp when the post was last updated"},"view_count":{"type":"integer","title":"View Count","description":"Number of times the post has been viewed","default":0},"vote_count":{"type":"integer","title":"Vote Count","description":"Net vote count (upvotes - downvotes)","default":0},"comment_count":{"type":"integer","title":"Comment Count","description":"Number of comments on the post","default":0},"is_answered":{"type":"boolean","title":"Is Answered","description":"Whether the post has an accepted answer","default":false},"accepted_answer_id":{"type":"string","title":"Accepted Answer Id","description":"ID of the accepted answer if any"}},"type":"object","required":["title","content","category","post_type","id","author_id","author_name","status","created_at","updated_at"],"title":"PostResponse","description":"Schema for post response with additional metadata."},"PostStatus":{"type":"string","enum":["draft","published","archived","flagged","deleted"],"title":"PostStatus","description":"Status of forum posts."},"PostType":{"type":"string","enum":["question","discussion","chart_share","article"],"title":"PostType","description":"Types of forum posts."},"PowerDayOut":{"properties":{"date":{"type":"string","title":"Date"},"weekday":{"type":"string","title":"Weekday"},"power_score":{"type":"integer","title":"Power Score"},"moon_sign":{"type":"string","title":"Moon Sign"},"type":{"type":"string","title":"Type"},"best_for":{"items":{"type":"string"},"type":"array","title":"Best For"}},"type":"object","required":["date","weekday","power_score","moon_sign","type","best_for"],"title":"PowerDayOut"},"PowerDaysOut":{"properties":{"user_id":{"type":"string","title":"User Id"},"period":{"type":"string","title":"Period"},"location":{"$ref":"#/components/schemas/app__routers__astro_calendar__LocationOut"},"power_days":{"items":{"$ref":"#/components/schemas/PowerDayOut"},"type":"array","title":"Power Days"},"total_power_days":{"type":"integer","title":"Total Power Days"},"next_power_day":{"$ref":"#/components/schemas/PowerDayOut"}},"type":"object","required":["user_id","period","location","power_days","total_power_days"],"title":"PowerDaysOut"},"PrashnaAnswerOut":{"properties":{"overall_answer":{"type":"string","title":"Overall Answer"},"confidence_level":{"type":"string","title":"Confidence Level"},"detailed_interpretation":{"type":"string","title":"Detailed Interpretation"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"display_payload":{"type":"object","title":"Display Payload"}},"type":"object","required":["overall_answer"],"title":"PrashnaAnswerOut"},"PrashnaGatewayRequest":{"properties":{"question":{"type":"string","maxLength":500,"minLength":1,"title":"Question"},"category":{"type":"string","maxLength":64,"title":"Category"},"asked_at":{"type":"string","format":"date-time","title":"Asked At"},"location":{"$ref":"#/components/schemas/QuestionLocation"},"locale":{"type":"string","maxLength":16,"minLength":2,"title":"Locale","default":"en"},"source":{"type":"string","maxLength":64,"minLength":1,"title":"Source","default":"api"}},"type":"object","required":["question"],"title":"PrashnaGatewayRequest","description":"One cross-application entry point for question-based Jyotish services."},"PrashnaGatewayResponse":{"properties":{"kind":{"type":"string","enum":["panchang","rashiphal","jyotish"],"title":"Kind"},"status":{"type":"string","enum":["answered","authentication_required","profile_required","completed","failed"],"title":"Status"},"question":{"type":"string","title":"Question"},"asked_at":{"type":"string","format":"date-time","title":"Asked At"},"requires_auth":{"type":"boolean","title":"Requires Auth","default":false},"requires_birth_profile":{"type":"boolean","title":"Requires Birth Profile","default":false},"next_action":{"type":"string","title":"Next Action"},"rashi":{"type":"string","title":"Rashi"},"inquiry_id":{"type":"string","format":"uuid","title":"Inquiry Id"},"missing_fields":{"items":{"type":"string"},"type":"array","title":"Missing Fields"},"panchang":{"$ref":"#/components/schemas/PanchangQueryResponse"},"rashiphal":{"$ref":"#/components/schemas/HoroscopeResponse"},"inquiry":{"$ref":"#/components/schemas/PrashnaInquiryOut"}},"type":"object","required":["kind","status","question","asked_at"],"title":"PrashnaGatewayResponse","description":"Stable routing envelope returned to web, mobile and partner clients."},"PrashnaInquiryOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"status":{"type":"string","title":"Status"},"specific_question":{"type":"string","title":"Specific Question"},"edited_question":{"type":"string","title":"Edited Question"},"archived":{"type":"boolean","title":"Archived","default":false},"question_category":{"type":"string","title":"Question Category"},"question_asked_at":{"type":"string","format":"date-time","title":"Question Asked At"},"question_timezone":{"type":"string","title":"Question Timezone"},"source":{"type":"string","title":"Source"},"consultation_requested":{"type":"string","title":"Consultation Requested"},"answer":{"$ref":"#/components/schemas/PrashnaAnswerOut"},"artifact_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Artifact Ids"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","user_id","status","specific_question","question_asked_at","question_timezone","source","created_at"],"title":"PrashnaInquiryOut"},"PrashnaLagnaAnalysis":{"properties":{"longitude":{"type":"number","title":"Longitude"},"sign":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign"},"sign_name":{"type":"string","title":"Sign Name"},"sign_type":{"type":"string","title":"Sign Type","description":"Movable, Fixed, or Dual"},"lagna_lord":{"type":"string","title":"Lagna Lord"},"lagna_lord_house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Lagna Lord House"},"lagna_lord_strong":{"type":"boolean","title":"Lagna Lord Strong"},"arudha_lagna":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Arudha Lagna"},"arudha_lagna_name":{"type":"string","title":"Arudha Lagna Name"},"overall_indication":{"type":"string","title":"Overall Indication"}},"type":"object","required":["longitude","sign","sign_name","sign_type","lagna_lord","lagna_lord_house","lagna_lord_strong","arudha_lagna","arudha_lagna_name","overall_indication"],"title":"PrashnaLagnaAnalysis","description":"Prashna Lagna (Ascendant) analysis.\n\nThe Lagna at the moment of question is key to interpretation.\n\nAttributes:\n longitude: Ascendant longitude\n sign: Ascendant sign index\n sign_name: Sign name\n sign_type: Movable, Fixed, or Dual\n lagna_lord: Planet ruling the Lagna\n lagna_lord_house: House where Lagna lord is placed\n lagna_lord_strong: Whether Lagna lord is well-placed\n arudha_lagna: Arudha Lagna sign\n arudha_lagna_name: Arudha Lagna sign name\n overall_indication: General indication from Lagna"},"PrashnaRequest":{"properties":{"horary_number":{"type":"integer","maximum":249.0,"minimum":1.0,"title":"Horary Number"},"question_time":{"type":"string","format":"date-time","title":"Question Time"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","maxLength":100,"minLength":1,"title":"Timezone"},"question_category":{"type":"string","title":"Question Category","description":"Category: marriage, career, wealth, health, children, travel, litigation, property, lost_item, education"},"specific_question":{"type":"string","maxLength":2000,"title":"Specific Question","description":"The specific question being asked"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["question_time","latitude","longitude","timezone","question_category"],"title":"PrashnaRequest","description":"Request model for Prashna (horary) calculations.\n\nThe zone is the query place's, derived from latitude/longitude: the\nPrashna Lagna and the weekday are read on that place's clock.\n\nAttributes:\n question_time: Date and time when question is asked\n latitude: Latitude of query location\n longitude: Longitude of query location\n timezone: Timezone of the location\n question_category: Category of question (marriage, career, etc.)\n specific_question: The actual question being asked (optional)"},"PrashnaResponse":{"properties":{"question_time":{"type":"string","format":"date-time","title":"Question Time"},"question_category":{"type":"string","title":"Question Category"},"specific_question":{"type":"string","title":"Specific Question"},"muhurta":{"$ref":"#/components/schemas/MuhurtaData"},"moon_analysis":{"$ref":"#/components/schemas/MoonAnalysis"},"lagna_analysis":{"$ref":"#/components/schemas/PrashnaLagnaAnalysis"},"significator_analysis":{"$ref":"#/components/schemas/SignificatorAnalysis"},"prashna_yogas":{"items":{"$ref":"#/components/schemas/PrashnaYoga"},"type":"array","title":"Prashna Yogas"},"timing_prediction":{"$ref":"#/components/schemas/TimingPrediction"},"lost_item_analysis":{"$ref":"#/components/schemas/LostItemAnalysis"},"overall_answer":{"type":"string","title":"Overall Answer","description":"Favorable, Unfavorable, or Mixed"},"confidence_level":{"type":"string","title":"Confidence Level","description":"High, Medium, or Low"},"detailed_interpretation":{"type":"string","title":"Detailed Interpretation"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"},"chart_positions":{"items":{"type":"object"},"type":"array","title":"Chart Positions","description":"The Prashna chart the answer was read from: the Ascendant first, then each graha, as {body, sign (1-12), longitude, nakshatra, pada, retrograde}. Stored with the answer so history redraws this chart rather than recasting one."},"kp_analysis":{"type":"object","title":"Kp Analysis","description":"Optional dual-engine KP horary (cuspal sub-lord) panel. Does not change overall_answer; available=false when category has no KP event map or KP soft-fails."}},"type":"object","required":["question_time","question_category","muhurta","moon_analysis","lagna_analysis","significator_analysis","prashna_yogas","timing_prediction","overall_answer","confidence_level","detailed_interpretation","recommendations"],"title":"PrashnaResponse","description":"Complete Prashna (horary) analysis response.\n\nAttributes:\n question_time: When the question was asked\n question_category: Category of the question\n specific_question: The specific question if provided\n muhurta: Current timing analysis\n moon_analysis: Moon-based indicators\n lagna_analysis: Prashna Lagna analysis\n significator_analysis: Analysis of relevant significator\n prashna_yogas: Special yogas found\n timing_prediction: When result may manifest\n lost_item_analysis: Special analysis if question is about lost item\n overall_answer: Overall indication (Favorable/Unfavorable/Mixed)\n confidence_level: Confidence in the reading (High/Medium/Low)\n detailed_interpretation: Detailed interpretation text\n recommendations: Suggested actions or remedies"},"PrashnaSuggestItem":{"properties":{"text":{"type":"string","title":"Text"},"category":{"type":"string","title":"Category"}},"type":"object","required":["text","category"],"title":"PrashnaSuggestItem"},"PrashnaSuggestRequest":{"properties":{"partial":{"type":"string","maxLength":500,"title":"Partial"},"locale":{"type":"string","maxLength":16,"title":"Locale","default":"en"}},"type":"object","required":["partial"],"title":"PrashnaSuggestRequest"},"PrashnaSuggestResponse":{"properties":{"completion":{"type":"string","title":"Completion","description":"Ghost suffix after the caret","default":""},"full_completion":{"type":"string","title":"Full Completion"},"category":{"type":"string","title":"Category"},"category_label":{"type":"string","title":"Category Label"},"category_confidence":{"type":"number","title":"Category Confidence","default":0.0},"rewrites":{"items":{"$ref":"#/components/schemas/PrashnaSuggestItem"},"type":"array","title":"Rewrites"},"clarifying":{"items":{"$ref":"#/components/schemas/PrashnaSuggestItem"},"type":"array","title":"Clarifying"},"cold_start":{"items":{"$ref":"#/components/schemas/PrashnaSuggestItem"},"type":"array","title":"Cold Start"},"is_question":{"type":"boolean","title":"Is Question","default":false},"normalized_question":{"type":"string","title":"Normalized Question","description":"Question text with trailing ? ensured when is_question is true"},"needs_question":{"type":"boolean","title":"Needs Question","description":"True when input looks like a statement/vent — steer into a question first","default":false},"is_panchang":{"type":"boolean","title":"Is Panchang","description":"True when the text is an almanac lookup rather than a horary question","default":false},"panchang_aspects":{"items":{"type":"string"},"type":"array","title":"Panchang Aspects","description":"Which parts of the Panchang were asked about, e.g. ['tithi']"},"is_rashiphal":{"type":"boolean","title":"Is Rashiphal","description":"True for a general forecast with an explicitly supplied Rashi","default":false},"rashi":{"type":"string","title":"Rashi","description":"Canonical English Rashi extracted from the question"}},"type":"object","required":["category","category_label"],"title":"PrashnaSuggestResponse"},"PrashnaYoga":{"properties":{"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"planets_involved":{"items":{"type":"string"},"type":"array","title":"Planets Involved"},"indication":{"type":"string","title":"Indication"},"strength":{"type":"string","title":"Strength"}},"type":"object","required":["name","type","planets_involved","indication","strength"],"title":"PrashnaYoga","description":"Special Prashna yoga (combination) found in the chart.\n\nAttributes:\n name: Name of the yoga\n type: Type of yoga (ithasala, ishrafa, etc.)\n planets_involved: Planets forming this yoga\n indication: What this yoga indicates\n strength: Strength of the yoga (strong, moderate, weak)"},"PredictionBirthDetails":{"properties":{"date_of_birth":{"type":"string","format":"date","title":"Date Of Birth","description":"Date of birth"},"time_of_birth":{"type":"string","title":"Time Of Birth","description":"Time of birth in HH:MM format"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"Birth latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude","description":"Birth longitude"},"timezone":{"type":"string","title":"Timezone","description":"Timezone","default":"Asia/Kolkata"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["date_of_birth","time_of_birth","latitude","longitude"],"title":"PredictionBirthDetails"},"PreferenceOut":{"properties":{"zodiac_sign":{"type":"string","title":"Zodiac Sign"},"enabled":{"type":"boolean","title":"Enabled"},"send_hour_local":{"type":"integer","title":"Send Hour Local"},"timezone":{"type":"string","title":"Timezone"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"last_sent_date":{"type":"string","title":"Last Sent Date"},"email":{"type":"string","title":"Email"}},"type":"object","required":["zodiac_sign","enabled","send_hour_local","timezone","channels"],"title":"PreferenceOut"},"PreferenceUpdate":{"properties":{"zodiac_sign":{"type":"string","title":"Zodiac Sign","description":"Aries, Taurus, ..."},"enabled":{"type":"boolean","title":"Enabled"},"send_hour_local":{"type":"integer","maximum":23.0,"minimum":0.0,"title":"Send Hour Local"},"timezone":{"type":"string","maxLength":64,"title":"Timezone"},"channels":{"items":{"type":"string"},"type":"array","title":"Channels"},"email":{"type":"string","maxLength":320,"title":"Email"}},"type":"object","title":"PreferenceUpdate"},"PreferencesUpdateRequest":{"properties":{"language":{"type":"string","maxLength":10,"title":"Language"},"timezone":{"type":"string","maxLength":100,"title":"Timezone"},"custom":{"type":"object","title":"Custom","description":"Custom preferences"}},"type":"object","title":"PreferencesUpdateRequest","description":"Request model for preferences update."},"PrenatalEpochRequest":{"properties":{"approximate_birth":{"$ref":"#/components/schemas/ApproximateBirthTime"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","default":"UTC"},"gender":{"type":"string","title":"Gender","description":"male or female (affects calculation)"}},"type":"object","required":["approximate_birth","latitude","longitude","gender"],"title":"PrenatalEpochRequest"},"PrenatalEpochResult":{"properties":{"estimated_conception_date":{"type":"string","format":"date","title":"Estimated Conception Date"},"moon_longitude_at_birth":{"type":"number","title":"Moon Longitude At Birth"},"moon_sign_at_birth":{"type":"string","title":"Moon Sign At Birth"},"epoch_type":{"type":"string","title":"Epoch Type","description":"regular or reverse"},"rectified_time":{"type":"string","format":"date-time","title":"Rectified Time"},"confidence":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Confidence"},"explanation":{"type":"string","title":"Explanation"}},"type":"object","required":["estimated_conception_date","moon_longitude_at_birth","moon_sign_at_birth","epoch_type","rectified_time","confidence","explanation"],"title":"PrenatalEpochResult","description":"Result of Pre-natal Epoch calculation.\n\nAttributes:\n estimated_conception_date: Calculated conception date\n moon_at_birth: Moon position at estimated birth\n ascendant_or_descendant_at_conception: Based on gender\n epoch_type: Type of epoch (regular or reverse)\n rectified_time: Calculated birth time\n confidence: Confidence in calculation"},"ProfileResponse":{"properties":{"user":{"type":"object","title":"User"},"profile":{"type":"object","title":"Profile"}},"type":"object","required":["user"],"title":"ProfileResponse","description":"Response model for profile data."},"ProfileUpdateRequest":{"properties":{"full_name":{"type":"string","maxLength":200,"title":"Full Name"},"phone":{"type":"string","maxLength":20,"title":"Phone"},"first_name":{"type":"string","maxLength":100,"title":"First Name"},"last_name":{"type":"string","maxLength":100,"title":"Last Name"},"gender":{"type":"string","maxLength":20,"title":"Gender"},"marital_status":{"type":"string","maxLength":32,"title":"Marital Status"},"profession":{"type":"string","maxLength":64,"title":"Profession"},"language_preference":{"type":"string","maxLength":10,"title":"Language Preference"},"timezone_preference":{"type":"string","maxLength":100,"title":"Timezone Preference"}},"type":"object","title":"ProfileUpdateRequest","description":"Request model for profile update."},"ProviderClientService":{"properties":{"kind":{"type":"string","enum":["consultation","ritual"],"title":"Kind"},"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"scheduled_for":{"type":"string","title":"Scheduled For"}},"type":"object","required":["kind","id","title","status"],"title":"ProviderClientService"},"ProviderClientSummary":{"properties":{"id":{"type":"string","title":"Id"},"family_profile_id":{"type":"string","title":"Family Profile Id"},"name":{"type":"string","title":"Name"},"contact":{"type":"string","title":"Contact"},"date_of_birth":{"type":"string","title":"Date Of Birth"},"birth_time":{"type":"string","title":"Birth Time"},"birth_timezone":{"type":"string","title":"Birth Timezone"},"language":{"type":"string","title":"Language"},"consultation_count":{"type":"integer","title":"Consultation Count","default":0},"ritual_count":{"type":"integer","title":"Ritual Count","default":0},"upcoming_count":{"type":"integer","title":"Upcoming Count","default":0},"last_service_at":{"type":"string","format":"date-time","title":"Last Service At"},"recent_services":{"items":{"$ref":"#/components/schemas/ProviderClientService"},"type":"array","title":"Recent Services"}},"type":"object","required":["id","name"],"title":"ProviderClientSummary"},"ProviderToolkitState":{"properties":{"family_profile_id":{"type":"string","format":"uuid","title":"Family Profile Id"},"ritual_id":{"type":"string","maxLength":100,"title":"Ritual Id","default":""},"ritual_name":{"type":"string","maxLength":200,"title":"Ritual Name","default":""},"family_name":{"type":"string","maxLength":200,"title":"Family Name","default":""},"place":{"type":"string","maxLength":300,"title":"Place","default":""},"purpose":{"type":"string","maxLength":500,"title":"Purpose","default":""},"sankalpa":{"type":"string","maxLength":5000,"title":"Sankalpa","default":""},"muhurta_notes":{"type":"string","maxLength":2000,"title":"Muhurta Notes","default":""},"muhurta_options":{"items":{"type":"string","maxLength":300,"minLength":1},"type":"array","maxItems":5,"title":"Muhurta Options"},"samagri_items":{"items":{"$ref":"#/components/schemas/ToolkitSamagriItem"},"type":"array","maxItems":150,"title":"Samagri Items"},"attendee_count":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Attendee Count","default":1},"duration_minutes":{"type":"integer","maximum":1440.0,"minimum":15.0,"title":"Duration Minutes","default":120},"team_size":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Team Size","default":1},"dakshina":{"type":"number","maximum":100000000.0,"minimum":0.0,"title":"Dakshina","default":0},"material_cost":{"type":"number","maximum":100000000.0,"minimum":0.0,"title":"Material Cost","default":0},"travel_cost":{"type":"number","maximum":100000000.0,"minimum":0.0,"title":"Travel Cost","default":0},"assistant_cost":{"type":"number","maximum":100000000.0,"minimum":0.0,"title":"Assistant Cost","default":0},"currency":{"type":"string","maxLength":10,"minLength":3,"title":"Currency","default":"INR"}},"type":"object","title":"ProviderToolkitState","description":"Calculation and preparation details saved with one work item."},"ProviderWorkState":{"properties":{"checklist":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Checklist"},"private_notes":{"type":"string","maxLength":5000,"title":"Private Notes","default":""},"completion_summary":{"type":"string","maxLength":5000,"title":"Completion Summary","default":""},"toolkit":{"$ref":"#/components/schemas/ProviderToolkitState"}},"type":"object","title":"ProviderWorkState","description":"Private preparation owned by the assigned Purohit."},"PujaDetails":{"properties":{"name":{"type":"string","title":"Name"},"sanskrit_name":{"type":"string","title":"Sanskrit Name"},"deity":{"type":"string","title":"Deity"},"purpose":{"type":"string","title":"Purpose"},"duration_hours":{"type":"number","title":"Duration Hours"},"complexity":{"type":"string","title":"Complexity"},"can_do_at_home":{"type":"boolean","title":"Can Do At Home"},"requires_priest":{"type":"boolean","title":"Requires Priest"}},"type":"object","required":["name","sanskrit_name","deity","purpose","duration_hours","complexity","can_do_at_home","requires_priest"],"title":"PujaDetails","description":"Details of a puja/ritual."},"PujaRecommendation":{"properties":{"primary_puja":{"$ref":"#/components/schemas/PujaRemedy"},"supporting_pujas":{"items":{"$ref":"#/components/schemas/PujaRemedy"},"type":"array","title":"Supporting Pujas"},"home_worship_routine":{"type":"string","title":"Home Worship Routine"},"temple_visits_recommended":{"items":{"type":"string"},"type":"array","title":"Temple Visits Recommended"}},"type":"object","required":["primary_puja","supporting_pujas","home_worship_routine","temple_visits_recommended"],"title":"PujaRecommendation","description":"Complete puja recommendation set."},"PujaRemedy":{"properties":{"puja":{"$ref":"#/components/schemas/PujaDetails"},"reason":{"type":"string","title":"Reason"},"affliction_addressed":{"type":"string","title":"Affliction Addressed"},"recommended_date":{"type":"string","format":"date","title":"Recommended Date"},"best_tithis":{"items":{"type":"string"},"type":"array","title":"Best Tithis"},"best_nakshatras":{"items":{"type":"string"},"type":"array","title":"Best Nakshatras"},"best_muhurtas":{"items":{"type":"string"},"type":"array","title":"Best Muhurtas"},"samagri_list":{"items":{"type":"string"},"type":"array","title":"Samagri List"},"approximate_cost":{"type":"string","title":"Approximate Cost"},"procedure_summary":{"type":"string","title":"Procedure Summary"},"sankalpa":{"type":"string","title":"Sankalpa"},"post_puja_guidelines":{"items":{"type":"string"},"type":"array","title":"Post Puja Guidelines"},"frequency":{"type":"string","title":"Frequency"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["puja","reason","affliction_addressed","best_tithis","best_nakshatras","best_muhurtas","samagri_list","approximate_cost","procedure_summary","sankalpa","post_puja_guidelines","frequency","effectiveness_score"],"title":"PujaRemedy","description":"Puja recommendation."},"PushSubscriptionPayload":{"properties":{"endpoint":{"type":"string","minLength":1,"title":"Endpoint"},"keys":{"type":"object","title":"Keys"},"ua_label":{"type":"string","title":"Ua Label"}},"type":"object","required":["endpoint","keys"],"title":"PushSubscriptionPayload"},"QualityLevelOut":{"properties":{"level":{"type":"string","title":"Level"},"score_range":{"type":"string","title":"Score Range"},"description":{"type":"string","title":"Description"},"color":{"type":"string","title":"Color"}},"type":"object","required":["level","score_range","description","color"],"title":"QualityLevelOut"},"QualityLevelsOut":{"properties":{"quality_levels":{"items":{"$ref":"#/components/schemas/QualityLevelOut"},"type":"array","title":"Quality Levels"}},"type":"object","required":["quality_levels"],"title":"QualityLevelsOut"},"QuerentDetails":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"phone":{"type":"string","maxLength":32,"title":"Phone"},"gender":{"type":"string","maxLength":32,"title":"Gender"},"language":{"type":"string","maxLength":16,"title":"Language","default":"en"},"marital_status":{"type":"string","maxLength":32,"title":"Marital Status"},"profession":{"type":"string","maxLength":64,"title":"Profession"},"birth_date":{"type":"string","format":"date","title":"Birth Date"},"birth_time":{"type":"string","format":"time","title":"Birth Time"},"birth_place_label":{"type":"string","maxLength":255,"title":"Birth Place Label"},"birth_latitude":{"type":"number","title":"Birth Latitude"},"birth_longitude":{"type":"number","title":"Birth Longitude"},"birth_timezone":{"type":"string","maxLength":100,"title":"Birth Timezone"}},"type":"object","required":["name","email"],"title":"QuerentDetails"},"QuerentStatusOut":{"properties":{"complete":{"type":"boolean","title":"Complete"},"querent":{"$ref":"#/components/schemas/QuerentDetails"},"birth_profile_complete":{"type":"boolean","title":"Birth Profile Complete","default":false},"personal_profile_complete":{"type":"boolean","title":"Personal Profile Complete","default":false},"source_household_id":{"type":"string","format":"uuid","title":"Source Household Id"},"source_person_id":{"type":"string","format":"uuid","title":"Source Person Id"},"missing_fields":{"items":{"type":"string"},"type":"array","title":"Missing Fields"}},"type":"object","required":["complete"],"title":"QuerentStatusOut","description":"Whether the signed-in user has the birth profile required by Jyotish."},"QuestionDetails":{"properties":{"text":{"type":"string","maxLength":500,"minLength":1,"title":"Text"},"category":{"type":"string","maxLength":64,"title":"Category"},"asked_at":{"type":"string","format":"date-time","title":"Asked At"},"location":{"$ref":"#/components/schemas/QuestionLocation"}},"type":"object","required":["text","asked_at","location"],"title":"QuestionDetails"},"QuestionLocation":{"properties":{"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","maxLength":100,"minLength":1,"title":"Timezone"},"source":{"type":"string","pattern":"^(device_gps|manual|birth_place_fallback)$","title":"Source","default":"device_gps"}},"type":"object","required":["latitude","longitude","timezone"],"title":"QuestionLocation"},"QuickMatchRequest":{"properties":{"bride_nakshatra":{"type":"string","title":"Bride Nakshatra"},"bride_pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Bride Pada","default":1},"groom_nakshatra":{"type":"string","title":"Groom Nakshatra"},"groom_pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Groom Pada","default":1}},"type":"object","required":["bride_nakshatra","groom_nakshatra"],"title":"QuickMatchRequest","description":"Quick matching request with just Moon details.\n\nFor quick compatibility check when full birth details aren't available.\n\nAttributes:\n bride_nakshatra: Bride's birth nakshatra (1-27 or name)\n bride_pada: Bride's nakshatra pada (1-4)\n groom_nakshatra: Groom's birth nakshatra (1-27 or name)\n groom_pada: Groom's nakshatra pada (1-4)"},"QuickMatchResponse":{"properties":{"bride_nakshatra":{"type":"string","title":"Bride Nakshatra"},"groom_nakshatra":{"type":"string","title":"Groom Nakshatra"},"total_points":{"type":"number","title":"Total Points"},"max_points":{"type":"number","title":"Max Points","default":36},"percentage":{"type":"number","title":"Percentage"},"compatibility_level":{"$ref":"#/components/schemas/CompatibilityLevel"},"koota_summary":{"additionalProperties":{"additionalProperties":{"type":"string"},"type":"object"},"type":"object","title":"Koota Summary"},"has_nadi_dosha":{"type":"boolean","title":"Has Nadi Dosha"},"has_gana_dosha":{"type":"boolean","title":"Has Gana Dosha"},"quick_verdict":{"type":"string","title":"Quick Verdict"},"note":{"type":"string","title":"Note","default":"For accurate analysis, provide complete birth details"}},"type":"object","required":["bride_nakshatra","groom_nakshatra","total_points","percentage","compatibility_level","koota_summary","has_nadi_dosha","has_gana_dosha","quick_verdict"],"title":"QuickMatchResponse","description":"Quick matching response with basic compatibility.\n\nAttributes:\n bride_nakshatra: Bride's nakshatra name\n groom_nakshatra: Groom's nakshatra name\n total_points: Total Guna points\n percentage: Compatibility percentage\n compatibility_level: Overall compatibility level\n koota_summary: Summary of each koota\n has_nadi_dosha: Whether Nadi dosha exists\n has_gana_dosha: Whether Gana dosha exists (Deva-Rakshasa)\n quick_verdict: Quick recommendation"},"QuickNameRequest":{"properties":{"nakshatra":{"type":"string","title":"Nakshatra","description":"Nakshatra name or number (1-27)"},"pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada","default":1},"gender":{"allOf":[{"$ref":"#/components/schemas/app__schemas__baby_name__Gender"}],"default":"unisex"},"max_suggestions":{"type":"integer","maximum":50.0,"minimum":5.0,"title":"Max Suggestions","default":20}},"type":"object","required":["nakshatra"],"title":"QuickNameRequest","description":"Simplified request using just nakshatra.\n\nAttributes:\n nakshatra: Birth nakshatra (1-27) or name\n pada: Nakshatra pada (1-4)\n gender: Gender preference\n max_suggestions: Maximum suggestions"},"QuickNameResponse":{"properties":{"nakshatra":{"type":"string","title":"Nakshatra"},"pada":{"type":"integer","title":"Pada"},"auspicious_syllables":{"items":{"type":"string"},"type":"array","title":"Auspicious Syllables"},"suggestions":{"items":{"$ref":"#/components/schemas/NameSuggestion"},"type":"array","title":"Suggestions"},"note":{"type":"string","title":"Note"}},"type":"object","required":["nakshatra","pada","auspicious_syllables","suggestions","note"],"title":"QuickNameResponse","description":"Quick name response based on nakshatra only.\n\nAttributes:\n nakshatra: Nakshatra name\n pada: Pada number\n auspicious_syllables: Syllables for this nakshatra/pada\n suggestions: Name suggestions\n note: Additional note"},"QuickRectificationRequest":{"properties":{"birth_date":{"type":"string","format":"date","title":"Birth Date"},"approximate_time":{"type":"string","title":"Approximate Time"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","default":"UTC"},"marriage_date":{"type":"string","format":"date","title":"Marriage Date"},"first_child_date":{"type":"string","format":"date","title":"First Child Date"},"father_death_date":{"type":"string","format":"date","title":"Father Death Date"},"mother_death_date":{"type":"string","format":"date","title":"Mother Death Date"},"first_job_date":{"type":"string","format":"date","title":"First Job Date"}},"type":"object","required":["birth_date","approximate_time","latitude","longitude"],"title":"QuickRectificationRequest"},"QuickRectificationResponse":{"properties":{"rectified_time":{"type":"string","format":"date-time","title":"Rectified Time"},"confidence":{"type":"string","title":"Confidence"},"confidence_score":{"type":"number","title":"Confidence Score"},"ascendant":{"type":"string","title":"Ascendant"},"ascendant_degree":{"type":"number","title":"Ascendant Degree"},"navamsa_lagna":{"type":"string","title":"Navamsa Lagna"},"events_matched":{"type":"integer","title":"Events Matched"},"total_events":{"type":"integer","title":"Total Events"},"event_match_details":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Event Match Details"},"primary_method":{"type":"string","title":"Primary Method"},"suggestion":{"type":"string","title":"Suggestion"}},"type":"object","required":["rectified_time","confidence","confidence_score","ascendant","ascendant_degree","navamsa_lagna","events_matched","total_events","event_match_details","primary_method","suggestion"],"title":"QuickRectificationResponse","description":"Response for quick rectification.\n\nAttributes:\n rectified_time: Best rectified time\n confidence: Confidence level\n ascendant: Ascendant at rectified time\n events_matched: How many events matched\n primary_method: Primary method used\n suggestion: Recommendation for more accurate rectification"},"RahuKaalDayOut":{"properties":{"date":{"type":"string","title":"Date"},"weekday":{"type":"string","title":"Weekday"},"location":{"$ref":"#/components/schemas/app__routers__astro_calendar__LocationOut"},"sunrise":{"type":"string","title":"Sunrise"},"sunset":{"type":"string","title":"Sunset"},"rahu_kaal":{"$ref":"#/components/schemas/RahuKaalDetailOut"},"advice":{"type":"string","title":"Advice"}},"type":"object","required":["date","weekday","location","sunrise","sunset","rahu_kaal","advice"],"title":"RahuKaalDayOut"},"RahuKaalDetailOut":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"duration_minutes":{"type":"integer","title":"Duration Minutes"}},"type":"object","required":["start","end","duration_minutes"],"title":"RahuKaalDetailOut"},"RahuKaalOut":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"note":{"type":"string","title":"Note"}},"type":"object","required":["start","end","note"],"title":"RahuKaalOut"},"RajYogaSummary":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"strongest_yoga":{"type":"string","title":"Strongest Yoga"},"kendra_trikona_connections":{"type":"integer","title":"Kendra Trikona Connections","default":0},"yogas":{"items":{"$ref":"#/components/schemas/YogaData"},"type":"array","title":"Yogas"},"overall_strength":{"type":"string","title":"Overall Strength","description":"strong, moderate, weak, or none"},"life_area_impact":{"items":{"type":"string"},"type":"array","title":"Life Area Impact"}},"type":"object","required":["total_count","yogas","overall_strength"],"title":"RajYogaSummary","description":"Summary of Raj Yogas (power/authority combinations).\n\nAttributes:\n total_count: Number of Raj Yogas present\n strongest_yoga: Name of the strongest Raj Yoga\n kendra_trikona_connections: Number of Kendra-Trikona lord connections\n yogas: List of individual Raj Yoga details\n overall_strength: Combined strength assessment\n life_area_impact: Areas of life most impacted"},"RashiInfo":{"properties":{"number":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Number"},"sanskrit_name":{"type":"string","title":"Sanskrit Name"},"english_name":{"type":"string","title":"English Name"},"element":{"type":"string","title":"Element"},"ruling_planet":{"type":"string","title":"Ruling Planet"},"auspicious_letters":{"items":{"type":"string"},"type":"array","title":"Auspicious Letters"},"qualities":{"items":{"type":"string"},"type":"array","title":"Qualities"}},"type":"object","required":["number","sanskrit_name","english_name","element","ruling_planet","auspicious_letters","qualities"],"title":"RashiInfo","description":"Information about the Moon rashi.\n\nAttributes:\n number: Rashi number (0-11)\n sanskrit_name: Sanskrit name\n english_name: English name\n element: Fire, Earth, Air, or Water\n ruling_planet: Planet ruling this sign\n auspicious_letters: Letters for naming\n qualities: Key qualities"},"RashiNameRequest":{"properties":{"rashi":{"type":"string","title":"Rashi","description":"Rashi name (e.g., 'Aries', 'Mesha') or number (0-11)"},"gender":{"allOf":[{"$ref":"#/components/schemas/app__schemas__baby_name__Gender"}],"default":"unisex"},"max_suggestions":{"type":"integer","maximum":50.0,"minimum":5.0,"title":"Max Suggestions","default":20}},"type":"object","required":["rashi"],"title":"RashiNameRequest","description":"Request for names based on Moon rashi (zodiac sign).\n\nAttributes:\n rashi: Moon sign name or number (0-11)\n gender: Gender preference\n max_suggestions: Maximum suggestions"},"RashiNameResponse":{"properties":{"rashi":{"type":"string","title":"Rashi"},"auspicious_letters":{"items":{"type":"string"},"type":"array","title":"Auspicious Letters"},"suggestions":{"items":{"$ref":"#/components/schemas/NameSuggestion"},"type":"array","title":"Suggestions"},"note":{"type":"string","title":"Note"}},"type":"object","required":["rashi","auspicious_letters","suggestions","note"],"title":"RashiNameResponse","description":"Name response based on Moon rashi.\n\nAttributes:\n rashi: Rashi name\n auspicious_letters: Letters for this rashi\n suggestions: Name suggestions\n note: Additional note"},"RashiReading":{"properties":{"rashi":{"type":"string","title":"Rashi"},"rashi_hi":{"type":"string","title":"Rashi Hi"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House","description":"Counted from the reader's janma rashi, inclusive"},"domain":{"type":"string","title":"Domain"},"intensity":{"type":"string","title":"Intensity"},"intensity_label":{"type":"string","title":"Intensity Label"},"intensity_score":{"type":"integer","title":"Intensity Score"},"factors":{"items":{"type":"object"},"type":"array","title":"Factors","description":"Every signal and its weight, so the score can be checked rather than believed"},"sentences":{"items":{"type":"string"},"type":"array","title":"Sentences"},"effect":{"type":"string","title":"Effect"},"named_yogas":{"items":{"$ref":"#/components/schemas/NamedYoga"},"type":"array","title":"Named Yogas"},"lord":{"type":"object","title":"Lord"},"basis":{"type":"string","title":"Basis"},"language":{"type":"string","title":"Language"}},"type":"object","required":["rashi","house","domain","intensity","intensity_label","intensity_score","sentences","effect","lord","basis","language"],"title":"RashiReading"},"RashiVedha":{"properties":{"natal_rashi":{"type":"string","title":"Natal Rashi"},"transiting_rashis":{"items":{"type":"string"},"type":"array","title":"Transiting Rashis"},"vedha_rashis":{"items":{"type":"string"},"type":"array","title":"Vedha Rashis"},"effect":{"type":"string","title":"Effect"}},"type":"object","required":["natal_rashi","transiting_rashis","vedha_rashis","effect"],"title":"RashiVedha","description":"Rashi/Sign Vedha analysis"},"RashifalJournalContext":{"properties":{"sign":{"type":"string","maxLength":32,"minLength":1,"title":"Sign"},"ayanamsa":{"type":"string","maxLength":32,"title":"Ayanamsa"},"resonance":{"type":"string","pattern":"^(yes|partly|not-today)$","title":"Resonance"}},"type":"object","required":["sign"],"title":"RashifalJournalContext","description":"Reading context preserved when a Rashiphal observation becomes a journal."},"ReadingState":{"properties":{"last_chapter":{"type":"integer","minimum":0.0,"title":"Last Chapter"},"last_position":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Last Position","description":"0..1 scroll fraction","default":0.0},"last_read_at":{"type":"string","title":"Last Read At"}},"type":"object","required":["last_chapter"],"title":"ReadingState"},"RecentActivity":{"properties":{"activity_type":{"type":"string","title":"Activity Type"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"icon":{"type":"string","title":"Icon"}},"type":"object","required":["activity_type","title","description","timestamp"],"title":"RecentActivity","description":"Recent activity item."},"RectificationMethod":{"type":"string","enum":["event_based","tattwa_shuddhi","prenatal_epoch","kp_sublord","dasha_correlation","navamsa_based","composite"],"title":"RectificationMethod","description":"Available rectification methods."},"RectificationRequest":{"properties":{"approximate_birth":{"$ref":"#/components/schemas/ApproximateBirthTime"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","default":"UTC"},"life_events":{"items":{"$ref":"#/components/schemas/LifeEvent"},"type":"array","maxItems":25,"minItems":1,"title":"Life Events","description":"At least one significant life event required (at most 25)"},"rectification_method":{"allOf":[{"$ref":"#/components/schemas/RectificationMethod"}],"description":"Rectification method to use","default":"composite"},"search_interval_minutes":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Search Interval Minutes","description":"Minutes between each trial time","default":4},"use_all_methods":{"type":"boolean","title":"Use All Methods","description":"Cross-validate using all available methods","default":true}},"type":"object","required":["approximate_birth","latitude","longitude","life_events"],"title":"RectificationRequest"},"RectificationResponse":{"properties":{"original_approximate_time":{"type":"string","title":"Original Approximate Time"},"rectified_birth_time":{"type":"string","format":"date-time","title":"Rectified Birth Time"},"confidence_level":{"type":"string","title":"Confidence Level","description":"high, medium, or low"},"confidence_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Confidence Score"},"top_candidates":{"items":{"$ref":"#/components/schemas/RectifiedTimeCandidate"},"type":"array","title":"Top Candidates"},"method_comparison":{"items":{"$ref":"#/components/schemas/MethodComparison"},"type":"array","title":"Method Comparison"},"dasha_event_analysis":{"items":{"$ref":"#/components/schemas/DashaEventMatch"},"type":"array","title":"Dasha Event Analysis"},"ascendant_details":{"additionalProperties":{"type":"string"},"type":"object","title":"Ascendant Details"},"important_cusps":{"additionalProperties":{"type":"number"},"type":"object","title":"Important Cusps"},"verification_suggestions":{"items":{"type":"string"},"type":"array","title":"Verification Suggestions"},"disclaimer":{"type":"string","title":"Disclaimer"}},"type":"object","required":["original_approximate_time","rectified_birth_time","confidence_level","confidence_score","top_candidates","dasha_event_analysis","ascendant_details","important_cusps","verification_suggestions","disclaimer"],"title":"RectificationResponse","description":"Complete birth time rectification response.\n\nAttributes:\n original_approximate_time: Original approximate time given\n rectified_birth_time: Best rectified birth time\n confidence_level: Overall confidence (high, medium, low)\n confidence_score: Numerical confidence 0-100\n top_candidates: Top candidate times with scores\n method_comparison: Comparison across methods\n dasha_event_analysis: How rectified time matches events\n ascendant_details: Details of rectified ascendant\n important_cusps: Key house cusps at rectified time\n verification_suggestions: Suggestions to verify rectification\n disclaimer: Standard disclaimer about rectification"},"RectifiedTimeCandidate":{"properties":{"rectified_time":{"type":"string","format":"date-time","title":"Rectified Time"},"confidence_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Confidence Score"},"ascendant_sign":{"type":"string","title":"Ascendant Sign"},"ascendant_degree":{"type":"number","title":"Ascendant Degree"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Nakshatra Pada"},"navamsa_lagna":{"type":"string","title":"Navamsa Lagna"},"method_used":{"$ref":"#/components/schemas/RectificationMethod"},"supporting_factors":{"items":{"type":"string"},"type":"array","title":"Supporting Factors"},"conflicting_factors":{"items":{"type":"string"},"type":"array","title":"Conflicting Factors"},"dasha_matches":{"items":{"$ref":"#/components/schemas/DashaEventMatch"},"type":"array","title":"Dasha Matches"}},"type":"object","required":["rectified_time","confidence_score","ascendant_sign","ascendant_degree","nakshatra","nakshatra_pada","navamsa_lagna","method_used","supporting_factors","conflicting_factors","dasha_matches"],"title":"RectifiedTimeCandidate","description":"A candidate rectified birth time with confidence score.\n\nAttributes:\n rectified_time: The proposed rectified time\n confidence_score: Score from 0-100\n ascendant_sign: Ascendant sign for this time\n ascendant_degree: Exact ascendant degree\n nakshatra: Ascendant nakshatra\n navamsa_lagna: Navamsa ascendant\n method_used: Which method suggested this time\n supporting_factors: Factors supporting this time\n conflicting_factors: Factors against this time\n dasha_matches: How well dashas match life events"},"RegionalLanguage":{"type":"string","enum":["sanskrit","hindi","tamil","telugu","kannada","malayalam","bengali","gujarati","marathi","punjabi","odia","english"],"title":"RegionalLanguage","description":"Regional language preference for mantras."},"Remedy":{"properties":{"for_graha":{"type":"string","title":"For Graha"},"for_graha_display":{"type":"string","title":"For Graha Display"},"why":{"type":"string","title":"Why"},"mantra":{"type":"object","title":"Mantra"},"daan":{"items":{"type":"string"},"type":"array","title":"Daan","description":"Items given, from the canonical table"},"day":{"type":"string","title":"Day"},"no_sutak":{"type":"string","title":"No Sutak","description":"Stated on every remedy: a gathering imposes no sutak, no fast and no prohibition"}},"type":"object","required":["for_graha","for_graha_display","why","mantra","no_sutak"],"title":"Remedy"},"RemedyBirthDetails":{"properties":{"date_of_birth":{"type":"string","format":"date","title":"Date Of Birth"},"time_of_birth":{"type":"string","title":"Time Of Birth"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","default":"Asia/Kolkata"},"preferences":{"$ref":"#/components/schemas/UserRemedyPreferences"}},"type":"object","required":["date_of_birth","time_of_birth","latitude","longitude"],"title":"RemedyBirthDetails"},"RemedyCategory":{"type":"string","enum":["gemstone","mantra","puja","charity","fasting","yantra","color","rudraksha","mala","seva","temple","lifestyle"],"title":"RemedyCategory","description":"Categories of remedies."},"RemedyPriority":{"properties":{"remedy_type":{"$ref":"#/components/schemas/RemedyCategory"},"remedy_name":{"type":"string","title":"Remedy Name"},"priority_rank":{"type":"integer","title":"Priority Rank"},"reason":{"type":"string","title":"Reason"},"urgency":{"$ref":"#/components/schemas/RemedyUrgency"}},"type":"object","required":["remedy_type","remedy_name","priority_rank","reason","urgency"],"title":"RemedyPriority","description":"Priority ranking of a remedy."},"RemedyRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/RemedyBirthDetails"},"specific_problems":{"items":{"$ref":"#/components/schemas/LifeProblem"},"type":"array"},"budget_constraint":{"type":"string","title":"Budget Constraint"}},"type":"object","required":["birth_details"],"title":"RemedyRequest","description":"Request for comprehensive remedies."},"RemedyUrgency":{"type":"string","enum":["immediate","soon","moderate","long_term"],"title":"RemedyUrgency","description":"Urgency level for remedies."},"RitualCallbackCreate":{"properties":{"ritual_id":{"type":"string","maxLength":100,"minLength":1,"title":"Ritual Id"},"ritual_name":{"type":"string","maxLength":200,"minLength":1,"title":"Ritual Name"},"mode":{"type":"string","maxLength":50,"title":"Mode"},"language":{"type":"string","maxLength":50,"title":"Language"},"preferred_date":{"type":"string","maxLength":50,"title":"Preferred Date"},"preferred_time":{"type":"string","maxLength":100,"title":"Preferred Time"},"purohit_id":{"type":"string","maxLength":100,"title":"Purohit Id"},"name":{"type":"string","maxLength":200,"minLength":2,"title":"Name"},"contact":{"type":"string","maxLength":200,"minLength":5,"title":"Contact"},"notes":{"type":"string","maxLength":2000,"title":"Notes"}},"type":"object","required":["ritual_id","ritual_name","name","contact"],"title":"RitualCallbackCreate","description":"Public 'Request a Purohit callback' submission."},"RitualCallbackListResponse":{"properties":{"requests":{"items":{"$ref":"#/components/schemas/RitualCallbackResponse"},"type":"array","title":"Requests"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"status_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Status Counts"}},"type":"object","required":["requests","total","page","page_size","status_counts"],"title":"RitualCallbackListResponse"},"RitualCallbackResponse":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"ritual_id":{"type":"string","title":"Ritual Id"},"ritual_name":{"type":"string","title":"Ritual Name"},"mode":{"type":"string","title":"Mode"},"language":{"type":"string","title":"Language"},"preferred_date":{"type":"string","title":"Preferred Date"},"preferred_time":{"type":"string","title":"Preferred Time"},"purohit_id":{"type":"string","title":"Purohit Id"},"scheduled_start":{"type":"string","format":"date-time","title":"Scheduled Start"},"scheduled_end":{"type":"string","format":"date-time","title":"Scheduled End"},"schedule_timezone":{"type":"string","title":"Schedule Timezone"},"venue_address":{"type":"string","title":"Venue Address"},"schedule_version":{"type":"integer","title":"Schedule Version","default":1},"name":{"type":"string","title":"Name"},"contact":{"type":"string","title":"Contact"},"notes":{"type":"string","title":"Notes"},"status":{"type":"string","title":"Status"},"status_changed_at":{"type":"string","format":"date-time","title":"Status Changed At"},"seva_stage":{"type":"string","enum":["preparing","travelling","arrived","started","completed"],"title":"Seva Stage","default":"preparing"},"seva_stage_changed_at":{"type":"string","format":"date-time","title":"Seva Stage Changed At"},"family_tracking_active":{"type":"boolean","title":"Family Tracking Active","default":false},"admin_note":{"type":"string","title":"Admin Note"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","ritual_id","ritual_name","name","contact","status","status_changed_at","created_at","updated_at"],"title":"RitualCallbackResponse"},"RitualCallbackUpdate":{"properties":{"status":{"type":"string","enum":["new","contacted","scheduled","completed","cancelled"],"title":"Status"},"admin_note":{"type":"string","maxLength":2000,"title":"Admin Note"}},"type":"object","title":"RitualCallbackUpdate","description":"Admin queue transition."},"RitualProviderWorkResponse":{"properties":{"request":{"$ref":"#/components/schemas/RitualCallbackResponse"},"work_state":{"$ref":"#/components/schemas/ProviderWorkState"},"work_updated_at":{"type":"string","format":"date-time","title":"Work Updated At"}},"type":"object","required":["request","work_state","work_updated_at"],"title":"RitualProviderWorkResponse"},"RitualRecommendation":{"properties":{"name":{"type":"string","title":"Name"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"timing":{"type":"string","title":"Timing"},"benefits":{"items":{"type":"string"},"type":"array","title":"Benefits"},"items_needed":{"items":{"type":"string"},"type":"array","title":"Items Needed"},"mantra":{"type":"string","title":"Mantra"},"fasting_required":{"type":"boolean","title":"Fasting Required"}},"type":"object","required":["name","title","description","timing","benefits","items_needed","mantra","fasting_required"],"title":"RitualRecommendation","description":"Schema for ritual recommendations."},"RitualType":{"type":"string","enum":["meditation","prayer","yoga","breathing_exercises","journaling","aromatherapy","crystal_healing","moon_ritual","other"],"title":"RitualType","description":"Types of rituals that can be tracked."},"RudrakshaDetails":{"properties":{"mukhi":{"type":"integer","title":"Mukhi"},"ruling_planet":{"type":"string","title":"Ruling Planet"},"ruling_deity":{"type":"string","title":"Ruling Deity"},"purpose":{"type":"string","title":"Purpose"},"rarity":{"type":"string","title":"Rarity"},"price_range":{"type":"string","title":"Price Range"}},"type":"object","required":["mukhi","ruling_planet","ruling_deity","purpose","rarity","price_range"],"title":"RudrakshaDetails","description":"Details of a rudraksha."},"RudrakshaRecommendation":{"properties":{"primary_rudraksha":{"$ref":"#/components/schemas/RudrakshaRemedy"},"combination_mala":{"items":{"$ref":"#/components/schemas/RudrakshaRemedy"},"type":"array","title":"Combination Mala"},"wearing_guide":{"type":"string","title":"Wearing Guide"}},"type":"object","required":["primary_rudraksha","combination_mala","wearing_guide"],"title":"RudrakshaRecommendation","description":"Complete rudraksha recommendation set."},"RudrakshaRemedy":{"properties":{"rudraksha":{"$ref":"#/components/schemas/RudrakshaDetails"},"reason":{"type":"string","title":"Reason"},"problem_addressed":{"type":"string","title":"Problem Addressed"},"thread_type":{"type":"string","title":"Thread Type"},"wearing_method":{"type":"string","title":"Wearing Method"},"activation_mantra":{"type":"string","title":"Activation Mantra"},"mantra_count":{"type":"integer","title":"Mantra Count"},"best_day_to_wear":{"type":"string","title":"Best Day To Wear"},"care_instructions":{"items":{"type":"string"},"type":"array","title":"Care Instructions"},"do_not_combine_with":{"items":{"type":"integer"},"type":"array","title":"Do Not Combine With"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["rudraksha","reason","problem_addressed","thread_type","wearing_method","activation_mantra","mantra_count","best_day_to_wear","care_instructions","do_not_combine_with","effectiveness_score"],"title":"RudrakshaRemedy","description":"Rudraksha recommendation."},"RulingPlanetsRequest":{"properties":{"query_time":{"type":"string","format":"date-time","title":"Query Time","description":"Time of query"},"moon_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Moon Longitude"},"ascendant_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Ascendant Longitude"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude","description":"For sunrise day lord"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","description":"Derived from latitude/longitude when given; any value sent is replaced"}},"type":"object","required":["query_time","moon_longitude","ascendant_longitude"],"title":"RulingPlanetsRequest"},"SBCVedha":{"properties":{"transit_planet":{"type":"string","title":"Transit Planet"},"transit_nakshatra":{"type":"string","title":"Transit Nakshatra"},"vedha_type":{"$ref":"#/components/schemas/VedhaType"},"affected_element":{"type":"string","title":"Affected Element"},"vedha_direction":{"type":"string","title":"Vedha Direction"},"effect":{"$ref":"#/components/schemas/VedhaEffect"},"intensity":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Intensity"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["transit_planet","transit_nakshatra","vedha_type","affected_element","vedha_direction","effect","intensity","interpretation"],"title":"SBCVedha","description":"Vedha (obstruction) in Sarvatobhadra Chakra"},"SadeSatiAnalysis":{"properties":{"is_active":{"type":"boolean","title":"Is Active"},"current_phase":{"$ref":"#/components/schemas/SadeSatiPhase"},"phase_description":{"type":"string","title":"Phase Description"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"phase_start":{"type":"string","format":"date-time","title":"Phase Start"},"phase_end":{"type":"string","format":"date-time","title":"Phase End"},"intensity":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Intensity","default":0},"affected_areas":{"items":{"type":"string"},"type":"array","title":"Affected Areas","default":[]},"challenges":{"items":{"type":"string"},"type":"array","title":"Challenges","default":[]},"opportunities":{"items":{"type":"string"},"type":"array","title":"Opportunities","default":[]},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies","default":[]},"previous_sade_sati":{"additionalProperties":{"type":"string","format":"date-time"},"type":"object","title":"Previous Sade Sati"},"next_sade_sati":{"additionalProperties":{"type":"string","format":"date-time"},"type":"object","title":"Next Sade Sati"}},"type":"object","required":["is_active","current_phase","phase_description"],"title":"SadeSatiAnalysis","description":"Sade Sati (Saturn's 7.5 year transit) analysis"},"SadeSatiPhase":{"type":"string","enum":["rising","peak","setting","not_active"],"title":"SadeSatiPhase","description":"Sade Sati phases"},"SadeSatiRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"birth_time":{"type":"string","title":"Birth Time"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"analysis_date":{"type":"string","title":"Analysis Date"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude"],"title":"SadeSatiRequest","description":"Request for Sade Sati analysis only"},"SadeSatiResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"sade_sati":{"$ref":"#/components/schemas/SadeSatiAnalysis"},"dhaiya":{"$ref":"#/components/schemas/DhaiyaAnalysis"}},"type":"object","required":["sade_sati","dhaiya"],"title":"SadeSatiResponse","description":"Response for Sade Sati analysis"},"SahamData":{"properties":{"name":{"type":"string","title":"Name"},"saham_type":{"$ref":"#/components/schemas/SahamType"},"longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Longitude"},"sign":{"type":"string","title":"Sign"},"sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign Num"},"degree_in_sign":{"type":"number","exclusiveMaximum":30.0,"minimum":0.0,"title":"Degree In Sign"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"lord":{"type":"string","title":"Lord"},"strength":{"type":"string","title":"Strength"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["name","saham_type","longitude","sign","sign_num","degree_in_sign","house","lord","strength","interpretation"],"title":"SahamData","description":"Individual Saham (Arabic Part) data"},"SahamRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"birth_time":{"type":"string","title":"Birth Time"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"year":{"type":"integer","title":"Year"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Tajika sidereal ayanamsa (default Lahiri)"},"sahams_to_calculate":{"items":{"$ref":"#/components/schemas/SahamType"},"type":"array"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude","year"],"title":"SahamRequest","description":"Request for Saham calculations"},"SahamResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"sahams":{"items":{"$ref":"#/components/schemas/SahamData"},"type":"array","title":"Sahams"},"most_favorable":{"items":{"type":"string"},"type":"array","title":"Most Favorable"},"challenging":{"items":{"type":"string"},"type":"array","title":"Challenging"}},"type":"object","required":["sahams","most_favorable","challenging"],"title":"SahamResponse","description":"Response for Saham calculations"},"SahamType":{"type":"string","enum":["punya","vidya","yasas","mitra","mahatmya","asha","samartha","bhratri","gaurav","pitri","rajya","matri","putra","jeeva","karma","roga","kali","mrityu","paradesa","vivaha","santana"],"title":"SahamType","description":"16 Main Sahams (Arabic Parts/Lots)"},"SamagamaCategory":{"type":"string","enum":["yuti","kutami","yuddha"],"title":"SamagamaCategory","description":"An enumeration."},"SamagamaEventOut":{"properties":{"event_id":{"type":"string","title":"Event Id"},"category":{"$ref":"#/components/schemas/SamagamaCategory"},"rashi":{"type":"string","title":"Rashi"},"rashi_display":{"type":"string","title":"Rashi Display"},"rashi_index":{"type":"integer","title":"Rashi Index"},"grahas":{"items":{"type":"string"},"type":"array","title":"Grahas"},"grahas_display":{"items":{"type":"string"},"type":"array","title":"Grahas Display"},"graha_count":{"type":"integer","title":"Graha Count"},"starts":{"type":"string","format":"date-time","title":"Starts"},"peak":{"type":"string","format":"date-time","title":"Peak"},"ends":{"type":"string","format":"date-time","title":"Ends"},"in_force":{"type":"boolean","title":"In Force","description":"The span contains the moment the search was made"},"peak_separation_degrees":{"type":"number","title":"Peak Separation Degrees"},"recurrence_years":{"type":"number","title":"Recurrence Years","description":"About how often this pair meets. Absent for three or more — there is no cycle to report"},"participants":{"items":{"$ref":"#/components/schemas/Participant"},"type":"array","title":"Participants"},"named_yogas":{"items":{"$ref":"#/components/schemas/NamedYoga"},"type":"array","title":"Named Yogas"},"winner":{"type":"string","title":"Winner"},"loser":{"type":"string","title":"Loser"},"yuddha_rule":{"type":"string","title":"Yuddha Rule","description":"Which rule decided the victor, since schools differ"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"remedies":{"$ref":"#/components/schemas/Remedy"},"reading":{"allOf":[{"$ref":"#/components/schemas/RashiReading"}],"title":"Reading","description":"For the rashi asked about, when one was asked about"},"all_rashis":{"items":{"$ref":"#/components/schemas/RashiReading"},"type":"array","title":"All Rashis","description":"All twelve, when the caller asked for the whole page"}},"type":"object","required":["event_id","category","rashi","rashi_index","grahas","graha_count","starts","peak","ends","in_force","participants","ayanamsa"],"title":"SamagamaEventOut"},"SamagamaPeriod":{"type":"string","enum":["month","year","three_years","rare"],"title":"SamagamaPeriod","description":"The windows the page offers, because one window cannot fit these cadences.\n\nA Moon yuti recurs monthly and a Guru-Shani yuti every twenty years; asking a\ncaller to pick a start and end date to find the latter is asking them to\nalready know the answer. ``rare`` is horizonless: it looks up the next of each\nlong-period thing rather than listing a period at all."},"SamagamaSearchResult":{"properties":{"total_count":{"type":"integer","title":"Total Count"},"yuti_count":{"type":"integer","title":"Yuti Count"},"kutami_count":{"type":"integer","title":"Kutami Count"},"yuddha_count":{"type":"integer","title":"Yuddha Count"},"in_force_count":{"type":"integer","title":"In Force Count"},"period":{"type":"string","title":"Period"},"searched_from":{"type":"string","format":"date-time","title":"Searched From"},"searched_to":{"type":"string","format":"date-time","title":"Searched To","description":"Absent for the rare lookup, which has no window to state"},"ayanamsa":{"type":"string","title":"Ayanamsa"},"include_moon":{"type":"boolean","title":"Include Moon"},"rashi":{"type":"string","title":"Rashi"},"language":{"type":"string","title":"Language"},"events":{"items":{"$ref":"#/components/schemas/SamagamaEventOut"},"type":"array","title":"Events"}},"type":"object","required":["total_count","yuti_count","kutami_count","yuddha_count","in_force_count","period","searched_from","ayanamsa","include_moon","language","events"],"title":"SamagamaSearchResult"},"SamskaraCandidate":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"start_time":{"type":"string","title":"Start Time"},"end_time":{"type":"string","title":"End Time"},"score":{"type":"number","title":"Score"},"quality":{"type":"string","title":"Quality"},"panchanga":{"type":"object","title":"Panchanga"},"strengths":{"items":{"type":"string"},"type":"array","title":"Strengths"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"primary_chart_score":{"type":"number","title":"Primary Chart Score"},"partner_chart_score":{"type":"number","title":"Partner Chart Score"},"tarabala_score":{"type":"number","title":"Tarabala Score"},"chandrabala_score":{"type":"number","title":"Chandrabala Score"},"verification_status":{"type":"string","title":"Verification Status"}},"type":"object","required":["date","score","quality","panchanga","strengths","warnings","verification_status"],"title":"SamskaraCandidate"},"SamskaraCandidateRequest":{"properties":{"samskara_key":{"type":"string","maxLength":80,"minLength":2,"title":"Samskara Key"},"start_date":{"type":"string","format":"date","title":"Start Date"},"end_date":{"type":"string","format":"date","title":"End Date"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","maxLength":100,"minLength":1,"title":"Timezone"},"birth_at":{"type":"string","format":"date-time","title":"Birth At"},"partner_birth_at":{"type":"string","format":"date-time","title":"Partner Birth At"},"max_results":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Max Results","default":7},"tradition":{"type":"string","maxLength":160,"minLength":2,"title":"Tradition","default":"telugu_smarta_apastamba"},"region_id":{"type":"string","maxLength":60,"minLength":2,"title":"Region Id"},"sampradaya_id":{"type":"string","maxLength":60,"minLength":2,"title":"Sampradaya Id"},"ritual_school_id":{"type":"string","maxLength":60,"minLength":2,"title":"Ritual School Id"}},"type":"object","required":["samskara_key","start_date","end_date","latitude","longitude","timezone"],"title":"SamskaraCandidateRequest"},"SamskaraCandidateResponse":{"properties":{"samskara_key":{"type":"string","title":"Samskara Key"},"samskara_name":{"type":"string","title":"Samskara Name"},"chart_context":{"type":"string","title":"Chart Context"},"search_start":{"type":"string","format":"date","title":"Search Start"},"search_end":{"type":"string","format":"date","title":"Search End"},"tradition_profile":{"type":"object","title":"Tradition Profile"},"coverage_level":{"type":"string","title":"Coverage Level"},"coverage_note":{"type":"string","title":"Coverage Note"},"candidates":{"items":{"$ref":"#/components/schemas/SamskaraCandidate"},"type":"array","title":"Candidates"},"verification_note":{"type":"string","title":"Verification Note"},"medical_note":{"type":"string","title":"Medical Note"}},"type":"object","required":["samskara_key","samskara_name","chart_context","search_start","search_end","tradition_profile","coverage_level","coverage_note","candidates","verification_note","medical_note"],"title":"SamskaraCandidateResponse"},"SamskaraEventResponse":{"properties":{"id":{"type":"string","title":"Id"},"event_key":{"type":"string","title":"Event Key"},"sequence":{"type":"integer","title":"Sequence"},"name":{"type":"string","title":"Name"},"local_name":{"type":"string","title":"Local Name"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases"},"stage":{"type":"string","title":"Stage"},"classification":{"type":"string","title":"Classification"},"timing_kind":{"type":"string","title":"Timing Kind"},"timing_summary":{"type":"string","title":"Timing Summary"},"window_start":{"type":"string","format":"date","title":"Window Start"},"window_end":{"type":"string","format":"date","title":"Window End"},"eligibility_status":{"type":"string","title":"Eligibility Status"},"chart_role":{"type":"string","title":"Chart Role"},"supports_muhurta":{"type":"boolean","title":"Supports Muhurta"},"is_optional":{"type":"boolean","title":"Is Optional"},"medical_override":{"type":"boolean","title":"Medical Override"},"external_path":{"type":"string","title":"External Path"},"selected_date":{"type":"string","format":"date","title":"Selected Date"},"selected_start_time":{"type":"string","format":"time","title":"Selected Start Time"},"selected_end_time":{"type":"string","format":"time","title":"Selected End Time"},"verification_status":{"type":"string","title":"Verification Status"},"status":{"type":"string","title":"Status"},"guidance":{"type":"object","title":"Guidance"},"calculation":{"type":"object","title":"Calculation"},"candidate_snapshot":{"type":"object","title":"Candidate Snapshot"},"reminder_days_before":{"type":"integer","title":"Reminder Days Before"},"family_note":{"type":"string","title":"Family Note","default":""},"verification_note":{"type":"string","title":"Verification Note","default":""},"verified_at":{"type":"string","format":"date-time","title":"Verified At"},"completed_at":{"type":"string","format":"date-time","title":"Completed At"},"version":{"type":"integer","title":"Version","default":1}},"type":"object","required":["event_key","sequence","name","local_name","aliases","stage","classification","timing_kind","timing_summary","eligibility_status","chart_role","supports_muhurta","is_optional","medical_override","verification_status","status","guidance","calculation","reminder_days_before"],"title":"SamskaraEventResponse"},"SamskaraEventUpdate":{"properties":{"status":{"type":"string","enum":["unplanned","planning","scheduled","completed","skipped"],"title":"Status"},"selected_date":{"type":"string","format":"date","title":"Selected Date"},"selected_start_time":{"type":"string","format":"time","title":"Selected Start Time"},"selected_end_time":{"type":"string","format":"time","title":"Selected End Time"},"selection_reason":{"type":"string","maxLength":1000,"title":"Selection Reason","default":""},"candidate_snapshot":{"type":"object","title":"Candidate Snapshot"},"family_note":{"type":"string","maxLength":2000,"title":"Family Note"},"reminder_days_before":{"type":"integer","maximum":365.0,"minimum":0.0,"title":"Reminder Days Before"},"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"}},"type":"object","required":["expected_version"],"title":"SamskaraEventUpdate"},"SamskaraEventVerifyInput":{"properties":{"verified_date":{"type":"string","format":"date","title":"Verified Date"},"verified_start_time":{"type":"string","format":"time","title":"Verified Start Time"},"verified_end_time":{"type":"string","format":"time","title":"Verified End Time"},"verification_note":{"type":"string","maxLength":2000,"minLength":3,"title":"Verification Note"},"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"}},"type":"object","required":["verification_note","expected_version"],"title":"SamskaraEventVerifyInput"},"SamskaraJourneyInput":{"properties":{"family_person_id":{"type":"string","format":"uuid","title":"Family Person Id"},"person_name":{"type":"string","maxLength":200,"minLength":1,"title":"Person Name"},"relationship":{"type":"string","maxLength":80,"title":"Relationship","default":""},"birth_at":{"type":"string","format":"date-time","title":"Birth At"},"birth_location":{"type":"string","maxLength":250,"minLength":2,"title":"Birth Location"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","maxLength":100,"minLength":1,"title":"Birth Timezone"},"observance_location":{"type":"string","maxLength":250,"minLength":2,"title":"Observance Location"},"observance_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Observance Latitude"},"observance_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Observance Longitude"},"observance_timezone":{"type":"string","maxLength":100,"minLength":1,"title":"Observance Timezone"},"tradition":{"type":"string","maxLength":160,"minLength":2,"title":"Tradition","default":"telugu_smarta_apastamba"},"region_id":{"type":"string","maxLength":60,"minLength":2,"title":"Region Id"},"sampradaya_id":{"type":"string","maxLength":60,"minLength":2,"title":"Sampradaya Id"},"ritual_school_id":{"type":"string","maxLength":60,"minLength":2,"title":"Ritual School Id"},"sutra":{"type":"string","maxLength":100,"title":"Sutra","default":""},"language":{"type":"string","maxLength":30,"minLength":2,"title":"Language","default":"Telugu"},"private_notes":{"type":"string","maxLength":3000,"title":"Private Notes","default":""}},"type":"object","required":["person_name","birth_at","birth_location","birth_latitude","birth_longitude","birth_timezone","observance_location","observance_latitude","observance_longitude","observance_timezone"],"title":"SamskaraJourneyInput"},"SamskaraJourneyPreview":{"properties":{"calculation_version":{"type":"string","title":"Calculation Version"},"tradition":{"type":"string","title":"Tradition"},"tradition_label":{"type":"string","title":"Tradition Label"},"review_note":{"type":"string","title":"Review Note"},"tradition_profile":{"type":"object","title":"Tradition Profile"},"region_id":{"type":"string","title":"Region Id"},"sampradaya_id":{"type":"string","title":"Sampradaya Id"},"ritual_school_id":{"type":"string","title":"Ritual School Id"},"coverage_level":{"type":"string","title":"Coverage Level"},"coverage_note":{"type":"string","title":"Coverage Note"},"birth_at":{"type":"string","format":"date-time","title":"Birth At"},"natal_context":{"type":"object","title":"Natal Context"},"stages":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Stages"},"events":{"items":{"$ref":"#/components/schemas/SamskaraEventResponse"},"type":"array","title":"Events"},"privacy_note":{"type":"string","title":"Privacy Note"},"verification_note":{"type":"string","title":"Verification Note"},"medical_note":{"type":"string","title":"Medical Note"}},"type":"object","required":["calculation_version","tradition","tradition_label","review_note","tradition_profile","region_id","sampradaya_id","ritual_school_id","coverage_level","coverage_note","birth_at","natal_context","stages","events","privacy_note","verification_note","medical_note"],"title":"SamskaraJourneyPreview"},"SamskaraPlanResponse":{"properties":{"calculation_version":{"type":"string","title":"Calculation Version"},"tradition":{"type":"string","title":"Tradition"},"tradition_label":{"type":"string","title":"Tradition Label"},"review_note":{"type":"string","title":"Review Note"},"tradition_profile":{"type":"object","title":"Tradition Profile"},"region_id":{"type":"string","title":"Region Id"},"sampradaya_id":{"type":"string","title":"Sampradaya Id"},"ritual_school_id":{"type":"string","title":"Ritual School Id"},"coverage_level":{"type":"string","title":"Coverage Level"},"coverage_note":{"type":"string","title":"Coverage Note"},"birth_at":{"type":"string","format":"date-time","title":"Birth At"},"natal_context":{"type":"object","title":"Natal Context"},"stages":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Stages"},"events":{"items":{"$ref":"#/components/schemas/SamskaraEventResponse"},"type":"array","title":"Events"},"privacy_note":{"type":"string","title":"Privacy Note"},"verification_note":{"type":"string","title":"Verification Note"},"medical_note":{"type":"string","title":"Medical Note"},"id":{"type":"string","title":"Id"},"family_person_id":{"type":"string","title":"Family Person Id"},"person_name":{"type":"string","title":"Person Name"},"relationship":{"type":"string","title":"Relationship"},"birth_location":{"type":"string","title":"Birth Location"},"birth_latitude":{"type":"number","title":"Birth Latitude"},"birth_longitude":{"type":"number","title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone"},"observance_location":{"type":"string","title":"Observance Location"},"observance_latitude":{"type":"number","title":"Observance Latitude"},"observance_longitude":{"type":"number","title":"Observance Longitude"},"observance_timezone":{"type":"string","title":"Observance Timezone"},"sutra":{"type":"string","title":"Sutra"},"language":{"type":"string","title":"Language"},"status":{"type":"string","title":"Status"},"private_notes":{"type":"string","title":"Private Notes"},"purohit_id":{"type":"string","title":"Purohit Id"},"purohit_callback_id":{"type":"string","title":"Purohit Callback Id"},"version":{"type":"integer","title":"Version"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["calculation_version","tradition","tradition_label","review_note","tradition_profile","region_id","sampradaya_id","ritual_school_id","coverage_level","coverage_note","birth_at","natal_context","stages","events","privacy_note","verification_note","medical_note","id","person_name","relationship","birth_location","birth_latitude","birth_longitude","birth_timezone","observance_location","observance_latitude","observance_longitude","observance_timezone","sutra","language","status","private_notes","version","created_at","updated_at"],"title":"SamskaraPlanResponse"},"SamskaraPlanSummary":{"properties":{"id":{"type":"string","title":"Id"},"person_name":{"type":"string","title":"Person Name"},"relationship":{"type":"string","title":"Relationship"},"tradition":{"type":"string","title":"Tradition"},"birth_at":{"type":"string","format":"date-time","title":"Birth At"},"next_event":{"$ref":"#/components/schemas/SamskaraEventResponse"},"completed_events":{"type":"integer","title":"Completed Events"},"total_events":{"type":"integer","title":"Total Events"},"status":{"type":"string","title":"Status"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","person_name","relationship","tradition","birth_at","completed_events","total_events","status","updated_at"],"title":"SamskaraPlanSummary"},"SamskaraPlanUpdate":{"properties":{"status":{"type":"string","enum":["active","completed","archived"],"title":"Status"},"private_notes":{"type":"string","maxLength":3000,"title":"Private Notes"},"purohit_id":{"type":"string","maxLength":100,"title":"Purohit Id"},"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"}},"type":"object","required":["expected_version"],"title":"SamskaraPlanUpdate"},"SaptavargajaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"d1_position":{"type":"string","title":"D1 Position"},"d2_position":{"type":"string","title":"D2 Position"},"d3_position":{"type":"string","title":"D3 Position"},"d7_position":{"type":"string","title":"D7 Position"},"d9_position":{"type":"string","title":"D9 Position"},"d12_position":{"type":"string","title":"D12 Position"},"d30_position":{"type":"string","title":"D30 Position"},"d10_position":{"type":"string","title":"D10 Position"},"total_points":{"type":"number","title":"Total Points"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","d1_position","d2_position","d3_position","d7_position","d9_position","d12_position","d30_position","total_points","strength_virupas"],"title":"SaptavargajaBala","description":"Strength from seven divisional charts."},"SarvashtakavargaChart":{"properties":{"sign_totals":{"items":{"type":"integer"},"type":"array","title":"Sign Totals"},"average_bindus":{"type":"number","title":"Average Bindus"},"strongest_sign":{"type":"integer","title":"Strongest Sign"},"strongest_sign_name":{"type":"string","title":"Strongest Sign Name"},"strongest_sign_bindus":{"type":"integer","title":"Strongest Sign Bindus"},"weakest_sign":{"type":"integer","title":"Weakest Sign"},"weakest_sign_name":{"type":"string","title":"Weakest Sign Name"},"weakest_sign_bindus":{"type":"integer","title":"Weakest Sign Bindus"}},"type":"object","required":["sign_totals","average_bindus","strongest_sign","strongest_sign_name","strongest_sign_bindus","weakest_sign","weakest_sign_name","weakest_sign_bindus"],"title":"SarvashtakavargaChart","description":"Combined Ashtakavarga chart."},"SarvashtakavargaData":{"properties":{"bindus_by_sign":{"additionalProperties":{"type":"integer"},"type":"object","title":"Bindus By Sign","description":"Sign index (0-11) to total bindu count"},"total_bindus":{"type":"integer","title":"Total Bindus","description":"Sum of all bindus"},"strong_signs":{"items":{"type":"string"},"type":"array","title":"Strong Signs","description":"Signs with 28+ bindus (auspicious)"},"weak_signs":{"items":{"type":"string"},"type":"array","title":"Weak Signs","description":"Signs with <25 bindus (challenging)"},"sign_names":{"additionalProperties":{"type":"string"},"type":"object","title":"Sign Names","description":"Sign index to name mapping"}},"type":"object","required":["bindus_by_sign","total_bindus","sign_names"],"title":"SarvashtakavargaData","description":"Sarvashtakavarga (SAV) - combined bindus from all planets.\n\nThis is the sum of all Bhinnashtakavarga bindus for each sign.\nUsed for transit predictions and identifying strong/weak signs.\n\nAttributes:\n bindus_by_sign: Total bindus in each sign from all planets\n total_bindus: Grand total of all bindus (should be ~337 max)\n strong_signs: Signs with high bindu count (28+)\n weak_signs: Signs with low bindu count (<25)\n sign_names: Human-readable sign names"},"SarvatobhadraAnalysis":{"properties":{"analysis_date":{"type":"string","format":"date-time","title":"Analysis Date"},"birth_nakshatra":{"type":"string","title":"Birth Nakshatra"},"birth_nakshatra_pada":{"type":"integer","title":"Birth Nakshatra Pada"},"birth_rashi":{"type":"string","title":"Birth Rashi"},"chakra":{"$ref":"#/components/schemas/SarvatobhadraChakra"},"natal_planets_in_chakra":{"additionalProperties":{"$ref":"#/components/schemas/PlanetInChakra"},"type":"object","title":"Natal Planets In Chakra"},"transit_planets_in_chakra":{"additionalProperties":{"$ref":"#/components/schemas/PlanetInChakra"},"type":"object","title":"Transit Planets In Chakra"},"nakshatra_vedhas":{"items":{"$ref":"#/components/schemas/NakshatraVedha"},"type":"array","title":"Nakshatra Vedhas"},"rashi_vedhas":{"items":{"$ref":"#/components/schemas/RashiVedha"},"type":"array","title":"Rashi Vedhas"},"active_vedhas":{"items":{"$ref":"#/components/schemas/SBCVedha"},"type":"array","title":"Active Vedhas"},"current_transit_effects":{"items":{"$ref":"#/components/schemas/app__schemas__sarvatobhadra__TransitEffect"},"type":"array","title":"Current Transit Effects"},"timing_analysis":{"$ref":"#/components/schemas/TimingAnalysis"},"overall_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Overall Score"},"key_findings":{"items":{"type":"string"},"type":"array","title":"Key Findings"},"favorable_elements":{"items":{"type":"string"},"type":"array","title":"Favorable Elements"},"challenging_elements":{"items":{"type":"string"},"type":"array","title":"Challenging Elements"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["analysis_date","birth_nakshatra","birth_nakshatra_pada","birth_rashi","chakra","natal_planets_in_chakra","transit_planets_in_chakra","nakshatra_vedhas","rashi_vedhas","active_vedhas","current_transit_effects","overall_score","key_findings","favorable_elements","challenging_elements","recommendations"],"title":"SarvatobhadraAnalysis","description":"Complete Sarvatobhadra Chakra Analysis"},"SarvatobhadraChakra":{"properties":{"grid":{"items":{"items":{"$ref":"#/components/schemas/ChakraCell"},"type":"array"},"type":"array","title":"Grid"},"nakshatra_positions":{"additionalProperties":{"items":{},"type":"array"},"type":"object","title":"Nakshatra Positions"},"rashi_positions":{"additionalProperties":{"items":{},"type":"array"},"type":"object","title":"Rashi Positions"},"vara_positions":{"additionalProperties":{"items":{},"type":"array"},"type":"object","title":"Vara Positions"},"center":{"type":"string","title":"Center"}},"type":"object","required":["grid","nakshatra_positions","rashi_positions","vara_positions","center"],"title":"SarvatobhadraChakra","description":"Complete Sarvatobhadra Chakra representation"},"SarvatobhadraRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in YYYY-MM-DD format"},"birth_time":{"type":"string","title":"Birth Time","description":"Birth time in HH:MM:SS format"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"analysis_date":{"type":"string","title":"Analysis Date","description":"Date for analysis"},"include_transit_effects":{"type":"boolean","title":"Include Transit Effects","default":true},"include_timing":{"type":"boolean","title":"Include Timing","default":true}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude"],"title":"SarvatobhadraRequest","description":"Request for Sarvatobhadra analysis","example":{"birth_date":"1990-05-15","birth_time":"10:30:00","birth_latitude":28.6139,"birth_longitude":77.209,"birth_timezone":"Asia/Kolkata"}},"SarvatobhadraResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"analysis":{"$ref":"#/components/schemas/SarvatobhadraAnalysis"},"calculation_time_ms":{"type":"number","title":"Calculation Time Ms"}},"type":"object","required":["analysis","calculation_time_ms"],"title":"SarvatobhadraResponse","description":"Response for Sarvatobhadra analysis"},"SearchEntityType":{"type":"string","enum":["astrologer","content","service","remedy","all"],"title":"SearchEntityType","description":"Types of searchable entities."},"SearchResponse":{"properties":{"query":{"type":"string","title":"Query"},"results":{"items":{"$ref":"#/components/schemas/SearchResult"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total","default":0},"page":{"type":"integer","title":"Page","default":1},"page_size":{"type":"integer","title":"Page Size","default":20},"filters_applied":{"type":"object","title":"Filters Applied"},"suggestions":{"items":{"type":"string"},"type":"array","title":"Suggestions"},"search_time_ms":{"type":"number","title":"Search Time Ms","default":0.0}},"type":"object","required":["query"],"title":"SearchResponse","description":"Search response."},"SearchResult":{"properties":{"entity_type":{"$ref":"#/components/schemas/SearchEntityType"},"entity_id":{"type":"string","title":"Entity Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"relevance_score":{"type":"number","title":"Relevance Score","default":0.0},"metadata":{"type":"object","title":"Metadata"},"highlights":{"items":{"type":"string"},"type":"array","title":"Highlights"}},"type":"object","required":["entity_type","entity_id","title"],"title":"SearchResult","description":"A single search result."},"SetChartOut":{"properties":{"user_id":{"type":"string","title":"User Id"},"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"}},"type":"object","required":["user_id","status","message"],"title":"SetChartOut"},"SevaAssignmentUpdate":{"properties":{"purohit_id":{"type":"string","title":"Purohit Id"}},"type":"object","required":["purohit_id"],"title":"SevaAssignmentUpdate"},"SevaDayProviderResponse":{"properties":{"request":{"$ref":"#/components/schemas/RitualCallbackResponse"},"day_state":{"$ref":"#/components/schemas/SevaDayState"},"family_tracking_active":{"type":"boolean","title":"Family Tracking Active"},"family_tracking_expires_at":{"type":"string","format":"date-time","title":"Family Tracking Expires At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["request","day_state","family_tracking_active","updated_at"],"title":"SevaDayProviderResponse"},"SevaDayState":{"properties":{"version":{"type":"integer","minimum":1.0,"title":"Version","default":1},"stage":{"type":"string","enum":["preparing","travelling","arrived","started","completed"],"title":"Stage","default":"preparing"},"stage_changed_at":{"type":"string","format":"date-time","title":"Stage Changed At"},"public_message":{"type":"string","maxLength":500,"title":"Public Message","default":""},"internal_note":{"type":"string","maxLength":2000,"title":"Internal Note","default":""},"run_items":{"items":{"$ref":"#/components/schemas/SevaRunItem"},"type":"array","maxItems":50,"title":"Run Items"},"stage_history":{"items":{"$ref":"#/components/schemas/SevaStageEvent"},"type":"array","maxItems":50,"title":"Stage History"},"ceremony_session":{"$ref":"#/components/schemas/CeremonySession"},"settlement":{"$ref":"#/components/schemas/SevaSettlement"}},"type":"object","title":"SevaDayState"},"SevaDayUpdate":{"properties":{"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"},"stage":{"type":"string","enum":["preparing","travelling","arrived","started","completed"],"title":"Stage"},"public_message":{"type":"string","maxLength":500,"title":"Public Message"},"internal_note":{"type":"string","maxLength":2000,"title":"Internal Note"},"run_items":{"items":{"$ref":"#/components/schemas/SevaRunItem"},"type":"array","maxItems":50,"title":"Run Items"},"ceremony_session":{"$ref":"#/components/schemas/CeremonySession"},"settlement":{"$ref":"#/components/schemas/SevaSettlementInput"}},"type":"object","title":"SevaDayUpdate"},"SevaPlaybookStep":{"properties":{"id":{"type":"string","maxLength":80,"minLength":1,"title":"Id"},"phase":{"type":"string","enum":["preparation","purification","sankalpa","main_vidhi","offering","closure"],"title":"Phase","default":"main_vidhi"},"title":{"type":"string","maxLength":200,"minLength":2,"title":"Title"},"instruction":{"type":"string","maxLength":2000,"minLength":2,"title":"Instruction"},"mantra_title":{"type":"string","maxLength":200,"title":"Mantra Title","default":""},"mantra_text":{"type":"string","maxLength":5000,"title":"Mantra Text","default":""},"pronunciation":{"type":"string","maxLength":5000,"title":"Pronunciation","default":""},"meaning":{"type":"string","maxLength":2000,"title":"Meaning","default":""},"repetition_count":{"type":"integer","maximum":1008.0,"minimum":0.0,"title":"Repetition Count","default":0},"duration_minutes":{"type":"integer","maximum":720.0,"minimum":0.0,"title":"Duration Minutes","default":0},"caution":{"type":"string","maxLength":2000,"title":"Caution","default":""},"is_optional":{"type":"boolean","title":"Is Optional","default":false}},"type":"object","required":["id","title","instruction"],"title":"SevaPlaybookStep"},"SevaRecommendation":{"properties":{"primary_sevas":{"items":{"$ref":"#/components/schemas/SevaRemedy"},"type":"array","title":"Primary Sevas"},"weekly_seva_focus":{"type":"string","title":"Weekly Seva Focus"},"guidance":{"type":"string","title":"Guidance"}},"type":"object","required":["primary_sevas","weekly_seva_focus","guidance"],"title":"SevaRecommendation","description":"Complete seva recommendation set."},"SevaRemedy":{"properties":{"activity":{"type":"string","title":"Activity"},"beneficiary":{"type":"string","title":"Beneficiary"},"reason":{"type":"string","title":"Reason"},"planet_pacified":{"type":"string","title":"Planet Pacified"},"problem_addressed":{"type":"string","title":"Problem Addressed"},"shastra_note":{"type":"string","title":"Shastra Note"},"frequency":{"type":"string","title":"Frequency"},"best_day":{"type":"string","title":"Best Day"},"duration_guidance":{"type":"string","title":"Duration Guidance"},"how_to_perform":{"type":"string","title":"How To Perform"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["activity","beneficiary","reason","planet_pacified","problem_addressed","shastra_note","frequency","best_day","duration_guidance","how_to_perform","effectiveness_score"],"title":"SevaRemedy","description":"Service / seva recommendation (elders, cows, temple, feeding)."},"SevaRunItem":{"properties":{"id":{"type":"string","maxLength":80,"minLength":1,"title":"Id"},"label":{"type":"string","maxLength":300,"minLength":2,"title":"Label"},"completed":{"type":"boolean","title":"Completed","default":false}},"type":"object","required":["id","label"],"title":"SevaRunItem"},"SevaSettlement":{"properties":{"agreed_amount":{"type":"number","maximum":100000000.0,"minimum":0.0,"title":"Agreed Amount","default":0},"amount_received":{"type":"number","maximum":100000000.0,"minimum":0.0,"title":"Amount Received","default":0},"method":{"type":"string","enum":["not_recorded","cash","upi","bank","platform","other"],"title":"Method","default":"not_recorded"},"reference":{"type":"string","maxLength":200,"title":"Reference","default":""},"note":{"type":"string","maxLength":1000,"title":"Note","default":""},"receipt_number":{"type":"string","title":"Receipt Number"},"settled_at":{"type":"string","format":"date-time","title":"Settled At"}},"type":"object","title":"SevaSettlement"},"SevaSettlementInput":{"properties":{"agreed_amount":{"type":"number","maximum":100000000.0,"minimum":0.0,"title":"Agreed Amount","default":0},"amount_received":{"type":"number","maximum":100000000.0,"minimum":0.0,"title":"Amount Received","default":0},"method":{"type":"string","enum":["not_recorded","cash","upi","bank","platform","other"],"title":"Method","default":"not_recorded"},"reference":{"type":"string","maxLength":200,"title":"Reference","default":""},"note":{"type":"string","maxLength":1000,"title":"Note","default":""}},"type":"object","title":"SevaSettlementInput"},"SevaStageEvent":{"properties":{"stage":{"type":"string","enum":["preparing","travelling","arrived","started","completed"],"title":"Stage"},"changed_at":{"type":"string","format":"date-time","title":"Changed At"},"changed_by":{"type":"string","enum":["provider","admin"],"title":"Changed By"}},"type":"object","required":["stage","changed_at","changed_by"],"title":"SevaStageEvent"},"SevaTemplateResponse":{"properties":{"name":{"type":"string","maxLength":200,"minLength":2,"title":"Name"},"default_duration_minutes":{"type":"integer","maximum":1440.0,"minimum":15.0,"title":"Default Duration Minutes"},"default_team_size":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Default Team Size"},"samagri":{"items":{"$ref":"#/components/schemas/ToolkitSamagriItem"},"type":"array","maxItems":150,"title":"Samagri"},"run_steps":{"items":{"type":"string","maxLength":300,"minLength":2},"type":"array","maxItems":50,"title":"Run Steps"},"sankalpa_template":{"type":"string","maxLength":5000,"title":"Sankalpa Template"},"tradition":{"type":"string","maxLength":200,"minLength":2,"title":"Tradition","default":"Provider's verified tradition"},"guidance_notes":{"type":"string","maxLength":5000,"title":"Guidance Notes","default":""},"playbook_steps":{"items":{"$ref":"#/components/schemas/SevaPlaybookStep"},"type":"array","maxItems":80,"title":"Playbook Steps"},"is_active":{"type":"boolean","title":"Is Active","default":true},"ritual_id":{"type":"string","title":"Ritual Id"},"source":{"type":"string","enum":["default","admin"],"title":"Source"},"version":{"type":"integer","title":"Version","default":0},"verified":{"type":"boolean","title":"Verified","default":false},"verified_at":{"type":"string","format":"date-time","title":"Verified At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["name","default_duration_minutes","default_team_size","sankalpa_template","ritual_id","source"],"title":"SevaTemplateResponse"},"SevaTemplateRevisionResponse":{"properties":{"ritual_id":{"type":"string","title":"Ritual Id"},"version":{"type":"integer","title":"Version"},"payload":{"type":"object","title":"Payload"},"changed_by":{"type":"string","title":"Changed By"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["ritual_id","version","payload","created_at"],"title":"SevaTemplateRevisionResponse"},"SevaTemplateUpdate":{"properties":{"name":{"type":"string","maxLength":200,"minLength":2,"title":"Name"},"default_duration_minutes":{"type":"integer","maximum":1440.0,"minimum":15.0,"title":"Default Duration Minutes"},"default_team_size":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Default Team Size"},"samagri":{"items":{"$ref":"#/components/schemas/ToolkitSamagriItem"},"type":"array","maxItems":150,"title":"Samagri"},"run_steps":{"items":{"type":"string","maxLength":300,"minLength":2},"type":"array","maxItems":50,"title":"Run Steps"},"sankalpa_template":{"type":"string","maxLength":5000,"title":"Sankalpa Template"},"tradition":{"type":"string","maxLength":200,"minLength":2,"title":"Tradition","default":"Provider's verified tradition"},"guidance_notes":{"type":"string","maxLength":5000,"title":"Guidance Notes","default":""},"playbook_steps":{"items":{"$ref":"#/components/schemas/SevaPlaybookStep"},"type":"array","maxItems":80,"title":"Playbook Steps"},"is_active":{"type":"boolean","title":"Is Active","default":true}},"type":"object","required":["name","default_duration_minutes","default_team_size","sankalpa_template"],"title":"SevaTemplateUpdate"},"ShadbalaAnalysis":{"properties":{"birth_details":{"$ref":"#/components/schemas/ShadbalaBirthDetails"},"analysis_date":{"type":"string","format":"date","title":"Analysis Date"},"ascendant_sign":{"type":"integer","title":"Ascendant Sign"},"ascendant_sign_name":{"type":"string","title":"Ascendant Sign Name"},"planet_shadbala":{"additionalProperties":{"$ref":"#/components/schemas/PlanetShadbala"},"type":"object","title":"Planet Shadbala"},"comparison":{"$ref":"#/components/schemas/ShadbalaComparison"},"chart_strength_assessment":{"type":"string","title":"Chart Strength Assessment"},"strongest_areas":{"items":{"type":"string"},"type":"array","title":"Strongest Areas"},"challenging_areas":{"items":{"type":"string"},"type":"array","title":"Challenging Areas"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"calculation_standard":{"type":"string","title":"Calculation Standard","default":"BPHS chapters 26-28; Lahiri sidereal positions"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"type":"object","required":["birth_details","analysis_date","ascendant_sign","ascendant_sign_name","planet_shadbala","comparison","chart_strength_assessment","strongest_areas","challenging_areas","recommendations"],"title":"ShadbalaAnalysis","description":"Complete Shadbala analysis."},"ShadbalaBirthDetails":{"properties":{"date_of_birth":{"type":"string","format":"date","title":"Date Of Birth"},"time_of_birth":{"type":"string","title":"Time Of Birth"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","default":"Asia/Kolkata"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["date_of_birth","time_of_birth","latitude","longitude"],"title":"ShadbalaBirthDetails"},"ShadbalaComparison":{"properties":{"strongest_planet":{"type":"string","title":"Strongest Planet"},"weakest_planet":{"type":"string","title":"Weakest Planet"},"benefic_planets_strong":{"items":{"type":"string"},"type":"array","title":"Benefic Planets Strong"},"malefic_planets_strong":{"items":{"type":"string"},"type":"array","title":"Malefic Planets Strong"},"planets_meeting_requirement":{"items":{"type":"string"},"type":"array","title":"Planets Meeting Requirement"},"planets_below_requirement":{"items":{"type":"string"},"type":"array","title":"Planets Below Requirement"}},"type":"object","required":["strongest_planet","weakest_planet","benefic_planets_strong","malefic_planets_strong","planets_meeting_requirement","planets_below_requirement"],"title":"ShadbalaComparison","description":"Comparison of Shadbala across all planets."},"ShraddhaCalculationInput":{"properties":{"family_person_id":{"type":"string","format":"uuid","title":"Family Person Id"},"source_life_event_id":{"type":"string","format":"uuid","title":"Source Life Event Id"},"deceased_name":{"type":"string","maxLength":200,"minLength":1,"title":"Deceased Name"},"relationship":{"type":"string","maxLength":80,"title":"Relationship","default":""},"death_at":{"type":"string","format":"date-time","title":"Death At"},"death_location":{"type":"string","maxLength":250,"minLength":2,"title":"Death Location"},"death_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Death Latitude"},"death_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Death Longitude"},"death_timezone":{"type":"string","maxLength":100,"minLength":1,"title":"Death Timezone"},"observance_location":{"type":"string","maxLength":250,"minLength":2,"title":"Observance Location"},"observance_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Observance Latitude"},"observance_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Observance Longitude"},"observance_timezone":{"type":"string","maxLength":100,"minLength":1,"title":"Observance Timezone"},"tradition":{"type":"string","maxLength":160,"minLength":2,"title":"Tradition","default":"telugu_smarta_apastamba"},"region_id":{"type":"string","maxLength":60,"minLength":2,"title":"Region Id"},"sampradaya_id":{"type":"string","maxLength":60,"minLength":2,"title":"Sampradaya Id"},"ritual_school_id":{"type":"string","maxLength":60,"minLength":2,"title":"Ritual School Id"},"sutra":{"type":"string","maxLength":100,"title":"Sutra","default":""},"language":{"type":"string","maxLength":30,"minLength":2,"title":"Language","default":"Telugu"},"boundary_rule":{"type":"string","enum":["night_five_eighths","sunrise","civil_midnight","family_purohit"],"title":"Boundary Rule","default":"night_five_eighths"},"private_notes":{"type":"string","maxLength":3000,"title":"Private Notes","default":""}},"type":"object","required":["deceased_name","death_at","death_location","death_latitude","death_longitude","death_timezone","observance_location","observance_latitude","observance_longitude","observance_timezone"],"title":"ShraddhaCalculationInput"},"ShraddhaEventResponse":{"properties":{"id":{"type":"string","title":"Id"},"event_key":{"type":"string","title":"Event Key"},"sequence":{"type":"integer","title":"Sequence"},"name":{"type":"string","title":"Name"},"local_name":{"type":"string","title":"Local Name"},"category":{"type":"string","title":"Category"},"due_date":{"type":"string","format":"date","title":"Due Date"},"original_due_date":{"type":"string","format":"date","title":"Original Due Date"},"calculation_method":{"type":"string","title":"Calculation Method"},"target_tithi":{"type":"integer","title":"Target Tithi"},"target_lunar_cycle":{"type":"integer","title":"Target Lunar Cycle"},"verification_status":{"type":"string","title":"Verification Status"},"status":{"type":"string","title":"Status"},"is_optional":{"type":"boolean","title":"Is Optional"},"same_day_group":{"type":"string","title":"Same Day Group"},"guidance":{"type":"object","title":"Guidance"},"calculation":{"type":"object","title":"Calculation"},"reminder_days_before":{"type":"integer","title":"Reminder Days Before"},"family_note":{"type":"string","title":"Family Note","default":""},"verification_note":{"type":"string","title":"Verification Note","default":""},"verified_at":{"type":"string","format":"date-time","title":"Verified At"},"completed_at":{"type":"string","format":"date-time","title":"Completed At"},"version":{"type":"integer","title":"Version","default":1}},"type":"object","required":["event_key","sequence","name","local_name","category","due_date","calculation_method","verification_status","status","is_optional","guidance","calculation","reminder_days_before"],"title":"ShraddhaEventResponse"},"ShraddhaEventUpdate":{"properties":{"status":{"type":"string","enum":["upcoming","completed","skipped"],"title":"Status"},"family_note":{"type":"string","maxLength":2000,"title":"Family Note"},"reminder_days_before":{"type":"integer","maximum":90.0,"minimum":0.0,"title":"Reminder Days Before"},"manual_due_date":{"type":"string","format":"date","title":"Manual Due Date"},"manual_date_reason":{"type":"string","maxLength":1000,"title":"Manual Date Reason","default":""},"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"}},"type":"object","required":["expected_version"],"title":"ShraddhaEventUpdate"},"ShraddhaEventVerifyInput":{"properties":{"verified_due_date":{"type":"string","format":"date","title":"Verified Due Date"},"verification_note":{"type":"string","maxLength":2000,"minLength":3,"title":"Verification Note"},"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"}},"type":"object","required":["verification_note","expected_version"],"title":"ShraddhaEventVerifyInput"},"ShraddhaPlanResponse":{"properties":{"calculation_version":{"type":"string","title":"Calculation Version"},"tradition":{"type":"string","title":"Tradition"},"tradition_label":{"type":"string","title":"Tradition Label"},"review_note":{"type":"string","title":"Review Note"},"tradition_profile":{"type":"object","title":"Tradition Profile"},"region_id":{"type":"string","title":"Region Id"},"sampradaya_id":{"type":"string","title":"Sampradaya Id"},"ritual_school_id":{"type":"string","title":"Ritual School Id"},"coverage_level":{"type":"string","title":"Coverage Level"},"coverage_note":{"type":"string","title":"Coverage Note"},"ritual_day":{"type":"string","format":"date","title":"Ritual Day"},"day_boundary":{"type":"object","title":"Day Boundary"},"death_tithi":{"type":"integer","title":"Death Tithi"},"death_tithi_label":{"type":"string","title":"Death Tithi Label"},"death_paksha":{"type":"string","title":"Death Paksha"},"death_lunar_month":{"type":"integer","title":"Death Lunar Month"},"death_lunar_month_label":{"type":"string","title":"Death Lunar Month Label"},"death_lunar_month_system":{"type":"string","title":"Death Lunar Month System"},"death_in_adhika_masa":{"type":"boolean","title":"Death In Adhika Masa"},"adhika_masa_review_required":{"type":"boolean","title":"Adhika Masa Review Required"},"adhika_masa_event_keys":{"items":{"type":"string"},"type":"array","title":"Adhika Masa Event Keys"},"adhika_masa_source_refs":{"items":{"type":"string"},"type":"array","title":"Adhika Masa Source Refs"},"adhika_masa_note":{"type":"string","title":"Adhika Masa Note"},"events":{"items":{"$ref":"#/components/schemas/ShraddhaEventResponse"},"type":"array","title":"Events"},"privacy_note":{"type":"string","title":"Privacy Note"},"verification_note":{"type":"string","title":"Verification Note"},"family_person_id":{"type":"string","title":"Family Person Id"},"source_life_event_id":{"type":"string","title":"Source Life Event Id"},"id":{"type":"string","title":"Id"},"deceased_name":{"type":"string","title":"Deceased Name"},"relationship":{"type":"string","title":"Relationship"},"death_at":{"type":"string","format":"date-time","title":"Death At"},"death_location":{"type":"string","title":"Death Location"},"death_latitude":{"type":"number","title":"Death Latitude"},"death_longitude":{"type":"number","title":"Death Longitude"},"death_timezone":{"type":"string","title":"Death Timezone"},"observance_location":{"type":"string","title":"Observance Location"},"observance_latitude":{"type":"number","title":"Observance Latitude"},"observance_longitude":{"type":"number","title":"Observance Longitude"},"observance_timezone":{"type":"string","title":"Observance Timezone"},"sutra":{"type":"string","title":"Sutra"},"language":{"type":"string","title":"Language"},"boundary_rule":{"type":"string","title":"Boundary Rule"},"status":{"type":"string","title":"Status"},"private_notes":{"type":"string","title":"Private Notes"},"purohit_id":{"type":"string","title":"Purohit Id"},"purohit_callback_id":{"type":"string","title":"Purohit Callback Id"},"version":{"type":"integer","title":"Version"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["calculation_version","tradition","tradition_label","review_note","tradition_profile","region_id","sampradaya_id","ritual_school_id","coverage_level","coverage_note","ritual_day","day_boundary","death_tithi","death_tithi_label","death_paksha","death_lunar_month","death_lunar_month_label","death_lunar_month_system","death_in_adhika_masa","adhika_masa_review_required","adhika_masa_event_keys","adhika_masa_source_refs","adhika_masa_note","events","privacy_note","verification_note","id","deceased_name","relationship","death_at","death_location","death_latitude","death_longitude","death_timezone","observance_location","observance_latitude","observance_longitude","observance_timezone","sutra","language","boundary_rule","status","private_notes","version","created_at","updated_at"],"title":"ShraddhaPlanResponse"},"ShraddhaPlanSummary":{"properties":{"id":{"type":"string","title":"Id"},"deceased_name":{"type":"string","title":"Deceased Name"},"relationship":{"type":"string","title":"Relationship"},"tradition":{"type":"string","title":"Tradition"},"ritual_day":{"type":"string","format":"date","title":"Ritual Day"},"next_event":{"$ref":"#/components/schemas/ShraddhaEventResponse"},"completed_events":{"type":"integer","title":"Completed Events"},"total_events":{"type":"integer","title":"Total Events"},"status":{"type":"string","title":"Status"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","deceased_name","relationship","tradition","ritual_day","completed_events","total_events","status","updated_at"],"title":"ShraddhaPlanSummary"},"ShraddhaPlanUpdate":{"properties":{"status":{"type":"string","enum":["active","completed","archived"],"title":"Status"},"private_notes":{"type":"string","maxLength":3000,"title":"Private Notes"},"purohit_id":{"type":"string","maxLength":100,"title":"Purohit Id"},"expected_version":{"type":"integer","minimum":1.0,"title":"Expected Version"}},"type":"object","required":["expected_version"],"title":"ShraddhaPlanUpdate"},"ShraddhaPreviewResponse":{"properties":{"calculation_version":{"type":"string","title":"Calculation Version"},"tradition":{"type":"string","title":"Tradition"},"tradition_label":{"type":"string","title":"Tradition Label"},"review_note":{"type":"string","title":"Review Note"},"tradition_profile":{"type":"object","title":"Tradition Profile"},"region_id":{"type":"string","title":"Region Id"},"sampradaya_id":{"type":"string","title":"Sampradaya Id"},"ritual_school_id":{"type":"string","title":"Ritual School Id"},"coverage_level":{"type":"string","title":"Coverage Level"},"coverage_note":{"type":"string","title":"Coverage Note"},"ritual_day":{"type":"string","format":"date","title":"Ritual Day"},"day_boundary":{"type":"object","title":"Day Boundary"},"death_tithi":{"type":"integer","title":"Death Tithi"},"death_tithi_label":{"type":"string","title":"Death Tithi Label"},"death_paksha":{"type":"string","title":"Death Paksha"},"death_lunar_month":{"type":"integer","title":"Death Lunar Month"},"death_lunar_month_label":{"type":"string","title":"Death Lunar Month Label"},"death_lunar_month_system":{"type":"string","title":"Death Lunar Month System"},"death_in_adhika_masa":{"type":"boolean","title":"Death In Adhika Masa"},"adhika_masa_review_required":{"type":"boolean","title":"Adhika Masa Review Required"},"adhika_masa_event_keys":{"items":{"type":"string"},"type":"array","title":"Adhika Masa Event Keys"},"adhika_masa_source_refs":{"items":{"type":"string"},"type":"array","title":"Adhika Masa Source Refs"},"adhika_masa_note":{"type":"string","title":"Adhika Masa Note"},"events":{"items":{"$ref":"#/components/schemas/ShraddhaEventResponse"},"type":"array","title":"Events"},"privacy_note":{"type":"string","title":"Privacy Note"},"verification_note":{"type":"string","title":"Verification Note"}},"type":"object","required":["calculation_version","tradition","tradition_label","review_note","tradition_profile","region_id","sampradaya_id","ritual_school_id","coverage_level","coverage_note","ritual_day","day_boundary","death_tithi","death_tithi_label","death_paksha","death_lunar_month","death_lunar_month_label","death_lunar_month_system","death_in_adhika_masa","adhika_masa_review_required","adhika_masa_event_keys","adhika_masa_source_refs","adhika_masa_note","events","privacy_note","verification_note"],"title":"ShraddhaPreviewResponse"},"SignificatorAnalysis":{"properties":{"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"house_lord":{"type":"string","title":"House Lord"},"house_lord_position":{"type":"string","title":"House Lord Position"},"house_lord_house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House Lord House"},"natural_karaka":{"type":"string","title":"Natural Karaka"},"karaka_position":{"type":"string","title":"Karaka Position"},"benefic_aspects":{"items":{"type":"string"},"type":"array","title":"Benefic Aspects"},"malefic_aspects":{"items":{"type":"string"},"type":"array","title":"Malefic Aspects"},"planets_in_house":{"items":{"type":"string"},"type":"array","title":"Planets In House"},"strength_assessment":{"type":"string","title":"Strength Assessment"}},"type":"object","required":["house","house_lord","house_lord_position","house_lord_house","natural_karaka","karaka_position","benefic_aspects","malefic_aspects","planets_in_house","strength_assessment"],"title":"SignificatorAnalysis","description":"Analysis of significator (karaka) for the question.\n\nAttributes:\n house: Significator house for this question type\n house_lord: Lord of the significator house\n house_lord_position: Sign where house lord is placed\n house_lord_house: House where house lord is placed\n natural_karaka: Natural significator planet\n karaka_position: Position of natural karaka\n benefic_aspects: Benefic planets aspecting significator house\n malefic_aspects: Malefic planets aspecting significator house\n planets_in_house: Planets occupying the significator house\n strength_assessment: Overall strength of significator"},"SignificatorRequest":{"properties":{"planet":{"type":"string","title":"Planet","description":"Planet name"},"planet_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Planet Longitude"},"house_cusps":{"items":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0},"type":"array","maxItems":12,"minItems":12,"title":"House Cusps"},"planet_houses":{"additionalProperties":{"type":"integer","maximum":12.0,"minimum":1.0},"type":"object","title":"Planet Houses","description":"Dictionary of planet names to house numbers"}},"type":"object","required":["planet","planet_longitude","house_cusps","planet_houses"],"title":"SignificatorRequest"},"SkyBand":{"type":"string","enum":["night","twilight","daylight"],"title":"SkyBand","description":"How dark it is here at maximum, which decides whether it can be watched.\n\nSwiss Ephemeris calls an occultation \"visible\" when the body is above the\nhorizon, which is not what a reader means by it: most occultations of Budha and\nShukra happen in broad daylight and are real events that nobody can see."},"SolarReturnChart":{"properties":{"return_datetime":{"type":"string","format":"date-time","title":"Return Datetime"},"return_location":{"type":"string","title":"Return Location"},"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"timezone":{"type":"string","title":"Timezone"},"ascendant":{"$ref":"#/components/schemas/PlanetaryPosition"},"houses":{"items":{"$ref":"#/components/schemas/HouseData"},"type":"array","title":"Houses"},"planets":{"additionalProperties":{"$ref":"#/components/schemas/PlanetaryPosition"},"type":"object","title":"Planets"},"birth_sun_longitude":{"type":"number","title":"Birth Sun Longitude"},"return_sun_longitude":{"type":"number","title":"Return Sun Longitude"},"precision_arc_seconds":{"type":"number","title":"Precision Arc Seconds"}},"type":"object","required":["return_datetime","return_location","latitude","longitude","timezone","ascendant","houses","planets","birth_sun_longitude","return_sun_longitude","precision_arc_seconds"],"title":"SolarReturnChart","description":"Complete Solar Return Chart data"},"SortOrder":{"type":"string","enum":["relevance","rating","price_low","price_high","experience","popularity","recent"],"title":"SortOrder","description":"Sort order options."},"SpecialLagnasResponse":{"properties":{"birth_lagna":{"type":"object","title":"Birth Lagna"},"hora_lagna":{"$ref":"#/components/schemas/LagnaResponse"},"ghati_lagna":{"$ref":"#/components/schemas/LagnaResponse"},"varnada_lagna":{"$ref":"#/components/schemas/LagnaResponse"},"bhava_lagna":{"$ref":"#/components/schemas/LagnaResponse"},"indu_lagna":{"$ref":"#/components/schemas/LagnaResponse"},"sree_lagna":{"$ref":"#/components/schemas/LagnaResponse"},"pranapada_lagna":{"$ref":"#/components/schemas/LagnaResponse"},"summary":{"type":"object","title":"Summary"}},"type":"object","required":["birth_lagna","hora_lagna","ghati_lagna","varnada_lagna","bhava_lagna","indu_lagna","sree_lagna","pranapada_lagna","summary"],"title":"SpecialLagnasResponse","description":"Response model for all special lagnas."},"SpecialMuhurtaOut":{"properties":{"name":{"type":"string","title":"Name"},"name_sanskrit":{"type":"string","title":"Name Sanskrit"},"start_time":{"type":"string","title":"Start Time"},"end_time":{"type":"string","title":"End Time"},"duration_minutes":{"type":"number","title":"Duration Minutes"},"description":{"type":"string","title":"Description"},"suitable_for":{"items":{"type":"string"},"type":"array","title":"Suitable For"}},"type":"object","required":["name","name_sanskrit","start_time","end_time","duration_minutes","description"],"title":"SpecialMuhurtaOut"},"SpecialMuhurtasOut":{"properties":{"abhijit_muhurta":{"$ref":"#/components/schemas/SpecialMuhurtaOut"},"brahma_muhurta":{"$ref":"#/components/schemas/SpecialMuhurtaOut"}},"type":"object","title":"SpecialMuhurtasOut"},"SpecialYoga":{"properties":{"yoga_type":{"allOf":[{"$ref":"#/components/schemas/SpecialYogaType"}],"description":"Type of special yoga"},"is_active":{"type":"boolean","title":"Is Active","description":"Whether yoga is active"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Yoga start time"},"end_time":{"type":"string","format":"date-time","title":"End Time","description":"Yoga end time"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Yoga strength"},"is_auspicious":{"type":"boolean","title":"Is Auspicious","description":"Whether yoga is auspicious"},"is_overridden":{"type":"boolean","title":"Is Overridden","description":"A dosha cancelled by an Amrit Siddhi or Sarvartha Siddhi on the same day. Still reported -- the affliction is a fact about the day -- but it costs the score nothing.","default":false},"effects":{"items":{"type":"string"},"type":"array","title":"Effects"},"suitable_activities":{"items":{"type":"string"},"type":"array","title":"Suitable Activities"}},"type":"object","required":["yoga_type","is_active","strength","is_auspicious"],"title":"SpecialYoga","description":"Special yoga information."},"SpecialYogaDatesResponse":{"properties":{"yoga_type":{"type":"string","title":"Yoga Type"},"search_period":{"type":"string","title":"Search Period"},"total_occurrences":{"type":"integer","title":"Total Occurrences"},"description":{"type":"string","title":"Description"},"significance":{"type":"string","title":"Significance"},"suitable_activities":{"items":{"type":"string"},"type":"array","title":"Suitable Activities"},"dates":{"items":{"type":"object"},"type":"array","title":"Dates"}},"type":"object","required":["yoga_type","search_period","total_occurrences","description","significance"],"title":"SpecialYogaDatesResponse","description":"GET /advanced-muhurta/special-yoga-dates\n\n``dates`` used to carry a different key set per yoga type, because each of\nthe four had its own emitting branch. They are one registry and one loop now,\nso every entry has ``date``, ``code``, ``weekday``, ``nakshatra``,\n``description``, ``start_time``, ``end_time`` and ``duration_hours`` -- the\nlast three null when the boundary could not be solved. It stays a free\nmapping so the tithi-keyed yogas can add a tithi field without a wire break."},"SpecialYogaOut":{"properties":{"type":{"type":"string","title":"Type"},"is_auspicious":{"type":"boolean","title":"Is Auspicious"},"is_overridden":{"type":"boolean","title":"Is Overridden","default":false},"strength":{"type":"number","title":"Strength"},"start_time":{"type":"string","title":"Start Time","description":"Local HH:MM the yoga begins"},"end_time":{"type":"string","title":"End Time","description":"Local HH:MM the yoga ends"},"duration_hours":{"type":"number","title":"Duration Hours"},"effects":{"items":{"type":"string"},"type":"array","title":"Effects"},"suitable_activities":{"items":{"type":"string"},"type":"array","title":"Suitable Activities"}},"type":"object","required":["type","is_auspicious","strength"],"title":"SpecialYogaOut"},"SpecialYogaSummary":{"properties":{"yogas":{"items":{"$ref":"#/components/schemas/YogaData"},"type":"array","title":"Yogas"},"karmic_indicators":{"items":{"type":"string"},"type":"array","title":"Karmic Indicators"},"spiritual_yogas":{"items":{"type":"string"},"type":"array","title":"Spiritual Yogas"},"relationship_yogas":{"items":{"type":"string"},"type":"array","title":"Relationship Yogas"},"parivartana_yogas":{"items":{"type":"string"},"type":"array","title":"Parivartana Yogas"},"kartari_yogas":{"items":{"type":"string"},"type":"array","title":"Kartari Yogas"}},"type":"object","required":["yogas"],"title":"SpecialYogaSummary","description":"Summary of special yogas (Kala Sarpa, Guru Chandal, Parivartana, Kartari, etc.).\n\nAttributes:\n yogas: List of special yogas present\n karmic_indicators: Karmic patterns indicated\n spiritual_yogas: Spirituality-related yogas\n relationship_yogas: Relationship-affecting yogas\n parivartana_yogas: Exchange yogas between house lords\n kartari_yogas: Hemming combinations (Shubha/Papa Kartari)"},"SpecialYogaType":{"type":"string","enum":["amrit_siddhi","sarvartha_siddhi","ravi_pushya","guru_pushya","dwipushkar","tripushkar","ravi","mrityu","dagdha","yamaghanta","aadal","vidaal","tamil_siddha","tamil_amrita","tamil_marana","maitreya"],"title":"SpecialYogaType","description":"Named panchang coincidences a muhurta is judged by, in both directions.\n\nThe auspicious ones lift a day; the doshas spoil it. ``app.core.yoga_rules``\nholds the table for each, and a member with no rule there is rejected rather\nthan answered -- see ``UNIMPLEMENTED_YOGAS``, which is empty as of the\nPushkara pair and should stay that way.\n\nMost of these are vara coincidences, a weekday meeting a nakshatra or a\ntithi. ``RAVI`` is the exception and reads no weekday at all, only how far\nthe Moon's nakshatra stands from the Sun's; it is here rather than among the\nnitya yogas because it is judged the same way -- a named reason a window\nscores what it does -- and because nothing else computes it.\n\n``SIDDHA`` used to sit here and never got a table, because it does not want\none: Siddha is the twenty-first *nitya* yoga, a division of the Sun and Moon\nlongitudes added together, which this service already computes per instant and\nalready scores -- ``_calculate_day_score`` counts it among its favourable\nyogas. Giving Siddha a vara-nakshatra table would have invented a rule and\nthen charged a day twice for the same fact. ``RAVI``, by contrast, is not\ncomputed anywhere else: nothing in this service counts nakshatras from the\nSun's."},"StarOmen":{"properties":{"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_display":{"type":"string","title":"Nakshatra Display"},"omen":{"type":"string","title":"Omen"},"basis":{"type":"string","title":"Basis","description":"Why no per-rashi reading is offered: the tradition does not give one"},"language":{"type":"string","title":"Language"}},"type":"object","required":["nakshatra","nakshatra_display","omen","basis","language"],"title":"StarOmen","description":"The classical omen for a nakshatra-star occultation, at the texts' own scale."},"SthanaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"uchcha_bala":{"$ref":"#/components/schemas/UchchaBala"},"saptavargaja_bala":{"$ref":"#/components/schemas/SaptavargajaBala"},"ojhayugma_bala":{"$ref":"#/components/schemas/OjhayugmaRashiBala"},"kendra_bala":{"$ref":"#/components/schemas/KendraBala"},"drekkana_bala":{"$ref":"#/components/schemas/DrekkanaBala"},"total_strength_virupas":{"type":"number","title":"Total Strength Virupas"},"total_strength_rupas":{"type":"number","title":"Total Strength Rupas"}},"type":"object","required":["planet","uchcha_bala","saptavargaja_bala","ojhayugma_bala","kendra_bala","drekkana_bala","total_strength_virupas","total_strength_rupas"],"title":"SthanaBala","description":"Complete Sthana Bala (Positional Strength)."},"SthanaBalaBrekdown":{"properties":{"uchcha_bala":{"type":"number","minimum":0.0,"title":"Uchcha Bala","description":"Exaltation strength"},"saptavargaja_bala":{"type":"number","minimum":0.0,"title":"Saptavargaja Bala","description":"Divisional chart strength"},"ojayugmarasyamsa_bala":{"type":"number","minimum":0.0,"title":"Ojayugmarasyamsa Bala","description":"Odd/Even sign strength"},"kendradi_bala":{"type":"number","minimum":0.0,"title":"Kendradi Bala","description":"Angular strength"},"drekkana_bala":{"type":"number","minimum":0.0,"title":"Drekkana Bala","description":"Decanate strength"},"total":{"type":"number","minimum":0.0,"title":"Total","description":"Total Sthana Bala"}},"type":"object","required":["uchcha_bala","saptavargaja_bala","ojayugmarasyamsa_bala","kendradi_bala","drekkana_bala","total"],"title":"SthanaBalaBrekdown","description":"Breakdown of Sthana Bala (Positional Strength) components.\n\nSthana Bala has 5 sub-components measuring strength from sign placement.\n\nAttributes:\n uchcha_bala: Exaltation strength (0-60 Shashtiamsas)\n saptavargaja_bala: Strength from 7 divisional charts\n ojayugmarasyamsa_bala: Odd/Even sign strength\n kendradi_bala: Angular house strength\n drekkana_bala: Decanate strength\n total: Total Sthana Bala"},"StrengthCategory":{"type":"string","enum":["very_strong","strong","moderate","weak","very_weak"],"title":"StrengthCategory","description":"Overall strength classification."},"StrengthDashboardAnalysis":{"properties":{"shadbala":{"$ref":"#/components/schemas/ShadbalaAnalysis"},"bhava_bala":{"$ref":"#/components/schemas/BhavaBalaAnalysis"},"vimsopaka_bala":{"$ref":"#/components/schemas/VimsopakaAnalysis"}},"type":"object","required":["shadbala","bhava_bala","vimsopaka_bala"],"title":"StrengthDashboardAnalysis","description":"All natal strength systems needed by the chart-strength UI."},"StrengthDashboardResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"analysis":{"$ref":"#/components/schemas/StrengthDashboardAnalysis"}},"type":"object","required":["analysis"],"title":"StrengthDashboardResponse"},"StrengthLevel":{"type":"string","enum":["very_weak","weak","average","strong","very_strong"],"title":"StrengthLevel","description":"Strength classification based on bindu count."},"SubDashaPeriod":{"properties":{"planet":{"type":"string","title":"Planet","description":"Ruling planet of the sub-Dasha period"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date of the sub-Dasha period"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End date of the sub-Dasha period"},"duration_months":{"type":"number","title":"Duration Months","description":"Duration of the sub-Dasha period in months"},"description":{"type":"string","title":"Description","description":"Description of the sub-Dasha period"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Strength of the sub-Dasha period (0-1)"},"is_beneficial":{"type":"boolean","title":"Is Beneficial","description":"Whether the sub-Dasha period is generally beneficial"},"sub_periods":{"items":{"$ref":"#/components/schemas/SubDashaPeriod"},"type":"array","title":"Sub Periods","description":"Pratyantardasha (third-level) sub-periods within this Antardasha"}},"type":"object","required":["planet","start_date","end_date","duration_months","description","strength","is_beneficial"],"title":"SubDashaPeriod","description":"Model for a sub-Dasha period."},"SubscriptionTier":{"type":"string","enum":["free","basic","premium","professional","enterprise"],"title":"SubscriptionTier","description":"Subscription tier levels."},"SudarshanaInferenceRequest":{"properties":{"chart":{"$ref":"#/components/schemas/ChartLayoutData"},"max_themes":{"type":"integer","maximum":6.0,"minimum":1.0,"title":"Max Themes","default":4},"language":{"type":"string","title":"Language","description":"Language for the synthesis prose: en, hi. Unsupported values read in English.","default":"en"}},"type":"object","required":["chart"],"title":"SudarshanaInferenceRequest","description":"Request a structured Sudarshana synthesis from an existing D1 layout."},"SudarshanaInferenceResponse":{"properties":{"applicable":{"type":"boolean","title":"Applicable"},"summary":{"type":"string","title":"Summary"},"themes":{"items":{"$ref":"#/components/schemas/SudarshanaThemeInference"},"type":"array","title":"Themes"},"reference_signs":{"additionalProperties":{"type":"integer"},"type":"object","title":"Reference Signs"},"distinct_reference_count":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Distinct Reference Count","description":"Independent reckonings this chart offers. Below three when reference points share a sign — commonly the Lagna and the Sun, for a birth near sunrise. It is the denominator for every theme's reference_count, and it caps prominence: three-way confirmation is unavailable in a chart that does not offer three reckonings.","default":3},"coincident_references":{"items":{"items":{"type":"string"},"type":"array"},"type":"array","title":"Coincident References","description":"Groups of reference points counting from one sign, e.g. [[\"lagna\", \"sun\"]]."},"method_note":{"type":"string","title":"Method Note"},"scope_note":{"type":"string","title":"Scope Note"},"system":{"type":"string","title":"System","default":"parashari"},"language":{"type":"string","title":"Language","description":"The language this synthesis was actually written in, after resolution.","default":"en"}},"type":"object","required":["applicable","summary","method_note","scope_note"],"title":"SudarshanaInferenceResponse"},"SudarshanaReferenceEvidence":{"properties":{"reference":{"type":"string","title":"Reference","description":"lagna, moon, or sun"},"label":{"type":"string","title":"Label"},"active":{"type":"boolean","title":"Active"},"occupants":{"items":{"type":"string"},"type":"array","title":"Occupants"},"aspects_from":{"items":{"type":"string"},"type":"array","title":"Aspects From"},"statement":{"type":"string","title":"Statement"},"same_sign_as":{"items":{"type":"string"},"type":"array","title":"Same Sign As","description":"Other references counting from this same sign, so this reckoning is not independent of theirs."},"counted":{"type":"boolean","title":"Counted","description":"Whether this reference contributed to score and reference_count. False for the duplicate of a coincident pair: it is shown, but counting it twice would inflate every theme in the chart.","default":true}},"type":"object","required":["reference","label","active","statement"],"title":"SudarshanaReferenceEvidence"},"SudarshanaThemeInference":{"properties":{"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"title":{"type":"string","title":"Title"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics"},"prominence":{"type":"string","title":"Prominence","description":"strong, notable, or focused"},"prominence_label":{"type":"string","title":"Prominence Label","description":"`prominence` in the requested language, for display. The enum above is for branching.","default":""},"reference_count":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Reference Count","description":"Independent reckonings that activate this house. Out of distinct_reference_count, not always out of three: coincident references are one reckoning."},"score":{"type":"integer","minimum":0.0,"title":"Score"},"influential_planets":{"items":{"type":"string"},"type":"array","title":"Influential Planets"},"inference":{"type":"string","title":"Inference"},"references":{"items":{"$ref":"#/components/schemas/SudarshanaReferenceEvidence"},"type":"array","title":"References"}},"type":"object","required":["house","title","topics","prominence","reference_count","score","inference","references"],"title":"SudarshanaThemeInference"},"SudharshanaPeriod":{"properties":{"year_number":{"type":"integer","title":"Year Number","description":"Year number from birth"},"lagna_sign":{"type":"string","title":"Lagna Sign","description":"Sign from Lagna perspective"},"sun_sign":{"type":"string","title":"Sun Sign","description":"Sign from Sun perspective"},"moon_sign":{"type":"string","title":"Moon Sign","description":"Sign from Moon perspective"},"combined_influence":{"type":"string","title":"Combined Influence","description":"Combined influence of all three"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End date"},"predictions":{"items":{"type":"string"},"type":"array","title":"Predictions","description":"Predictions"},"overall_quality":{"type":"string","title":"Overall Quality","description":"Overall quality of the year"}},"type":"object","required":["year_number","lagna_sign","sun_sign","moon_sign","combined_influence","start_date","end_date","overall_quality"],"title":"SudharshanaPeriod","description":"Model for Sudharshana Chakra Dasha period."},"SudharshanaResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in ISO format"},"dasha_system":{"type":"string","title":"Dasha System","description":"Dasha system used","default":"sudharshana"},"lagna_sign":{"type":"string","title":"Lagna Sign","description":"Birth Lagna sign"},"sun_sign":{"type":"string","title":"Sun Sign","description":"Birth Sun sign"},"moon_sign":{"type":"string","title":"Moon Sign","description":"Birth Moon sign"},"periods":{"items":{"$ref":"#/components/schemas/SudharshanaPeriod"},"type":"array","title":"Periods","description":"Yearly periods"},"current_year":{"allOf":[{"$ref":"#/components/schemas/SudharshanaPeriod"}],"title":"Current Year","description":"Current year analysis"},"summary":{"type":"string","title":"Summary","description":"Summary"},"three_fold_analysis":{"type":"object","title":"Three Fold Analysis","description":"Lagna-Sun-Moon analysis"}},"type":"object","required":["birth_date","lagna_sign","sun_sign","moon_sign","periods","summary"],"title":"SudharshanaResponse","description":"Response model for Sudharshana Chakra Dasha."},"SuryaNakshatra":{"properties":{"number":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Number","description":"Nakshatra number (1-27)"},"name":{"type":"string","title":"Name","description":"Name of the Nakshatra"},"pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada","description":"Pada (quarter) of the Nakshatra"}},"type":"object","required":["number","name","pada"],"title":"SuryaNakshatra","description":"The Sun's sidereal nakshatra and pada, printed beside the Moon's.\n\nDeliberately narrower than :class:`Nakshatra`: no start or end time, because\nthe Sun holds one nakshatra for about a fortnight and the transition solver\nis written for the Moon's limbs. Drik does publish the pada's end time\n(\"Uttara Ashadha upto 03:13 PM\" on 2026-01-14, which is Makara Sankranti);\nadding it is a solve for the Sun, not a formatting change."},"TTSAssignmentListResponse":{"properties":{"assignments":{"items":{"$ref":"#/components/schemas/TTSAssignmentResponse"},"type":"array","title":"Assignments"},"engines":{"items":{"$ref":"#/components/schemas/TTSEngineStatus"},"type":"array","title":"Engines"}},"type":"object","required":["assignments"],"title":"TTSAssignmentListResponse"},"TTSAssignmentResponse":{"properties":{"id":{"type":"integer","title":"Id"},"audience":{"type":"string","title":"Audience"},"locale":{"type":"string","title":"Locale"},"engine":{"type":"string","title":"Engine"},"voice":{"type":"string","title":"Voice"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","audience","engine","voice"],"title":"TTSAssignmentResponse"},"TTSAssignmentUpsert":{"properties":{"audience":{"type":"string","maxLength":16,"minLength":3,"title":"Audience"},"locale":{"type":"string","maxLength":16,"title":"Locale"},"engine":{"type":"string","maxLength":64,"minLength":1,"title":"Engine"},"voice":{"type":"string","maxLength":64,"minLength":1,"title":"Voice"}},"type":"object","required":["audience","engine","voice"],"title":"TTSAssignmentUpsert"},"TTSEngineStatus":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"engine":{"type":"string","title":"Engine"},"available":{"type":"boolean","title":"Available"},"device":{"type":"string","title":"Device","default":"cpu"},"model_loaded":{"type":"boolean","title":"Model Loaded"},"default_voice":{"type":"string","title":"Default Voice"},"voices":{"items":{"$ref":"#/components/schemas/TTSVoiceOption"},"type":"array","title":"Voices"},"engine_version":{"type":"string","title":"Engine Version"},"language":{"type":"string","title":"Language"}},"type":"object","required":["id","label","engine","available","model_loaded","default_voice","voices","engine_version","language"],"title":"TTSEngineStatus"},"TTSSettingsResponse":{"properties":{"voice":{"type":"string","title":"Voice"},"default_voice":{"type":"string","title":"Default Voice","default":"vera"},"device":{"type":"string","title":"Device","default":"cpu"},"engine":{"type":"string","title":"Engine","default":"pocket-tts"},"available":{"type":"boolean","title":"Available"},"model_loaded":{"type":"boolean","title":"Model Loaded"},"voices":{"items":{"$ref":"#/components/schemas/TTSVoiceOption"},"type":"array","title":"Voices"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["voice","available","model_loaded","voices"],"title":"TTSSettingsResponse"},"TTSSettingsUpdate":{"properties":{"voice":{"type":"string","maxLength":64,"minLength":1,"title":"Voice"}},"type":"object","required":["voice"],"title":"TTSSettingsUpdate"},"TTSSpeakRequest":{"properties":{"text":{"type":"string","maxLength":4000,"minLength":1,"title":"Text"},"voice":{"type":"string","maxLength":64,"title":"Voice"},"locale":{"type":"string","maxLength":16,"title":"Locale"}},"type":"object","required":["text"],"title":"TTSSpeakRequest"},"TTSSpeakResponse":{"properties":{"audio_data":{"type":"string","title":"Audio Data"},"audio_format":{"type":"string","title":"Audio Format","default":"wav"},"mime_type":{"type":"string","title":"Mime Type","default":"audio/wav"},"duration_seconds":{"type":"number","title":"Duration Seconds"},"sample_rate":{"type":"integer","title":"Sample Rate"},"voice":{"type":"string","title":"Voice"},"engine":{"type":"string","title":"Engine"},"engine_version":{"type":"string","title":"Engine Version"},"device":{"type":"string","title":"Device","default":"cpu"}},"type":"object","required":["audio_data","duration_seconds","sample_rate","voice","engine","engine_version"],"title":"TTSSpeakResponse"},"TTSStatusResponse":{"properties":{"engine":{"type":"string","title":"Engine"},"available":{"type":"boolean","title":"Available"},"device":{"type":"string","title":"Device","default":"cpu"},"model_loaded":{"type":"boolean","title":"Model Loaded"},"default_voice":{"type":"string","title":"Default Voice"},"voices":{"items":{"$ref":"#/components/schemas/TTSVoiceOption"},"type":"array","title":"Voices"},"engine_version":{"type":"string","title":"Engine Version"},"language":{"type":"string","title":"Language"},"engines":{"items":{"$ref":"#/components/schemas/TTSEngineStatus"},"type":"array","title":"Engines"}},"type":"object","required":["engine","available","model_loaded","default_voice","voices","engine_version","language"],"title":"TTSStatusResponse"},"TTSVoiceOption":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"language":{"type":"string","title":"Language"}},"type":"object","required":["id","label","language"],"title":"TTSVoiceOption"},"TajikaYoga":{"properties":{"yoga_type":{"$ref":"#/components/schemas/TajikaYogaType"},"name":{"type":"string","title":"Name"},"planets_involved":{"items":{"type":"string"},"type":"array","title":"Planets Involved"},"is_present":{"type":"boolean","title":"Is Present"},"strength":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Strength"},"houses_affected":{"items":{"type":"integer"},"type":"array","title":"Houses Affected"},"signification":{"type":"string","title":"Signification"},"interpretation":{"type":"string","title":"Interpretation"},"timing":{"type":"string","title":"Timing"}},"type":"object","required":["yoga_type","name","planets_involved","is_present","strength","houses_affected","signification","interpretation"],"title":"TajikaYoga","description":"Tajika Yoga (Annual Chart Combination)"},"TajikaYogaRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"birth_time":{"type":"string","title":"Birth Time"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"year":{"type":"integer","title":"Year"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Tajika sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude","year"],"title":"TajikaYogaRequest","description":"Request for Tajika Yoga calculations"},"TajikaYogaResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"tajika_yogas":{"items":{"$ref":"#/components/schemas/TajikaYoga"},"type":"array","title":"Tajika Yogas"},"present_yogas":{"items":{"type":"string"},"type":"array","title":"Present Yogas"},"strongest_yogas":{"items":{"type":"string"},"type":"array","title":"Strongest Yogas"}},"type":"object","required":["tajika_yogas","present_yogas","strongest_yogas"],"title":"TajikaYogaResponse","description":"Response for Tajika Yoga calculations"},"TajikaYogaType":{"type":"string","enum":["ikkabal","induvara","ithasala","ishrafa","nakta","yamaya","manaoo","kamboola","gairi_kamboola","khallasar","radda","duhphali_kuttha","dutthotta_davira","tambira","kuttha","duruhpha"],"title":"TajikaYogaType","description":"16 Tajika Yogas (Annual Chart Combinations)"},"TaraBala":{"properties":{"number":{"type":"integer","maximum":9.0,"minimum":1.0,"title":"Number"},"name":{"type":"string","title":"Name"},"quality":{"type":"string","title":"Quality"},"note":{"type":"string","title":"Note"}},"type":"object","required":["number","name","quality","note"],"title":"TaraBala","description":"Tara Bala — the day's Moon nakshatra counted from the janma nakshatra\nin cycles of nine (Janma, Sampat, Vipat, Kshema, Pratyari, Sadhaka,\nVadha, Maitra, Parama Maitra)."},"TaraKoota":{"properties":{"name":{"type":"string","title":"Name"},"max_points":{"type":"number","title":"Max Points"},"obtained_points":{"type":"number","title":"Obtained Points"},"percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Percentage"},"bride_value":{"type":"string","title":"Bride Value"},"groom_value":{"type":"string","title":"Groom Value"},"compatibility_status":{"type":"string","title":"Compatibility Status","description":"Good, Average, or Poor"},"description":{"type":"string","title":"Description"},"analysis":{"type":"string","title":"Analysis"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"bride_nakshatra":{"type":"string","title":"Bride Nakshatra"},"groom_nakshatra":{"type":"string","title":"Groom Nakshatra"},"tara_number":{"type":"integer","maximum":9.0,"minimum":1.0,"title":"Tara Number"},"tara_name":{"type":"string","title":"Tara Name","description":"Janma, Sampat, Vipat, Kshema, Pratyak, Sadhana, Vadha, Mitra, Parama Mitra"},"is_mutual_favorable":{"type":"boolean","title":"Is Mutual Favorable"}},"type":"object","required":["name","max_points","obtained_points","percentage","bride_value","groom_value","compatibility_status","description","analysis","bride_nakshatra","groom_nakshatra","tara_number","tara_name","is_mutual_favorable"],"title":"TaraKoota","description":"Tara Koota - Destiny and health compatibility (3 points).\n\nBased on the count from bride's nakshatra to groom's nakshatra.\n\nRules:\n- Janma (1), Sampat (2), Kshema (4), Sadhana (6), Mitra (8),\n Parama Mitra (9) = Good\n- Vipat (3), Pratyak (5), Vadha (7) = Needs checking\n\nThis block previously placed Sadhana at 5 and Pratyak at 6, one position out\nfrom the name list it describes, and called position 9 Naidhana. Naidhana is\nanother name for the seventh; the ninth is Parama Mitra, the best-friend\ntara, and it is favourable."},"TarabalaBandOut":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"},"transit_nakshatra":{"$ref":"#/components/schemas/TransitBodyOut"},"entries":{"items":{"$ref":"#/components/schemas/TarabalaEntryOut"},"type":"array","title":"Entries"}},"type":"object","required":["start","end","transit_nakshatra"],"title":"TarabalaBandOut","description":"The whole Tara table over one stretch of the day.\n\nA band is a nakshatra stay clipped to the vara day, so ``start`` is the\nlater of the ingress and sunrise and ``end`` the earlier of the egress and\nthe next sunrise. THE LAST BAND'S ``end`` IS THE DAY'S OWN BOUNDARY, not an\ninstant at which the tara changes -- printing \"good until 07:14\" for it\nwould dress the next sunrise up as a transition."},"TarabalaEntryOut":{"properties":{"nakshatra_number":{"type":"integer","title":"Nakshatra Number"},"nakshatra":{"type":"string","title":"Nakshatra"},"tara_number":{"type":"integer","title":"Tara Number"},"tara_name":{"type":"string","title":"Tara Name"},"quality":{"type":"string","title":"Quality"},"is_favorable":{"type":"boolean","title":"Is Favorable"},"strength_score":{"type":"number","title":"Strength Score"}},"type":"object","required":["nakshatra_number","nakshatra","tara_number","tara_name","quality","is_favorable","strength_score"],"title":"TarabalaEntryOut","description":"Today's Tara for one birth nakshatra."},"TarabalaResponse":{"properties":{"birth_nakshatra":{"type":"string","title":"Birth Nakshatra"},"transit_nakshatra":{"type":"string","title":"Transit Nakshatra"},"tara_number":{"type":"integer","title":"Tara Number"},"tara_name":{"type":"string","title":"Tara Name"},"quality":{"type":"string","title":"Quality"},"is_favorable":{"type":"boolean","title":"Is Favorable"},"strength_score":{"type":"number","title":"Strength Score"},"description":{"type":"string","title":"Description"},"recommendation":{"type":"string","title":"Recommendation"}},"type":"object","required":["birth_nakshatra","transit_nakshatra","tara_number","tara_name","quality","is_favorable","strength_score","description","recommendation"],"title":"TarabalaResponse","description":"GET /advanced-muhurta/tarabala"},"TattwaShuddbiRequest":{"properties":{"approximate_birth":{"$ref":"#/components/schemas/ApproximateBirthTime"},"latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Latitude"},"longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Longitude"},"timezone":{"type":"string","title":"Timezone","default":"UTC"},"query_time":{"type":"string","format":"date-time","title":"Query Time"},"query_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Query Latitude"},"query_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Query Longitude"}},"type":"object","required":["approximate_birth","latitude","longitude","query_time","query_latitude","query_longitude"],"title":"TattwaShuddbiRequest"},"TattwaShuddbiResult":{"properties":{"query_lagna_lord":{"type":"string","title":"Query Lagna Lord"},"query_moon_sign_lord":{"type":"string","title":"Query Moon Sign Lord"},"query_day_lord":{"type":"string","title":"Query Day Lord"},"query_nakshatra_lord":{"type":"string","title":"Query Nakshatra Lord"},"ruling_planets":{"items":{"type":"string"},"type":"array","title":"Ruling Planets"},"matched_time":{"type":"string","format":"date-time","title":"Matched Time"},"confidence":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Confidence"},"explanation":{"type":"string","title":"Explanation"}},"type":"object","required":["query_lagna_lord","query_moon_sign_lord","query_day_lord","query_nakshatra_lord","ruling_planets","matched_time","confidence","explanation"],"title":"TattwaShuddbiResult","description":"Result of Tattwa Shuddhi rectification.\n\nAttributes:\n query_lagna_lord: Lord of lagna at query time\n query_moon_sign_lord: Lord of Moon sign at query\n query_day_lord: Lord of the query day\n query_nakshatra_lord: Lord of Moon nakshatra at query\n ruling_planets: Combined ruling planets\n matched_time: Birth time matching ruling planets\n confidence: Confidence in the match"},"TempleDetails":{"properties":{"name":{"type":"string","title":"Name"},"deity":{"type":"string","title":"Deity"},"location":{"type":"string","title":"Location"},"state":{"type":"string","title":"State"},"significance":{"type":"string","title":"Significance"},"best_time_to_visit":{"type":"string","title":"Best Time To Visit"}},"type":"object","required":["name","deity","location","state","significance","best_time_to_visit"],"title":"TempleDetails","description":"Details of a temple."},"TempleRecommendation":{"properties":{"primary_temples":{"items":{"$ref":"#/components/schemas/TempleRemedy"},"type":"array","title":"Primary Temples"},"pilgrimage_route":{"type":"string","title":"Pilgrimage Route"},"local_alternatives":{"items":{"type":"string"},"type":"array","title":"Local Alternatives"}},"type":"object","required":["primary_temples","local_alternatives"],"title":"TempleRecommendation","description":"Complete temple recommendation set."},"TempleRemedy":{"properties":{"temple":{"$ref":"#/components/schemas/TempleDetails"},"reason":{"type":"string","title":"Reason"},"problem_addressed":{"type":"string","title":"Problem Addressed"},"rituals_to_perform":{"items":{"type":"string"},"type":"array","title":"Rituals To Perform"},"offerings_to_make":{"items":{"type":"string"},"type":"array","title":"Offerings To Make"},"mantras_to_chant":{"items":{"type":"string"},"type":"array","title":"Mantras To Chant"},"circumambulations":{"type":"integer","title":"Circumambulations"},"best_days":{"items":{"type":"string"},"type":"array","title":"Best Days"},"best_tithis":{"items":{"type":"string"},"type":"array","title":"Best Tithis"},"festivals_to_visit":{"items":{"type":"string"},"type":"array","title":"Festivals To Visit"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["temple","reason","problem_addressed","rituals_to_perform","offerings_to_make","mantras_to_chant","circumambulations","best_days","best_tithis","festivals_to_visit","effectiveness_score"],"title":"TempleRemedy","description":"Temple visit recommendation."},"TextReadingPayload":{"properties":{"text_id":{"type":"string","title":"Text Id"},"state":{"$ref":"#/components/schemas/ReadingState"},"bookmarks":{"items":{"$ref":"#/components/schemas/Bookmark"},"type":"array","title":"Bookmarks"},"highlights":{"items":{"$ref":"#/components/schemas/Highlight"},"type":"array","title":"Highlights"}},"type":"object","required":["text_id","state","bookmarks","highlights"],"title":"TextReadingPayload"},"TierComparisonResponse":{"properties":{"tiers":{"items":{"type":"object"},"type":"array","title":"Tiers"}},"type":"object","required":["tiers"],"title":"TierComparisonResponse","description":"Tier comparison for upgrade/downgrade UI."},"TimeRange":{"properties":{"start":{"type":"string","title":"Start","description":"Start time in ISO format"},"end":{"type":"string","title":"End","description":"End time in ISO format"}},"type":"object","required":["start","end"],"title":"TimeRange","description":"Time range with start and end times.\n\nAttributes:\n start: Start time in ISO format\n end: End time in ISO format"},"TimelinePeriod":{"type":"string","enum":["1_month","3_months","6_months","1_year","3_years","5_years","10_years"],"title":"TimelinePeriod","description":"An enumeration."},"TimingAnalysis":{"properties":{"date":{"type":"string","format":"date-time","title":"Date"},"overall_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Overall Score"},"favorable_varas":{"items":{"type":"string"},"type":"array","title":"Favorable Varas"},"unfavorable_varas":{"items":{"type":"string"},"type":"array","title":"Unfavorable Varas"},"favorable_nakshatras":{"items":{"type":"string"},"type":"array","title":"Favorable Nakshatras"},"unfavorable_nakshatras":{"items":{"type":"string"},"type":"array","title":"Unfavorable Nakshatras"},"recommendation":{"type":"string","title":"Recommendation"}},"type":"object","required":["date","overall_score","favorable_varas","unfavorable_varas","favorable_nakshatras","unfavorable_nakshatras","recommendation"],"title":"TimingAnalysis","description":"Auspicious/inauspicious timing analysis"},"TimingGuidance":{"properties":{"muhurtas":{"items":{"$ref":"#/components/schemas/MuhurtaRecommendation"},"type":"array","title":"Muhurtas"},"favorable_weekdays":{"items":{"type":"string"},"type":"array","title":"Favorable Weekdays"},"favorable_moon_signs":{"items":{"type":"string"},"type":"array","title":"Favorable Moon Signs"},"avoid_moon_signs":{"items":{"type":"string"},"type":"array","title":"Avoid Moon Signs"},"eclipse_warnings":{"items":{"type":"string"},"type":"array","title":"Eclipse Warnings","default":[]}},"type":"object","required":["muhurtas","favorable_weekdays","favorable_moon_signs","avoid_moon_signs"],"title":"TimingGuidance","description":"Overall timing guidance."},"TimingPrediction":{"properties":{"time_frame":{"type":"string","title":"Time Frame"},"estimated_duration":{"type":"integer","title":"Estimated Duration"},"basis":{"type":"string","title":"Basis"},"favorable_periods":{"items":{"type":"string"},"type":"array","title":"Favorable Periods"},"caution_periods":{"items":{"type":"string"},"type":"array","title":"Caution Periods"}},"type":"object","required":["time_frame","estimated_duration","basis","favorable_periods","caution_periods"],"title":"TimingPrediction","description":"Timing prediction for when the queried event may occur.\n\nAttributes:\n time_frame: General time frame (days, weeks, months)\n estimated_duration: Estimated number of time units\n basis: Basis for timing calculation\n favorable_periods: Upcoming favorable periods\n caution_periods: Periods to avoid"},"Tithi":{"properties":{"number":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Number","description":"Tithi number (1-30)"},"name":{"type":"string","title":"Name","description":"Name of the Tithi"},"paksha":{"type":"string","title":"Paksha","description":"Shukla (waxing) or Krishna (waning) half of the lunar month"},"lord":{"type":"string","title":"Lord","description":"Planetary lord of this tithi"},"progress":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Progress","description":"Progress of the Tithi (0-1)"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Start time of the Tithi"},"end_time":{"type":"string","format":"date-time","title":"End Time","description":"End time of the Tithi"},"ending_time":{"type":"string","format":"date-time","title":"Ending Time","description":"Alias of end_time"},"transition_time":{"type":"string","format":"date-time","title":"Transition Time","description":"Alias of end_time"},"spans":{"items":{"$ref":"#/components/schemas/LimbSpan"},"type":"array","title":"Spans","description":"Every tithi touching the sunrise-to-sunrise day, in order"}},"type":"object","required":["number","name","progress","start_time","end_time"],"title":"Tithi","description":"Schema for Tithi (lunar day) information."},"ToolkitSamagriItem":{"properties":{"id":{"type":"string","maxLength":80,"minLength":1,"title":"Id"},"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"quantity":{"type":"number","maximum":100000.0,"minimum":0.0,"title":"Quantity","default":1},"unit":{"type":"string","maxLength":40,"minLength":1,"title":"Unit","default":"count"},"category":{"type":"string","maxLength":60,"minLength":1,"title":"Category","default":"general"},"scales_with_attendees":{"type":"boolean","title":"Scales With Attendees","default":false},"packed":{"type":"boolean","title":"Packed","default":false},"provided_by":{"type":"string","enum":["purohit","family"],"title":"Provided By","default":"purohit"}},"type":"object","required":["id","name"],"title":"ToolkitSamagriItem"},"TopicCategory":{"type":"string","enum":["birth_charts","transits","remedies","predictions","compatibility","muhurat","general","learn"],"title":"TopicCategory","description":"Categories for forum topics."},"TransitAnalysisRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"analysis_date":{"type":"string","format":"date","title":"Analysis Date"}},"type":"object","required":["birth_details"],"title":"TransitAnalysisRequest","description":"Request for detailed transit analysis."},"TransitAnalysisResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"analysis_date":{"type":"string","format":"date","title":"Analysis Date"},"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"transit_impact":{"$ref":"#/components/schemas/TransitImpact"},"key_observations":{"items":{"type":"string"},"type":"array","title":"Key Observations"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["analysis_date","birth_details","transit_impact","key_observations","recommendations"],"title":"TransitAnalysisResponse","description":"Response for transit analysis."},"TransitBinduAnalysis":{"properties":{"planet":{"type":"string","title":"Planet"},"current_sign":{"type":"integer","title":"Current Sign"},"current_sign_name":{"type":"string","title":"Current Sign Name"},"bav_bindus":{"type":"integer","title":"Bav Bindus"},"sav_bindus":{"type":"integer","title":"Sav Bindus"},"transit_quality":{"$ref":"#/components/schemas/TransitQuality"},"interpretation":{"type":"string","title":"Interpretation"},"favorable_for":{"items":{"type":"string"},"type":"array","title":"Favorable For"},"challenging_for":{"items":{"type":"string"},"type":"array","title":"Challenging For"}},"type":"object","required":["planet","current_sign","current_sign_name","bav_bindus","sav_bindus","transit_quality","interpretation","favorable_for","challenging_for"],"title":"TransitBinduAnalysis","description":"Transit analysis using Ashtakavarga."},"TransitBodyOut":{"properties":{"number":{"type":"integer","title":"Number"},"name":{"type":"string","title":"Name"}},"type":"object","required":["number","name"],"title":"TransitBodyOut","description":"A transiting position named both ways, so a client never has to index a\nlist of Sanskrit names to know which one it got."},"TransitCompatibility":{"properties":{"overall_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Overall Score"},"favorable_transits":{"items":{"type":"string"},"type":"array","title":"Favorable Transits"},"challenging_transits":{"items":{"type":"string"},"type":"array","title":"Challenging Transits"},"neutral_transits":{"items":{"type":"string"},"type":"array","title":"Neutral Transits"},"recommendation":{"type":"string","title":"Recommendation"}},"type":"object","required":["overall_score","favorable_transits","challenging_transits","neutral_transits","recommendation"],"title":"TransitCompatibility","description":"Transit compatibility with natal chart"},"TransitImpact":{"properties":{"transit_positions":{"items":{"$ref":"#/components/schemas/TransitPosition"},"type":"array","title":"Transit Positions"},"natal_aspects":{"items":{"$ref":"#/components/schemas/NatalTransitAspect"},"type":"array","title":"Natal Aspects"},"house_transits":{"items":{"$ref":"#/components/schemas/TransitOverHouse"},"type":"array","title":"House Transits"},"saturn_transit":{"type":"string","title":"Saturn Transit"},"jupiter_transit":{"type":"string","title":"Jupiter Transit"},"rahu_ketu_axis":{"type":"string","title":"Rahu Ketu Axis"},"overall_transit_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Overall Transit Score"},"key_transits_summary":{"type":"string","title":"Key Transits Summary"}},"type":"object","required":["transit_positions","natal_aspects","house_transits","overall_transit_score","key_transits_summary"],"title":"TransitImpact","description":"Overall transit impact assessment."},"TransitInfo":{"properties":{"planet":{"type":"string","title":"Planet"},"from_sign":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"From Sign"},"to_sign":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"To Sign"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"description":{"type":"string","title":"Description"}},"type":"object","required":["planet","from_sign","to_sign","start_date","end_date","description"],"title":"TransitInfo"},"TransitNature":{"type":"string","enum":["benefic","malefic","mixed","neutral"],"title":"TransitNature","description":"Nature of transit effect"},"TransitOverHouse":{"properties":{"planet":{"type":"string","title":"Planet"},"house_number":{"type":"integer","title":"House Number"},"house_signification":{"type":"string","title":"House Signification"},"days_in_house":{"type":"integer","title":"Days In House"},"entry_date":{"type":"string","format":"date-time","title":"Entry Date"},"exit_date":{"type":"string","format":"date-time","title":"Exit Date"},"effect":{"type":"string","title":"Effect"},"nature":{"$ref":"#/components/schemas/InfluenceNature"}},"type":"object","required":["planet","house_number","house_signification","days_in_house","effect","nature"],"title":"TransitOverHouse","description":"Transit planet passing through a natal house."},"TransitPeriod":{"properties":{"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date of the transit period"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End date of the transit period"},"effects":{"items":{"$ref":"#/components/schemas/app__schemas__transit__TransitEffect"},"type":"array","title":"Effects","description":"List of transit effects during this period"},"overall_impact":{"type":"string","title":"Overall Impact","description":"Overall impact description for this period"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score","description":"Overall score for this period (0-1)"}},"type":"object","required":["start_date","end_date","effects","overall_impact","score"],"title":"TransitPeriod","description":"Model for a transit period with effects."},"TransitPosition":{"properties":{"planet":{"type":"string","title":"Planet"},"longitude":{"type":"number","title":"Longitude"},"sign":{"type":"integer","title":"Sign"},"sign_name":{"type":"string","title":"Sign Name"},"nakshatra":{"type":"integer","title":"Nakshatra"},"nakshatra_name":{"type":"string","title":"Nakshatra Name"},"nakshatra_pada":{"type":"integer","title":"Nakshatra Pada"},"is_retrograde":{"type":"boolean","title":"Is Retrograde","default":false},"speed":{"type":"number","title":"Speed","default":0.0}},"type":"object","required":["planet","longitude","sign","sign_name","nakshatra","nakshatra_name","nakshatra_pada"],"title":"TransitPosition","description":"Current transit position of a planet."},"TransitQualifier":{"properties":{"planet":{"type":"string","title":"Planet"},"sign":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign"},"sign_name":{"type":"string","title":"Sign Name"},"house_from_moon":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House From Moon"},"bindus":{"type":"integer","maximum":8.0,"minimum":0.0,"title":"Bindus"},"quality":{"type":"string","title":"Quality"},"vedha_by":{"type":"string","title":"Vedha By"}},"type":"object","required":["planet","sign","sign_name","house_from_moon","quality"],"title":"TransitQualifier","description":"One transiting planet qualified against the personal chart:\nashtakavarga bindus in its current sign, and any active vedha."},"TransitQuality":{"type":"string","enum":["excellent","good","neutral","challenging","difficult"],"title":"TransitQuality","description":"Quality of transit based on Ashtakavarga."},"TransitRequest":{"properties":{"birth_date":{"type":"string","format":"date-time","title":"Birth Date","description":"Date and time of birth"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude","description":"Latitude of birth location"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude","description":"Longitude of birth location"},"birth_timezone":{"type":"string","title":"Birth Timezone","description":"Timezone of birth location"},"transit_date":{"type":"string","format":"date-time","title":"Transit Date","description":"Date for which to calculate transits"},"transit_type":{"allOf":[{"$ref":"#/components/schemas/TransitType"}],"description":"Type of transit calculation"},"custom_days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Custom Days","description":"Number of days for custom transit (only for CUSTOM type)"}},"type":"object","required":["birth_date","birth_latitude","birth_longitude","birth_timezone","transit_date","transit_type"],"title":"TransitRequest","description":"Request model for transit calculations."},"TransitResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in ISO format"},"transit_date":{"type":"string","title":"Transit Date","description":"Transit date in ISO format"},"transit_type":{"allOf":[{"$ref":"#/components/schemas/TransitType"}],"description":"Type of transit calculation"},"periods":{"items":{"$ref":"#/components/schemas/TransitPeriod"},"type":"array","title":"Periods","description":"List of transit periods"},"summary":{"type":"string","title":"Summary","description":"Summary of transit effects"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations","description":"Recommendations based on transit effects"}},"type":"object","required":["birth_date","transit_date","transit_type","periods","summary","recommendations"],"title":"TransitResponse","description":"Response model for transit calculations."},"TransitSignificance":{"type":"string","enum":["major","moderate","minor"],"title":"TransitSignificance","description":"Significance level of a transit"},"TransitTimeline":{"properties":{"planet":{"type":"string","title":"Planet"},"event_type":{"type":"string","title":"Event Type","default":"sign_change"},"sign":{"type":"string","title":"Sign"},"sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign Num"},"from_sign":{"type":"string","title":"From Sign"},"from_sign_num":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"From Sign Num"},"date":{"type":"string","format":"date-time","title":"Date"},"is_retrograde":{"type":"boolean","title":"Is Retrograde","default":false},"house_from_moon":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House From Moon"},"significance":{"$ref":"#/components/schemas/TransitSignificance"}},"type":"object","required":["planet","sign","sign_num","from_sign","from_sign_num","date","house_from_moon","significance"],"title":"TransitTimeline","description":"One sidereal sign ingress in the transit timeline.\n\nEvery field is an identifier or a number, never a sentence: clients\ncompose and localize the line themselves."},"TransitTimelineRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"birth_time":{"type":"string","title":"Birth Time"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"start_date":{"type":"string","title":"Start Date","description":"Timeline start date in YYYY-MM-DD format"},"days_ahead":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Days Ahead","default":90},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude"],"title":"TransitTimelineRequest","description":"Request for transit timeline"},"TransitTimelineResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"timeline":{"items":{"$ref":"#/components/schemas/TransitTimeline"},"type":"array","title":"Timeline"},"major_events":{"items":{"$ref":"#/components/schemas/TransitTimeline"},"type":"array","title":"Major Events"}},"type":"object","required":["timeline","major_events"],"title":"TransitTimelineResponse","description":"Response for transit timeline"},"TransitTimingAnalysis":{"properties":{"planet":{"type":"string","title":"Planet"},"from_sign":{"type":"integer","title":"From Sign"},"to_sign":{"type":"integer","title":"To Sign"},"transit_date":{"type":"string","format":"date","title":"Transit Date"},"from_sign_bindus":{"type":"integer","title":"From Sign Bindus"},"to_sign_bindus":{"type":"integer","title":"To Sign Bindus"},"quality_change":{"type":"string","title":"Quality Change"},"recommendation":{"type":"string","title":"Recommendation"}},"type":"object","required":["planet","from_sign","to_sign","transit_date","from_sign_bindus","to_sign_bindus","quality_change","recommendation"],"title":"TransitTimingAnalysis","description":"Analysis of upcoming transit periods."},"TransitType":{"type":"string","enum":["daily","weekly","monthly","yearly","custom"],"title":"TransitType","description":"Types of transit calculations."},"TribhagaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"birth_tribhaga":{"type":"integer","title":"Birth Tribhaga"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","birth_tribhaga","strength_virupas"],"title":"TribhagaBala","description":"Three-part day/night strength."},"TripatakiChakra":{"properties":{"lagna_group":{"items":{"type":"string"},"type":"array","title":"Lagna Group"},"surya_group":{"items":{"type":"string"},"type":"array","title":"Surya Group"},"chandra_group":{"items":{"type":"string"},"type":"array","title":"Chandra Group"},"benefic_signs":{"items":{"type":"string"},"type":"array","title":"Benefic Signs"},"malefic_signs":{"items":{"type":"string"},"type":"array","title":"Malefic Signs"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["lagna_group","surya_group","chandra_group","benefic_signs","malefic_signs","interpretation"],"title":"TripatakiChakra","description":"Tripataki Chakra - Three-winged analysis"},"UchchaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"longitude":{"type":"number","title":"Longitude"},"exaltation_point":{"type":"number","title":"Exaltation Point"},"distance_from_exaltation":{"type":"number","title":"Distance From Exaltation"},"strength_virupas":{"type":"number","title":"Strength Virupas"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["planet","longitude","exaltation_point","distance_from_exaltation","strength_virupas","interpretation"],"title":"UchchaBala","description":"Exaltation/Debilitation strength."},"UdayaLagnaRow":{"properties":{"number":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Number","description":"The rising rashi, 1 = Mesha"},"name":{"type":"string","title":"Name","description":"The rashi's Sanskrit name, e.g. 'Makara'"},"start":{"type":"string","format":"date-time","title":"Start","description":"When this sign begins rising; at or after this day's sunrise"},"end":{"type":"string","format":"date-time","title":"End","description":"When it stops; at or before the next sunrise"}},"type":"object","required":["number","name","start","end"],"title":"UdayaLagnaRow","description":"One stretch of the day over which one rashi is rising.\n\nDay-clipped, unlike the limb spans of iteration 2. The sign rising at sunrise\nbegan rising before it -- always, on every day, everywhere -- so publishing the\nunclipped extent would put yesterday's clock time at the top of today's table,\nand nothing on a panchang page is measured in sixtieths of a lagna the way a\nnakshatra's ghatis are, so no second reader wants the real start.\n\nTHE ONE PLACE-DEPENDENT TABLE ON THE PAGE. Two cities on one meridian at\ndifferent latitudes agree about every tithi, nakshatra, yoga and karana in this\nresponse and disagree about this table all day, because the ascendant is where\nthe ecliptic meets the local horizon. At Delhi the twelve take between 95 and\n139 minutes each; nearer the poles the short ones shrink towards nothing."},"UnsubscribePayload":{"properties":{"endpoint":{"type":"string","title":"Endpoint"}},"type":"object","required":["endpoint"],"title":"UnsubscribePayload"},"UpaPadaLagna":{"properties":{"sign":{"type":"string","title":"Sign","description":"Sign of Upapada"},"sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Index","description":"Sign index"},"lord":{"type":"string","title":"Lord","description":"Lord of Upapada"},"lord_sign":{"type":"string","title":"Lord Sign","description":"Sign where UL lord is placed"},"planets_in_ul":{"items":{"type":"string"},"type":"array","title":"Planets In Ul","description":"Planets in UL"},"navamsa_ul":{"type":"string","title":"Navamsa Ul","description":"Reserved for an independently calculated Navamsa reference; empty when only the sign-level Upapada is available","default":""},"spouse_characteristics":{"items":{"type":"string"},"type":"array","title":"Spouse Characteristics","description":"Spouse traits"},"marriage_timing":{"type":"string","title":"Marriage Timing","description":"Likely marriage timing","default":""},"marriage_quality":{"type":"string","title":"Marriage Quality","description":"Marriage quality assessment","default":""}},"type":"object","required":["sign","sign_index","lord","lord_sign"],"title":"UpaPadaLagna","description":"Upapada Lagna (UL) - marriage significator."},"UpcomingEvent":{"properties":{"event_type":{"type":"string","title":"Event Type"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"date":{"type":"string","format":"date","title":"Date"},"time":{"type":"string","title":"Time"},"action_url":{"type":"string","title":"Action Url"},"priority":{"type":"string","title":"Priority","default":"normal"}},"type":"object","required":["event_type","title","description","date"],"title":"UpcomingEvent","description":"An upcoming event for the user."},"UpdatePrashnaInquiryRequest":{"properties":{"edited_question":{"type":"string","maxLength":500,"minLength":1,"title":"Edited Question"},"archived":{"type":"boolean","title":"Archived"}},"additionalProperties":false,"type":"object","title":"UpdatePrashnaInquiryRequest"},"UpdateSubscriptionRequest":{"properties":{"plan_id":{"type":"string","title":"Plan Id"},"auto_renew":{"type":"boolean","title":"Auto Renew"}},"type":"object","title":"UpdateSubscriptionRequest","description":"Request to update subscription."},"UsageResponse":{"properties":{"tier":{"type":"string","title":"Tier"},"limits":{"additionalProperties":{"type":"integer"},"type":"object","title":"Limits"},"usage":{"additionalProperties":{"type":"integer"},"type":"object","title":"Usage"},"remaining":{"additionalProperties":{"type":"integer"},"type":"object","title":"Remaining"},"reset_date":{"type":"string","title":"Reset Date"}},"type":"object","required":["tier","limits","usage","remaining"],"title":"UsageResponse","description":"Current usage for a user."},"UsageType":{"type":"string","enum":["daily_horoscopes","daily_kundali_charts","daily_muhurat_lookups","daily_transit_reports","daily_predictions","monthly_detailed_reports","monthly_compatibility_checks","monthly_dream_analyses","monthly_astro_consultations","api_calls_per_day"],"title":"UsageType","description":"Usage tracking types."},"UserForumProfile":{"properties":{"user_id":{"type":"string","title":"User Id","description":"Unique identifier of the user"},"username":{"type":"string","title":"Username","description":"Username of the user"},"reputation":{"type":"integer","title":"Reputation","description":"User's reputation score"},"post_count":{"type":"integer","title":"Post Count","description":"Number of posts created by the user"},"comment_count":{"type":"integer","title":"Comment Count","description":"Number of comments created by the user"},"accepted_answers":{"type":"integer","title":"Accepted Answers","description":"Number of accepted answers by the user"},"charts_shared":{"type":"integer","title":"Charts Shared","description":"Number of charts shared by the user"},"member_since":{"type":"string","format":"date-time","title":"Member Since","description":"Timestamp when the user joined"},"last_active":{"type":"string","format":"date-time","title":"Last Active","description":"Timestamp of user's last activity"},"expertise_tags":{"items":{"type":"string"},"type":"array","title":"Expertise Tags","description":"List of user's expertise areas"},"is_moderator":{"type":"boolean","title":"Is Moderator","description":"Whether the user is a moderator","default":false}},"type":"object","required":["user_id","username","reputation","post_count","comment_count","accepted_answers","charts_shared","member_since","last_active","expertise_tags"],"title":"UserForumProfile","description":"Schema for user forum profile."},"UserRemedyPreferences":{"properties":{"gender":{"allOf":[{"$ref":"#/components/schemas/app__schemas__remedies__Gender"}],"default":"prefer_not_to_say"},"life_stage":{"allOf":[{"$ref":"#/components/schemas/LifeStage"}],"default":"adult"},"age":{"type":"integer","title":"Age"},"cultural_tradition":{"allOf":[{"$ref":"#/components/schemas/CulturalTradition"}],"default":"hindu_north"},"language_preference":{"allOf":[{"$ref":"#/components/schemas/RegionalLanguage"}],"default":"sanskrit"},"accepts_idol_worship":{"type":"boolean","title":"Accepts Idol Worship","default":true},"accepts_animal_sacrifice_charity":{"type":"boolean","title":"Accepts Animal Sacrifice Charity","default":false},"dietary_preference":{"allOf":[{"$ref":"#/components/schemas/DietaryPreference"}],"default":"vegetarian"},"food_allergies":{"items":{"type":"string"},"type":"array","title":"Food Allergies","default":[]},"avoids_onion_garlic":{"type":"boolean","title":"Avoids Onion Garlic","default":false},"avoids_root_vegetables":{"type":"boolean","title":"Avoids Root Vegetables","default":false},"health_conditions":{"items":{"$ref":"#/components/schemas/HealthCondition"},"type":"array","default":[]},"fasting_capability":{"allOf":[{"$ref":"#/components/schemas/FastingCapability"}],"default":"fruit_fast"},"can_wear_heavy_jewelry":{"type":"boolean","title":"Can Wear Heavy Jewelry","default":true},"skin_sensitivities":{"items":{"type":"string"},"type":"array","title":"Skin Sensitivities","default":[]},"economic_preference":{"allOf":[{"$ref":"#/components/schemas/EconomicRange"}],"default":"moderate"},"country":{"type":"string","title":"Country","default":"India"},"state":{"type":"string","title":"State"},"city":{"type":"string","title":"City"},"can_visit_temples":{"type":"boolean","title":"Can Visit Temples","default":true},"mobility_limited":{"type":"boolean","title":"Mobility Limited","default":false},"daily_practice_minutes":{"type":"integer","title":"Daily Practice Minutes","default":30},"can_wake_early":{"type":"boolean","title":"Can Wake Early","default":true},"work_schedule":{"type":"string","title":"Work Schedule","default":"regular"}},"type":"object","title":"UserRemedyPreferences","description":"Comprehensive user preferences for personalized remedies."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VaraBala":{"properties":{"planet":{"type":"string","title":"Planet"},"birth_day":{"type":"string","title":"Birth Day"},"is_day_lord":{"type":"boolean","title":"Is Day Lord"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","birth_day","is_day_lord","strength_virupas"],"title":"VaraBala","description":"Weekday lord strength."},"VaraInfo":{"properties":{"number":{"type":"integer","maximum":6.0,"minimum":0.0,"title":"Number","description":"Vara number: 0 = Sunday, 1 = Monday, ... 6 = Saturday"},"name":{"type":"string","title":"Name","description":"English day name for this vara, e.g. Monday"}},"type":"object","required":["number","name"],"title":"VaraInfo","description":"Information about the Vara (weekday).\n\nAttributes:\n number: Vara number, 0 = Sunday through 6 = Saturday\n name: English day name, matching the number\n\n``number`` used to be Python's ``date.weekday()``, which counts from\nMonday, published under a Vedic name where the vara counts from Sunday --\nand this docstring said \"where 0 is Monday\", which is the bug written down\nrather than a description of one. It is a real vara now. Every value shifts\nby one: what was 0 (Monday) is 1, and Sunday moves from 6 to 0."},"VarnaKoota":{"properties":{"name":{"type":"string","title":"Name"},"max_points":{"type":"number","title":"Max Points"},"obtained_points":{"type":"number","title":"Obtained Points"},"percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Percentage"},"bride_value":{"type":"string","title":"Bride Value"},"groom_value":{"type":"string","title":"Groom Value"},"compatibility_status":{"type":"string","title":"Compatibility Status","description":"Good, Average, or Poor"},"description":{"type":"string","title":"Description"},"analysis":{"type":"string","title":"Analysis"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"bride_varna":{"type":"string","title":"Bride Varna","description":"Brahmin, Kshatriya, Vaishya, or Shudra"},"groom_varna":{"type":"string","title":"Groom Varna","description":"Brahmin, Kshatriya, Vaishya, or Shudra"}},"type":"object","required":["name","max_points","obtained_points","percentage","bride_value","groom_value","compatibility_status","description","analysis","bride_varna","groom_varna"],"title":"VarnaKoota","description":"Varna Koota - Spiritual/Work compatibility (1 point).\n\nVarna represents the spiritual development and ego compatibility.\nFour Varnas: Brahmin, Kshatriya, Vaishya, Shudra\n\nRules:\n- Same or higher Varna for groom = 1 point\n- Lower Varna for groom = 0 points"},"VarshaLord":{"properties":{"primary_lord":{"type":"string","title":"Primary Lord"},"primary_lord_strength":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Primary Lord Strength"},"secondary_lords":{"items":{"type":"string"},"type":"array","title":"Secondary Lords","default":[]},"selection_method":{"type":"string","title":"Selection Method"},"interpretation":{"type":"string","title":"Interpretation"},"favorable_activities":{"items":{"type":"string"},"type":"array","title":"Favorable Activities","default":[]}},"type":"object","required":["primary_lord","primary_lord_strength","selection_method","interpretation"],"title":"VarshaLord","description":"Year Lord (Varshesha) analysis"},"VarshaphalAnalysis":{"properties":{"birth_year":{"type":"integer","title":"Birth Year"},"analysis_year":{"type":"integer","title":"Analysis Year"},"age_entering":{"type":"integer","title":"Age Entering"},"solar_return_chart":{"$ref":"#/components/schemas/SolarReturnChart"},"muntha":{"$ref":"#/components/schemas/MunthaAnalysis"},"varsha_lord":{"$ref":"#/components/schemas/VarshaLord"},"sahams":{"items":{"$ref":"#/components/schemas/SahamData"},"type":"array","title":"Sahams"},"tajika_yogas":{"items":{"$ref":"#/components/schemas/TajikaYoga"},"type":"array","title":"Tajika Yogas"},"tripataki":{"$ref":"#/components/schemas/TripatakiChakra"},"varsha_panchanga":{"$ref":"#/components/schemas/PanchangaData"},"mudda_dasha":{"items":{"$ref":"#/components/schemas/MuddaDasha"},"type":"array","title":"Mudda Dasha"},"monthly_predictions":{"items":{"$ref":"#/components/schemas/MonthlyPrediction"},"type":"array","title":"Monthly Predictions"},"life_area_predictions":{"additionalProperties":{"$ref":"#/components/schemas/app__schemas__varshaphal__LifeAreaPrediction"},"type":"object","title":"Life Area Predictions"},"year_summary":{"type":"string","title":"Year Summary"},"key_opportunities":{"items":{"type":"string"},"type":"array","title":"Key Opportunities"},"key_challenges":{"items":{"type":"string"},"type":"array","title":"Key Challenges"},"best_months":{"items":{"type":"integer"},"type":"array","title":"Best Months"},"challenging_months":{"items":{"type":"integer"},"type":"array","title":"Challenging Months"},"overall_year_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Overall Year Score"},"year_theme":{"type":"string","title":"Year Theme"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"remedies":{"items":{"type":"string"},"type":"array","title":"Remedies"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"tajika"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["birth_year","analysis_year","age_entering","solar_return_chart","muntha","varsha_lord","sahams","tajika_yogas","tripataki","varsha_panchanga","mudda_dasha","monthly_predictions","life_area_predictions","year_summary","key_opportunities","key_challenges","best_months","challenging_months","overall_year_score","year_theme","recommendations","remedies"],"title":"VarshaphalAnalysis","description":"Complete Varshaphal (Annual Chart) Analysis"},"VarshaphalComparison":{"properties":{"years":{"items":{"type":"integer"},"type":"array","title":"Years"},"comparison_data":{"items":{"type":"object"},"type":"array","title":"Comparison Data"},"trends":{"type":"object","title":"Trends"},"best_year_for":{"additionalProperties":{"type":"integer"},"type":"object","title":"Best Year For"},"cyclical_patterns":{"items":{"type":"string"},"type":"array","title":"Cyclical Patterns"}},"type":"object","required":["years","comparison_data","trends","best_year_for","cyclical_patterns"],"title":"VarshaphalComparison","description":"Compare multiple years"},"VarshaphalRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in YYYY-MM-DD format"},"birth_time":{"type":"string","title":"Birth Time","description":"Birth time in HH:MM:SS format"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"year":{"type":"integer","title":"Year","description":"Year to analyze"},"current_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Current Latitude"},"current_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Current Longitude"},"include_sahams":{"type":"boolean","title":"Include Sahams","default":true},"include_tajika_yogas":{"type":"boolean","title":"Include Tajika Yogas","default":true},"include_monthly_predictions":{"type":"boolean","title":"Include Monthly Predictions","default":true},"include_mudda_dasha":{"type":"boolean","title":"Include Mudda Dasha","default":true},"include_life_areas":{"type":"boolean","title":"Include Life Areas","default":true},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Tajika sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude","year"],"title":"VarshaphalRequest","description":"Request for Varshaphal analysis"},"VarshaphalResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"analysis":{"$ref":"#/components/schemas/VarshaphalAnalysis"},"calculation_time_ms":{"type":"number","title":"Calculation Time Ms"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"tajika"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["analysis","calculation_time_ms"],"title":"VarshaphalResponse","description":"Response containing Varshaphal analysis"},"VashyaKoota":{"properties":{"name":{"type":"string","title":"Name"},"max_points":{"type":"number","title":"Max Points"},"obtained_points":{"type":"number","title":"Obtained Points"},"percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Percentage"},"bride_value":{"type":"string","title":"Bride Value"},"groom_value":{"type":"string","title":"Groom Value"},"compatibility_status":{"type":"string","title":"Compatibility Status","description":"Good, Average, or Poor"},"description":{"type":"string","title":"Description"},"analysis":{"type":"string","title":"Analysis"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"bride_vashya":{"type":"string","title":"Bride Vashya"},"groom_vashya":{"type":"string","title":"Groom Vashya"},"relationship_type":{"type":"string","title":"Relationship Type","description":"Same, Controller-Controlled, Food-Feeder, or Enemy"}},"type":"object","required":["name","max_points","obtained_points","percentage","bride_value","groom_value","compatibility_status","description","analysis","bride_vashya","groom_vashya","relationship_type"],"title":"VashyaKoota","description":"Vashya Koota - Mutual attraction and control (2 points).\n\nRepresents the magnetic control and dominance in relationship.\nCategories: Chatushpad, Manav, Jalachara, Vanachara, Keeta\n\nRules:\n- Same Vashya = 2 points\n- One controls other = 1 point\n- Food-feeder relation = 0.5 points\n- Enemy relation = 0 points"},"VedhaCheckRequest":{"properties":{"birth_nakshatra":{"type":"string","title":"Birth Nakshatra"},"birth_pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Birth Pada"},"transit_planet":{"type":"string","title":"Transit Planet"},"transit_nakshatra":{"type":"string","title":"Transit Nakshatra"}},"type":"object","required":["birth_nakshatra","birth_pada","transit_planet","transit_nakshatra"],"title":"VedhaCheckRequest","description":"Request to check Vedha for specific transit"},"VedhaCheckResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"vedha_present":{"type":"boolean","title":"Vedha Present"},"vedha_type":{"$ref":"#/components/schemas/VedhaType"},"effect":{"$ref":"#/components/schemas/VedhaEffect"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["vedha_present","interpretation"],"title":"VedhaCheckResponse","description":"Response for Vedha check"},"VedhaEffect":{"type":"string","enum":["benefic","malefic","neutral"],"title":"VedhaEffect","description":"Effect of Vedha"},"VedhaPoint":{"properties":{"transit_planet":{"type":"string","title":"Transit Planet"},"transit_house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Transit House"},"vedha_house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Vedha House"},"vedha_planet":{"type":"string","title":"Vedha Planet"},"is_vedha_active":{"type":"boolean","title":"Is Vedha Active","default":false},"vedha_effect":{"type":"string","title":"Vedha Effect"}},"type":"object","required":["transit_planet","transit_house","vedha_house","vedha_effect"],"title":"VedhaPoint","description":"Vedha (obstruction) information"},"VedhaType":{"type":"string","enum":["nakshatra_vedha","rashi_vedha","tithi_vedha","vara_vedha"],"title":"VedhaType","description":"Types of Vedha in Sarvatobhadra"},"VimsopakaAnalysis":{"properties":{"planet_scores":{"additionalProperties":{"$ref":"#/components/schemas/VimsopakaPlanet"},"type":"object","title":"Planet Scores"},"strongest_planet":{"type":"string","title":"Strongest Planet"},"weakest_planet":{"type":"string","title":"Weakest Planet"},"primary_group":{"type":"string","title":"Primary Group","default":"shodasavarga"},"calculation_standard":{"type":"string","title":"Calculation Standard","default":"BPHS Panchadha relationship weights"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"type":"object","required":["planet_scores","strongest_planet","weakest_planet"],"title":"VimsopakaAnalysis","description":"Vimsopaka Bala for the seven visible grahas."},"VimsopakaPlanet":{"properties":{"planet":{"type":"string","title":"Planet"},"shadvarga":{"type":"number","title":"Shadvarga"},"saptavarga":{"type":"number","title":"Saptavarga"},"dasavarga":{"type":"number","title":"Dasavarga"},"shodasavarga":{"type":"number","title":"Shodasavarga"},"grade":{"type":"string","title":"Grade"}},"type":"object","required":["planet","shadvarga","saptavarga","dasavarga","shodasavarga","grade"],"title":"VimsopakaPlanet","description":"One planet's four classical Vimsopaka group scores (0-20)."},"VisibilityLevel":{"type":"string","enum":["full","partial","not_visible","rising","setting"],"title":"VisibilityLevel","description":"Level of eclipse visibility from a location."},"VoiceLanguage":{"type":"string","enum":["en-US","en-GB","en-IN","hi-IN","es-ES","fr-FR","de-DE"],"title":"VoiceLanguage","description":"Supported languages"},"VoicePreferencesRequest":{"properties":{"voice":{"type":"string","title":"Voice","default":"female_calm"},"language":{"type":"string","title":"Language","default":"en-US"},"audio_format":{"type":"string","title":"Audio Format","default":"mp3"},"speech_rate":{"type":"number","maximum":2.0,"minimum":0.5,"title":"Speech Rate","default":1.0},"include_music":{"type":"boolean","title":"Include Music","default":false},"include_mantras":{"type":"boolean","title":"Include Mantras","default":false}},"type":"object","title":"VoicePreferencesRequest","description":"Voice preferences request"},"VoiceType":{"type":"string","enum":["female_calm","female_warm","male_deep","male_friendly","neutral"],"title":"VoiceType","description":"Available voice types"},"VoteRequest":{"properties":{"vote_type":{"allOf":[{"$ref":"#/components/schemas/VoteType"}],"description":"Type of vote (upvote or downvote)"}},"type":"object","required":["vote_type"],"title":"VoteRequest","description":"Schema for voting on posts or comments."},"VoteType":{"type":"string","enum":["upvote","downvote"],"title":"VoteType","description":"Types of votes on posts and comments."},"VratCalendarResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/VratEvent"},"type":"array","title":"Events","description":"List of Vrat events"}},"type":"object","required":["events"],"title":"VratCalendarResponse","description":"Schema for Vrat calendar response."},"VratEvent":{"properties":{"name":{"type":"string","title":"Name","description":"Name of the Vrat"},"date":{"type":"string","title":"Date","description":"Date of the Vrat in ISO format"},"start_time":{"type":"string","title":"Start Time","description":"Start time of the Vrat in HH:MM format"},"end_time":{"type":"string","title":"End Time","description":"End time of the Vrat in HH:MM format"},"tithi":{"type":"string","title":"Tithi","description":"Tithi on which the Vrat occurs"},"significance":{"type":"string","title":"Significance","description":"Significance and purpose of the Vrat"},"region_specific_names":{"additionalProperties":{"type":"string"},"type":"object","title":"Region Specific Names","description":"Region-specific names for the Vrat"},"recommended_foods":{"items":{"type":"string"},"type":"array","title":"Recommended Foods","description":"Recommended foods for the Vrat"},"breaking_rules":{"type":"string","title":"Breaking Rules","description":"Rules for breaking the fast","default":""}},"type":"object","required":["name","date","start_time","end_time","tithi","significance"],"title":"VratEvent","description":"Schema for a Vrat event."},"WeekDayOut":{"properties":{"date":{"type":"string","title":"Date"},"weekday":{"type":"string","title":"Weekday"},"quality":{"type":"string","title":"Quality"},"score":{"type":"integer","title":"Score"},"highlight":{"type":"string","title":"Highlight"},"avoid":{"type":"string","title":"Avoid"}},"type":"object","required":["date","weekday","quality","score"],"title":"WeekDayOut"},"WeeklyOverviewOut":{"properties":{"week_start":{"type":"string","title":"Week Start"},"location":{"$ref":"#/components/schemas/app__routers__astro_calendar__LocationOut"},"days":{"items":{"$ref":"#/components/schemas/WeekDayOut"},"type":"array","title":"Days"},"best_day":{"$ref":"#/components/schemas/WeekDayOut"},"week_theme":{"type":"string","title":"Week Theme"},"tips":{"items":{"type":"string"},"type":"array","title":"Tips"}},"type":"object","required":["week_start","location","days","week_theme","tips"],"title":"WeeklyOverviewOut"},"WeeklyPredictionRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"start_date":{"type":"string","format":"date","title":"Start Date"}},"type":"object","required":["birth_details"],"title":"WeeklyPredictionRequest","description":"Request for weekly prediction."},"YantraDetails":{"properties":{"name":{"type":"string","title":"Name"},"deity":{"type":"string","title":"Deity"},"ruling_planet":{"type":"string","title":"Ruling Planet"},"purpose":{"type":"string","title":"Purpose"},"material":{"type":"string","title":"Material"},"size_options":{"items":{"type":"string"},"type":"array","title":"Size Options"}},"type":"object","required":["name","deity","purpose","material","size_options"],"title":"YantraDetails","description":"Details of a yantra."},"YantraRecommendation":{"properties":{"primary_yantra":{"$ref":"#/components/schemas/YantraRemedy"},"supporting_yantras":{"items":{"$ref":"#/components/schemas/YantraRemedy"},"type":"array","title":"Supporting Yantras"},"placement_guide":{"type":"string","title":"Placement Guide"}},"type":"object","required":["primary_yantra","supporting_yantras","placement_guide"],"title":"YantraRecommendation","description":"Complete yantra recommendation set."},"YantraRemedy":{"properties":{"yantra":{"$ref":"#/components/schemas/YantraDetails"},"reason":{"type":"string","title":"Reason"},"problem_addressed":{"type":"string","title":"Problem Addressed"},"energization_required":{"type":"boolean","title":"Energization Required"},"best_day_to_install":{"type":"string","title":"Best Day To Install"},"best_time":{"type":"string","title":"Best Time"},"direction_to_place":{"type":"string","title":"Direction To Place"},"location_in_home":{"type":"string","title":"Location In Home"},"daily_worship":{"type":"string","title":"Daily Worship"},"weekly_worship":{"type":"string","title":"Weekly Worship"},"re_energization_period":{"type":"string","title":"Re Energization Period"},"handling_guidelines":{"items":{"type":"string"},"type":"array","title":"Handling Guidelines"},"effectiveness_score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Effectiveness Score"}},"type":"object","required":["yantra","reason","problem_addressed","energization_required","best_day_to_install","best_time","direction_to_place","location_in_home","daily_worship","weekly_worship","re_energization_period","handling_guidelines","effectiveness_score"],"title":"YantraRemedy","description":"Yantra recommendation."},"YearComparisonRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"birth_time":{"type":"string","title":"Birth Time"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Tajika sidereal ayanamsa (default Lahiri)"},"years":{"items":{"type":"integer"},"type":"array","maxItems":10,"minItems":2,"title":"Years"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude","years"],"title":"YearComparisonRequest","description":"Request to compare multiple years"},"YearComparisonResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"comparison":{"$ref":"#/components/schemas/VarshaphalComparison"}},"type":"object","required":["comparison"],"title":"YearComparisonResponse","description":"Response for year comparison"},"YearLordRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date"},"birth_time":{"type":"string","title":"Birth Time"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude"},"birth_timezone":{"type":"string","title":"Birth Timezone","default":"UTC"},"year":{"type":"integer","title":"Year"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Tajika sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_date","birth_time","birth_latitude","birth_longitude","year"],"title":"YearLordRequest","description":"Request for Year Lord calculation"},"YearLordResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"year_lord":{"$ref":"#/components/schemas/VarshaLord"},"muntha":{"$ref":"#/components/schemas/MunthaAnalysis"}},"type":"object","required":["year_lord","muntha"],"title":"YearLordResponse","description":"Response for Year Lord calculation"},"YearlyPredictionRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/PredictionBirthDetails"},"year":{"type":"integer","maximum":9999.0,"minimum":1.0,"title":"Year","description":"Year; default: current year"}},"type":"object","required":["birth_details"],"title":"YearlyPredictionRequest","description":"Request for yearly prediction."},"Yoga":{"properties":{"number":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Number","description":"Yoga number (1-27)"},"name":{"type":"string","title":"Name","description":"Name of the Yoga"},"start_time":{"type":"string","format":"date-time","title":"Start Time","description":"Start time of the Yoga"},"end_time":{"type":"string","format":"date-time","title":"End Time","description":"End time of the Yoga"},"transition_time":{"type":"string","format":"date-time","title":"Transition Time","description":"Alias of end_time"},"spans":{"items":{"$ref":"#/components/schemas/LimbSpan"},"type":"array","title":"Spans","description":"Every yoga touching the sunrise-to-sunrise day, in order"}},"type":"object","required":["number","name","start_time","end_time"],"title":"Yoga","description":"Schema for Yoga (planetary combination) information."},"YogaActivation":{"properties":{"yoga_name":{"type":"string","title":"Yoga Name"},"yoga_type":{"type":"string","title":"Yoga Type"},"is_activated":{"type":"boolean","title":"Is Activated"},"activation_trigger":{"type":"string","title":"Activation Trigger"},"activation_period":{"type":"string","title":"Activation Period"},"expected_results":{"type":"string","title":"Expected Results"},"strength":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Strength"}},"type":"object","required":["yoga_name","yoga_type","is_activated","activation_trigger","expected_results","strength"],"title":"YogaActivation","description":"Yoga activation status due to transits."},"YogaData":{"properties":{"name":{"type":"string","title":"Name"},"category":{"type":"string","title":"Category"},"is_present":{"type":"boolean","title":"Is Present","default":true},"strength":{"type":"string","title":"Strength","description":"purna, madhya, alpa, or bhanga"},"strength_percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Strength Percentage"},"planets_involved":{"items":{"type":"string"},"type":"array","title":"Planets Involved"},"houses_involved":{"items":{"type":"integer"},"type":"array","title":"Houses Involved"},"signs_involved":{"items":{"type":"string"},"type":"array","title":"Signs Involved"},"description":{"type":"string","title":"Description"},"effects":{"additionalProperties":{"type":"string"},"type":"object","title":"Effects"},"is_benefic":{"type":"boolean","title":"Is Benefic","default":true},"cancellation_factors":{"items":{"type":"string"},"type":"array","title":"Cancellation Factors"},"enhancement_factors":{"items":{"type":"string"},"type":"array","title":"Enhancement Factors"}},"type":"object","required":["name","category","strength","strength_percentage","planets_involved","houses_involved","signs_involved","description"],"title":"YogaData","description":"Data for a single detected yoga.\n\nAttributes:\n name: Name of the yoga (e.g., \"Gajakesari Yoga\")\n category: Category of yoga (raj_yoga, dhana_yoga, etc.)\n is_present: Whether the yoga is present in the chart\n strength: Strength level (purna, madhya, alpa, bhanga)\n strength_percentage: Numerical strength (0-100%)\n planets_involved: Planets forming this yoga\n houses_involved: Houses involved in the yoga\n signs_involved: Signs where the yoga is formed\n description: Brief description of the yoga\n effects: Expected effects of this yoga\n is_benefic: Whether yoga gives positive results\n cancellation_factors: Any factors that weaken/cancel the yoga\n enhancement_factors: Factors that strengthen the yoga"},"YogaRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"include_pancha_mahapurusha":{"type":"boolean","title":"Include Pancha Mahapurusha","default":true},"include_raj_yogas":{"type":"boolean","title":"Include Raj Yogas","default":true},"include_dhana_yogas":{"type":"boolean","title":"Include Dhana Yogas","default":true},"include_chandra_yogas":{"type":"boolean","title":"Include Chandra Yogas","default":true},"include_nabhas_yogas":{"type":"boolean","title":"Include Nabhas Yogas","default":true},"include_special_yogas":{"type":"boolean","title":"Include Special Yogas","default":true},"include_neechabhanga":{"type":"boolean","title":"Include Neechabhanga","default":true},"minimum_strength":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Minimum Strength","default":0},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_details"],"title":"YogaRequest","description":"Request model for Yoga calculations.\n\nAttributes:\n birth_details: Birth details for yoga calculation\n include_pancha_mahapurusha: Include 5 great person yogas\n include_raj_yogas: Include power/authority yogas\n include_dhana_yogas: Include wealth yogas\n include_chandra_yogas: Include Moon-based yogas\n include_nabhas_yogas: Include pattern yogas\n include_special_yogas: Include special combinations\n include_neechabhanga: Analyze debilitation cancellation\n minimum_strength: Minimum strength to report (0-100)"},"YogaResponse":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"total_yogas_found":{"type":"integer","title":"Total Yogas Found"},"benefic_yoga_count":{"type":"integer","title":"Benefic Yoga Count"},"malefic_yoga_count":{"type":"integer","title":"Malefic Yoga Count"},"pancha_mahapurusha":{"items":{"$ref":"#/components/schemas/PanchaMahapurushaYoga"},"type":"array","title":"Pancha Mahapurusha"},"raj_yogas":{"$ref":"#/components/schemas/RajYogaSummary"},"dhana_yogas":{"$ref":"#/components/schemas/DhanaYogaSummary"},"chandra_yogas":{"$ref":"#/components/schemas/ChandraYogaSummary"},"nabhas_yogas":{"$ref":"#/components/schemas/NabhasyogaSummary"},"special_yogas":{"$ref":"#/components/schemas/SpecialYogaSummary"},"neechabhanga":{"$ref":"#/components/schemas/NeechabhangaAnalysis"},"strongest_yogas":{"items":{"$ref":"#/components/schemas/YogaData"},"type":"array","title":"Strongest Yogas"},"overall_yoga_strength":{"type":"string","title":"Overall Yoga Strength","description":"exceptional, strong, moderate, weak"},"life_predictions":{"additionalProperties":{"type":"string"},"type":"object","title":"Life Predictions"},"timing_indications":{"items":{"type":"string"},"type":"array","title":"Timing Indications"},"remedial_suggestions":{"items":{"type":"string"},"type":"array","title":"Remedial Suggestions"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["birth_details","total_yogas_found","benefic_yoga_count","malefic_yoga_count","pancha_mahapurusha","raj_yogas","dhana_yogas","chandra_yogas","nabhas_yogas","special_yogas","neechabhanga","strongest_yogas","overall_yoga_strength"],"title":"YogaResponse","description":"Complete Yoga analysis response.\n\nAttributes:\n birth_details: Original birth details\n total_yogas_found: Total number of yogas detected\n benefic_yoga_count: Count of beneficial yogas\n malefic_yoga_count: Count of challenging yogas\n pancha_mahapurusha: Analysis of 5 great person yogas\n raj_yogas: Analysis of Raj (power) yogas\n dhana_yogas: Analysis of Dhana (wealth) yogas\n chandra_yogas: Analysis of Moon yogas\n nabhas_yogas: Analysis of pattern yogas\n special_yogas: Analysis of special combinations\n neechabhanga: Debilitation cancellation analysis\n strongest_yogas: Top 5 strongest yogas\n overall_yoga_strength: Overall yoga strength in chart\n life_predictions: Predictions based on yogas\n timing_indications: When yogas may activate\n remedial_suggestions: Suggestions to enhance/mitigate"},"YoniKoota":{"properties":{"name":{"type":"string","title":"Name"},"max_points":{"type":"number","title":"Max Points"},"obtained_points":{"type":"number","title":"Obtained Points"},"percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Percentage"},"bride_value":{"type":"string","title":"Bride Value"},"groom_value":{"type":"string","title":"Groom Value"},"compatibility_status":{"type":"string","title":"Compatibility Status","description":"Good, Average, or Poor"},"description":{"type":"string","title":"Description"},"analysis":{"type":"string","title":"Analysis"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"bride_yoni":{"type":"string","title":"Bride Yoni"},"groom_yoni":{"type":"string","title":"Groom Yoni"},"yoni_relationship":{"type":"string","title":"Yoni Relationship","description":"Same, Friendly, Neutral, Enemy, or Sworn Enemy"}},"type":"object","required":["name","max_points","obtained_points","percentage","bride_value","groom_value","compatibility_status","description","analysis","bride_yoni","groom_yoni","yoni_relationship"],"title":"YoniKoota","description":"Yoni Koota - Sexual/Physical compatibility (4 points).\n\nBased on animal symbolism of nakshatras.\n\n14 Yonis: Horse, Elephant, Sheep, Serpent, Dog, Cat, Rat,\nCow, Buffalo, Tiger, Deer, Monkey, Lion, Mongoose\n\nRules:\n- Same Yoni = 4 points\n- Friendly Yonis = 3 points\n- Neutral Yonis = 2 points\n- Enemy Yonis = 1 point\n- Sworn enemies = 0 points"},"YuddhaBala":{"properties":{"planet":{"type":"string","title":"Planet"},"is_in_war":{"type":"boolean","title":"Is In War"},"opponent":{"type":"string","title":"Opponent"},"is_winner":{"type":"boolean","title":"Is Winner"},"strength_virupas":{"type":"number","title":"Strength Virupas"}},"type":"object","required":["planet","is_in_war","strength_virupas"],"title":"YuddhaBala","description":"Planetary war strength."},"app__routers__astro_calendar__ActivityInfoOut":{"properties":{"type":{"type":"string","title":"Type"},"description":{"type":"string","title":"Description"},"best_weekdays":{"items":{"type":"string"},"type":"array","title":"Best Weekdays"},"favorable_planets":{"items":{"type":"string"},"type":"array","title":"Favorable Planets"}},"type":"object","required":["type","description","best_weekdays","favorable_planets"],"title":"ActivityInfoOut"},"app__routers__astro_calendar__FavorableDayOut":{"properties":{"date":{"type":"string","title":"Date"},"weekday":{"type":"string","title":"Weekday"},"score":{"type":"integer","title":"Score"},"quality":{"type":"string","title":"Quality"},"tithi":{"type":"string","title":"Tithi"},"paksha":{"type":"string","title":"Paksha"},"nakshatra":{"type":"string","title":"Nakshatra"},"moon_sign":{"type":"string","title":"Moon Sign"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["date","weekday","score","quality","tithi","paksha","nakshatra","moon_sign","reason"],"title":"FavorableDayOut"},"app__routers__astro_calendar__LocationOut":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"timezone":{"type":"string","title":"Timezone"}},"type":"object","required":["latitude","longitude","timezone"],"title":"LocationOut"},"app__routers__astro_calendar__PanchangOut":{"properties":{"tithi":{"type":"string","title":"Tithi"},"tithi_number":{"type":"integer","title":"Tithi Number"},"paksha":{"type":"string","title":"Paksha"},"nakshatra":{"type":"string","title":"Nakshatra"},"nakshatra_pada":{"type":"integer","title":"Nakshatra Pada"},"moon_sign":{"type":"string","title":"Moon Sign"}},"type":"object","required":["tithi","tithi_number","paksha","nakshatra","nakshatra_pada","moon_sign"],"title":"PanchangOut"},"app__routers__astro_calendar__SearchRangeOut":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"}},"type":"object","required":["start","end"],"title":"SearchRangeOut"},"app__routers__astro_calendar__SetChartRequest":{"properties":{"user_id":{"type":"string","title":"User Id","description":"User ID"},"chart_data":{"type":"object","title":"Chart Data","description":"Birth chart data","example":{"birth_date":"1990-05-15","ascendant":"Leo","moon_sign":"Taurus"}}},"type":"object","required":["user_id","chart_data"],"title":"SetChartRequest"},"app__routers__astro_calendar__SunTimesOut":{"properties":{"sunrise":{"type":"string","title":"Sunrise"},"sunset":{"type":"string","title":"Sunset"}},"type":"object","required":["sunrise","sunset"],"title":"SunTimesOut"},"app__routers__chart_export__PlanetPosition":{"properties":{"name":{"type":"string","title":"Name","description":"Planet name"},"degrees":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Degrees","description":"Position in degrees (0-360)"}},"type":"object","required":["name","degrees"],"title":"PlanetPosition","description":"Planet position data."},"app__routers__extended_dasha__DashaRequest":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in YYYY-MM-DD format"},"birth_time":{"type":"string","title":"Birth Time","description":"Birth time in HH:MM format"},"birth_timezone":{"type":"string","format":"iana-timezone","title":"Birth Timezone","description":"IANA timezone of the birth place","example":"Asia/Kolkata"},"moon_longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Moon Longitude","description":"Moon longitude in degrees"},"years_to_calculate":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Years To Calculate","description":"Years to calculate","default":120}},"type":"object","required":["birth_date","birth_time","birth_timezone","moon_longitude"],"title":"DashaRequest","description":"Request model for dasha calculations."},"app__routers__extended_dasha__DashaResponse":{"properties":{"system":{"type":"string","title":"System"},"total_cycle_years":{"type":"integer","title":"Total Cycle Years"},"birth_nakshatra":{"type":"string","title":"Birth Nakshatra"},"birth_nakshatra_lord":{"type":"string","title":"Birth Nakshatra Lord"},"balance_at_birth":{"type":"number","title":"Balance At Birth"},"current_dasha":{"$ref":"#/components/schemas/DashaPeriodResponse"},"current_antardasha":{"$ref":"#/components/schemas/DashaPeriodResponse"},"all_mahadashas":{"items":{"$ref":"#/components/schemas/DashaPeriodResponse"},"type":"array","title":"All Mahadashas"},"upcoming_periods":{"items":{"$ref":"#/components/schemas/DashaPeriodResponse"},"type":"array","title":"Upcoming Periods"}},"type":"object","required":["system","total_cycle_years","birth_nakshatra","birth_nakshatra_lord","balance_at_birth","all_mahadashas","upcoming_periods"],"title":"DashaResponse","description":"Response model for dasha calculation."},"app__routers__voice_horoscope__ChartInput":{"properties":{"ascendant":{"type":"object","title":"Ascendant"},"planets":{"additionalProperties":{"type":"object"},"type":"object","title":"Planets"}},"type":"object","title":"ChartInput","description":"Birth chart input"},"app__schemas__advanced_muhurta__ActivityInfoOut":{"properties":{"code":{"type":"string","title":"Code"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"min_recommended_score":{"type":"number","title":"Min Recommended Score"}},"type":"object","required":["code","name","description","min_recommended_score"],"title":"ActivityInfoOut"},"app__schemas__advanced_muhurta__FavorableDayOut":{"properties":{"date":{"type":"string","title":"Date"},"weekday":{"type":"string","title":"Weekday"},"tithi":{"type":"string","title":"Tithi"},"paksha":{"type":"string","title":"Paksha"},"nakshatra":{"type":"string","title":"Nakshatra"},"moon_rashi":{"type":"string","title":"Moon Rashi"},"score":{"type":"number","title":"Score"},"quality":{"type":"string","title":"Quality"},"meets_recommended_score":{"type":"boolean","title":"Meets Recommended Score"},"component_scores":{"additionalProperties":{"type":"number"},"type":"object","title":"Component Scores"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["date","weekday","tithi","paksha","nakshatra","moon_rashi","score","quality","meets_recommended_score","reason"],"title":"FavorableDayOut","description":"One ranked day, with the elements its score was read from.\n\n``component_scores`` and the panchang elements beside it come off the same\nJulian day as ``score``, so a client can show the reasoning without the\nreasoning contradicting the number."},"app__schemas__advanced_muhurta__LocationOut":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"}},"type":"object","required":["latitude","longitude"],"title":"LocationOut"},"app__schemas__advanced_muhurta__PanchangOut":{"properties":{"tithi":{"type":"string","title":"Tithi"},"nakshatra":{"type":"string","title":"Nakshatra"},"yoga":{"type":"string","title":"Yoga"},"karana":{"type":"string","title":"Karana"},"weekday":{"type":"string","title":"Weekday"}},"type":"object","required":["tithi","nakshatra","yoga","karana","weekday"],"title":"PanchangOut"},"app__schemas__advanced_muhurta__SearchRangeOut":{"properties":{"start":{"type":"string","title":"Start"},"end":{"type":"string","title":"End"}},"type":"object","required":["start","end"],"title":"SearchRangeOut"},"app__schemas__advanced_muhurta__SunTimesOut":{"properties":{"sunrise":{"type":"string","title":"Sunrise"},"sunset":{"type":"string","title":"Sunset"}},"type":"object","required":["sunrise","sunset"],"title":"SunTimesOut"},"app__schemas__ashtakavarga__AshtakavargaRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/AshtakavargaBirthDetails"}},"type":"object","required":["birth_details"],"title":"AshtakavargaRequest","description":"Request for Ashtakavarga analysis."},"app__schemas__ashtakavarga__AshtakavargaResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"analysis":{"$ref":"#/components/schemas/AshtakavargaAnalysis"}},"type":"object","required":["analysis"],"title":"AshtakavargaResponse","description":"Complete Ashtakavarga analysis response."},"app__schemas__baby_name__Gender":{"type":"string","enum":["male","female","unisex","unknown"],"title":"Gender","description":"Gender for name suggestions."},"app__schemas__dasha__DashaPeriod":{"properties":{"planet":{"type":"string","title":"Planet","description":"Ruling planet of the Dasha period"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date of the Dasha period"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End date of the Dasha period"},"duration_years":{"type":"number","title":"Duration Years","description":"Duration of the Dasha period in years"},"sub_periods":{"items":{"$ref":"#/components/schemas/SubDashaPeriod"},"type":"array","title":"Sub Periods","description":"Sub-periods within this Dasha"},"description":{"type":"string","title":"Description","description":"Description of the Dasha period"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Strength of the Dasha period (0-1)"},"is_beneficial":{"type":"boolean","title":"Is Beneficial","description":"Whether the Dasha period is generally beneficial"}},"type":"object","required":["planet","start_date","end_date","duration_years","sub_periods","description","strength","is_beneficial"],"title":"DashaPeriod","description":"Model for a Dasha period."},"app__schemas__dasha__DashaRequest":{"properties":{"birth_date":{"type":"string","format":"date-time","title":"Birth Date","description":"Date and time of birth"},"birth_latitude":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Birth Latitude","description":"Latitude of birth location"},"birth_longitude":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Birth Longitude","description":"Longitude of birth location"},"birth_timezone":{"type":"string","title":"Birth Timezone","description":"Timezone of birth location"},"dasha_system":{"allOf":[{"$ref":"#/components/schemas/DashaSystem"}],"description":"Dasha system to use","default":"vimshottari"},"start_date":{"type":"string","format":"date-time","title":"Start Date","description":"Start date for Dasha calculation (defaults to birth date)"},"end_date":{"type":"string","format":"date-time","title":"End Date","description":"End date for Dasha calculation (defaults to 120 years from birth)"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_date","birth_latitude","birth_longitude","birth_timezone"],"title":"DashaRequest","description":"Request model for Dasha calculations."},"app__schemas__dasha__DashaResponse":{"properties":{"birth_date":{"type":"string","title":"Birth Date","description":"Birth date in ISO format"},"dasha_system":{"allOf":[{"$ref":"#/components/schemas/DashaSystem"}],"description":"Dasha system used"},"periods":{"items":{"$ref":"#/components/schemas/app__schemas__dasha__DashaPeriod"},"type":"array","title":"Periods","description":"List of Dasha periods"},"current_period":{"allOf":[{"$ref":"#/components/schemas/app__schemas__dasha__DashaPeriod"}],"title":"Current Period","description":"Current Dasha period"},"next_period":{"allOf":[{"$ref":"#/components/schemas/app__schemas__dasha__DashaPeriod"}],"title":"Next Period","description":"Next Dasha period"},"summary":{"type":"string","title":"Summary","description":"Summary of Dasha periods"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations","description":"Recommendations based on Dasha periods"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["birth_date","dasha_system","periods","current_period","next_period","summary","recommendations"],"title":"DashaResponse","description":"Response model for Dasha calculations."},"app__schemas__dasha__JaiminiKaraka":{"type":"string","enum":["atmakaraka","amatyakaraka","bhratrukaraka","matrukaraka","putrakaraka","gnatikaraka","darakaraka"],"title":"JaiminiKaraka","description":"Jaimini Karakas (Significators)."},"app__schemas__gemstone__GemstoneRecommendation":{"properties":{"gemstone_type":{"allOf":[{"$ref":"#/components/schemas/GemstoneType"}],"description":"Type of gemstone"},"ruling_planet":{"type":"string","title":"Ruling Planet","description":"Planet ruled by this gemstone"},"weight_in_carats":{"type":"number","title":"Weight In Carats","description":"Recommended weight in carats"},"finger":{"type":"string","title":"Finger","description":"Recommended finger to wear the gemstone on"},"day_to_wear":{"type":"string","title":"Day To Wear","description":"Recommended day to wear the gemstone"},"benefits":{"items":{"type":"string"},"type":"array","title":"Benefits","description":"Benefits of wearing this gemstone"},"precautions":{"items":{"type":"string"},"type":"array","title":"Precautions","description":"Precautions when wearing this gemstone"},"is_primary":{"type":"boolean","title":"Is Primary","description":"Whether this is a primary recommendation"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Strength of the recommendation (0-1)"}},"type":"object","required":["gemstone_type","ruling_planet","weight_in_carats","finger","day_to_wear","benefits","precautions","is_primary","strength"],"title":"GemstoneRecommendation","description":"Model for a gemstone recommendation."},"app__schemas__jaimini__JaiminiKaraka":{"properties":{"karaka_type":{"allOf":[{"$ref":"#/components/schemas/JaiminiKarakaType"}],"description":"Type of karaka"},"planet":{"type":"string","title":"Planet","description":"Planet acting as this karaka"},"degree":{"type":"number","maximum":30.0,"minimum":0.0,"title":"Degree","description":"Degree within sign"},"sign":{"type":"string","title":"Sign","description":"Sign placement"},"sign_index":{"type":"integer","maximum":11.0,"minimum":0.0,"title":"Sign Index","description":"Sign index (0-11)"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House","description":"House from Lagna"},"nakshatra":{"type":"string","title":"Nakshatra","description":"Nakshatra placement","default":""},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Relative strength"},"significations":{"items":{"type":"string"},"type":"array","title":"Significations","description":"Life areas governed"},"predictions":{"items":{"type":"string"},"type":"array","title":"Predictions","description":"Interpretations"}},"type":"object","required":["karaka_type","planet","degree","sign","sign_index","house","strength"],"title":"JaiminiKaraka","description":"Jaimini Chara Karaka information."},"app__schemas__kundali__AshtakavargaRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"include_interpretations":{"type":"boolean","title":"Include Interpretations","description":"Include planetary strength interpretations","default":true},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_details"],"title":"AshtakavargaRequest","description":"Request model for Ashtakavarga calculations.\n\nAttributes:\n birth_details: Birth details for calculation\n include_interpretations: Whether to include strength assessments\n ayanamsa: Optional Parashari sidereal ayanamsa (default Lahiri)"},"app__schemas__kundali__AshtakavargaResponse":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"bhinnashtakavarga":{"additionalProperties":{"$ref":"#/components/schemas/BhinnashtakavargaData"},"type":"object","title":"Bhinnashtakavarga","description":"BAV data for each planet"},"sarvashtakavarga":{"allOf":[{"$ref":"#/components/schemas/SarvashtakavargaData"}],"title":"Sarvashtakavarga","description":"Combined Sarvashtakavarga"},"planetary_strengths":{"items":{"$ref":"#/components/schemas/PlanetaryStrength"},"type":"array","title":"Planetary Strengths","description":"Strength assessment for each planet"},"interpretation":{"type":"string","title":"Interpretation","description":"Overall Ashtakavarga interpretation"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["birth_details","bhinnashtakavarga","sarvashtakavarga"],"title":"AshtakavargaResponse","description":"Complete Ashtakavarga response.\n\nAttributes:\n birth_details: Original birth details\n bhinnashtakavarga: Individual BAV for each planet\n sarvashtakavarga: Combined SAV data\n planetary_strengths: Strength assessment for each planet\n interpretation: Overall interpretation notes"},"app__schemas__kundali__DashaPeriod":{"properties":{"planet":{"type":"string","title":"Planet"},"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"sub_periods":{"items":{"$ref":"#/components/schemas/app__schemas__kundali__DashaPeriod"},"type":"array","title":"Sub Periods"}},"type":"object","required":["planet","start_date","end_date","sub_periods"],"title":"DashaPeriod"},"app__schemas__kundali__PlanetPosition":{"properties":{"planet":{"type":"string","title":"Planet"},"longitude":{"type":"number","exclusiveMaximum":360.0,"minimum":0.0,"title":"Longitude"},"latitude":{"type":"number","title":"Latitude"},"distance":{"type":"number","title":"Distance"},"speed":{"type":"number","title":"Speed"},"house":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"House"},"sign":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Sign"},"nakshatra":{"type":"integer","maximum":27.0,"minimum":1.0,"title":"Nakshatra"},"pada":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Pada"},"is_retrograde":{"type":"boolean","title":"Is Retrograde"},"dignity":{"type":"string","title":"Dignity"}},"type":"object","required":["planet","longitude","latitude","distance","speed","house","sign","nakshatra","pada","is_retrograde","dignity"],"title":"PlanetPosition"},"app__schemas__kundali__ShadbalaRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"include_breakdown":{"type":"boolean","title":"Include Breakdown","description":"Include detailed component breakdowns","default":true},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_details"],"title":"ShadbalaRequest","description":"Request model for Shadbala calculations.\n\nAttributes:\n birth_details: Birth details for calculation\n include_breakdown: Whether to include component breakdowns\n ayanamsa: Optional Parashari sidereal ayanamsa (default Lahiri)"},"app__schemas__kundali__ShadbalaResponse":{"properties":{"birth_details":{"$ref":"#/components/schemas/BirthDetails"},"planetary_shadbala":{"additionalProperties":{"$ref":"#/components/schemas/PlanetaryShadbala"},"type":"object","title":"Planetary Shadbala","description":"Shadbala data for each planet"},"strongest_planet":{"type":"string","title":"Strongest Planet","description":"Planet with highest strength ratio"},"weakest_planet":{"type":"string","title":"Weakest Planet","description":"Planet with lowest strength ratio"},"interpretation":{"type":"string","title":"Interpretation","description":"Overall Shadbala interpretation"},"system":{"type":"string","title":"System","description":"Named astrology engine id","default":"parashari"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Sidereal ayanamsa applied","default":"Lahiri"}},"type":"object","required":["birth_details","planetary_shadbala","strongest_planet","weakest_planet"],"title":"ShadbalaResponse","description":"Complete Shadbala response.\n\nAttributes:\n birth_details: Original birth details\n planetary_shadbala: Shadbala for each planet\n strongest_planet: Planet with highest Shadbala\n weakest_planet: Planet with lowest Shadbala\n interpretation: Overall interpretation"},"app__schemas__predictions__LifeAreaPrediction":{"properties":{"area":{"$ref":"#/components/schemas/LifeArea"},"score":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Score"},"trend":{"type":"string","title":"Trend"},"key_influences":{"items":{"type":"string"},"type":"array","title":"Key Influences"},"prediction_text":{"type":"string","title":"Prediction Text"},"advice":{"type":"string","title":"Advice"},"favorable_dates":{"items":{"type":"string","format":"date"},"type":"array","title":"Favorable Dates","default":[]},"challenging_dates":{"items":{"type":"string","format":"date"},"type":"array","title":"Challenging Dates","default":[]}},"type":"object","required":["area","score","trend","key_influences","prediction_text","advice"],"title":"LifeAreaPrediction","description":"Prediction for a specific life area."},"app__schemas__remedies__GemstoneRecommendation":{"properties":{"primary_gemstone":{"$ref":"#/components/schemas/GemstoneRemedy"},"secondary_gemstones":{"items":{"$ref":"#/components/schemas/GemstoneRemedy"},"type":"array","title":"Secondary Gemstones"},"gemstones_to_avoid":{"items":{"type":"string"},"type":"array","title":"Gemstones To Avoid"},"general_guidance":{"type":"string","title":"General Guidance"}},"type":"object","required":["primary_gemstone","secondary_gemstones","gemstones_to_avoid","general_guidance"],"title":"GemstoneRecommendation","description":"Complete gemstone recommendation set."},"app__schemas__remedies__Gender":{"type":"string","enum":["male","female","non_binary","prefer_not_to_say"],"title":"Gender","description":"Gender for remedy customization."},"app__schemas__sarvatobhadra__TransitEffect":{"properties":{"transit_date":{"type":"string","format":"date-time","title":"Transit Date"},"planet":{"type":"string","title":"Planet"},"natal_element":{"type":"string","title":"Natal Element"},"vedha_type":{"$ref":"#/components/schemas/VedhaType"},"is_benefic":{"type":"boolean","title":"Is Benefic"},"intensity":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Intensity"},"duration_days":{"type":"integer","title":"Duration Days"},"interpretation":{"type":"string","title":"Interpretation"}},"type":"object","required":["transit_date","planet","natal_element","vedha_type","is_benefic","intensity","duration_days","interpretation"],"title":"TransitEffect","description":"Transit effect through Sarvatobhadra"},"app__schemas__shadbala__ShadbalaRequest":{"properties":{"birth_details":{"$ref":"#/components/schemas/ShadbalaBirthDetails"},"ayanamsa":{"type":"string","title":"Ayanamsa","description":"Parashari sidereal ayanamsa (default Lahiri)"}},"type":"object","required":["birth_details"],"title":"ShadbalaRequest","description":"Request for Shadbala analysis."},"app__schemas__shadbala__ShadbalaResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"analysis":{"$ref":"#/components/schemas/ShadbalaAnalysis"}},"type":"object","required":["analysis"],"title":"ShadbalaResponse","description":"Complete Shadbala response."},"app__schemas__transit__TransitEffect":{"properties":{"planet":{"type":"string","title":"Planet","description":"Planet affected by the transit"},"transit_planet":{"type":"string","title":"Transit Planet","description":"Transiting planet"},"aspect_type":{"type":"string","title":"Aspect Type","description":"Type of aspect (conjunction, trine, etc.)"},"orb":{"type":"number","title":"Orb","description":"Orb of the aspect in degrees"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","description":"Strength of the transit effect"},"description":{"type":"string","title":"Description","description":"Description of the transit effect"},"is_beneficial":{"type":"boolean","title":"Is Beneficial","description":"Whether the transit is generally beneficial"},"nature":{"type":"string","title":"Nature","description":"beneficial, challenging or neutral"}},"type":"object","required":["planet","transit_planet","aspect_type","orb","strength","description","is_beneficial","nature"],"title":"TransitEffect","description":"Model for transit effects on a planet or house."},"app__schemas__varshaphal__LifeAreaPrediction":{"properties":{"area":{"type":"string","title":"Area"},"house_analyzed":{"type":"integer","title":"House Analyzed"},"significator":{"type":"string","title":"Significator"},"strength":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Strength"},"trend":{"type":"string","title":"Trend"},"key_periods":{"items":{"type":"string"},"type":"array","title":"Key Periods","default":[]},"opportunities":{"items":{"type":"string"},"type":"array","title":"Opportunities","default":[]},"challenges":{"items":{"type":"string"},"type":"array","title":"Challenges","default":[]},"advice":{"type":"string","title":"Advice"}},"type":"object","required":["area","house_analyzed","significator","strength","trend","advice"],"title":"LifeAreaPrediction","description":"Predictions for specific life areas"},"app__services__chart_export__ExportFormat":{"type":"string","enum":["pdf","svg","png","html"],"title":"ExportFormat","description":"Export file formats."},"DeveloperAccessProblem":{"type":"object","required":["type","title","status","detail","instance","request_id"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"request_id":{"type":"string"},"required_scope":{"type":"string"},"required_key_environment":{"type":"string"},"limit":{"type":"integer"},"retry_after":{"type":"integer"}}}},"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/auth/login"}}},"HTTPBearer":{"type":"http","scheme":"bearer"},"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"DeveloperApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Developer credential created at /api/console and sent only from a trusted backend. It is required on /v1/jyotisha. Usage is recorded for every request; free self-service limits are enforced. Billing remains disabled. Test keys are read-only."}},"responses":{"DeveloperApiKeyUnauthorized":{"description":"Missing, invalid, inactive, or expired developer API key.","headers":{"X-Request-ID":{"description":"Correlation identifier for support and logs.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/DeveloperAccessProblem"},"example":{"type":"https://api.ashwagosha.com/problems/missing-api-key","title":"API key required","status":401,"detail":"Missing, invalid, inactive, or expired developer API key.","instance":"/v1/operation","request_id":"4fd7c4f4d2e6470fb7d47a9c72dfe5bb"}}}},"DeveloperApiKeyInsufficientScope":{"description":"The developer API key does not grant the required service scope.","headers":{"X-Request-ID":{"description":"Correlation identifier for support and logs.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/DeveloperAccessProblem"},"example":{"type":"https://api.ashwagosha.com/problems/insufficient-api-key-scope","title":"Insufficient API key scope","status":403,"detail":"The developer API key does not grant the required service scope.","instance":"/v1/operation","request_id":"4fd7c4f4d2e6470fb7d47a9c72dfe5bb","required_scope":"jyotisha:read"}}}},"DeveloperAccessUnavailable":{"description":"Developer credential validation is temporarily unavailable; retry after the response delay.","headers":{"X-Request-ID":{"description":"Correlation identifier for support and logs.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/DeveloperAccessProblem"},"example":{"type":"https://api.ashwagosha.com/problems/developer-access-unavailable","title":"Developer access temporarily unavailable","status":503,"detail":"Developer credential validation is temporarily unavailable; retry after the response delay.","instance":"/v1/operation","request_id":"4fd7c4f4d2e6470fb7d47a9c72dfe5bb"}}}},"DeveloperLimitExceeded":{"description":"The API key exceeded its per-second request limit or the API consumer exhausted its monthly credit allowance. Inspect the problem type and Retry-After header.","headers":{"X-Request-ID":{"description":"Correlation identifier for support and logs.","schema":{"type":"string"}},"Retry-After":{"description":"Whole seconds before this key should retry.","schema":{"type":"integer","minimum":1}},"RateLimit":{"description":"Remaining requests and reset time for the per-key policy.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"The per-key request quota and one-second window.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/DeveloperAccessProblem"},"example":{"type":"https://api.ashwagosha.com/problems/rate-limit-exceeded","title":"Rate limit exceeded","status":429,"detail":"The API key exceeded its per-second request limit. Retry after the response delay.","instance":"/v1/operation","request_id":"4fd7c4f4d2e6470fb7d47a9c72dfe5bb","limit":5,"retry_after":1}}}}}},"tags":[{"name":"Geo","description":"Foundational location, calendar, chart, horoscope, and compatibility APIs. Group: Core Astrology."},{"name":"Panchang","description":"Foundational location, calendar, chart, horoscope, and compatibility APIs. Group: Core Astrology."},{"name":"Kundali","description":"Foundational location, calendar, chart, horoscope, and compatibility APIs. Group: Core Astrology."},{"name":"Horoscope","description":"Foundational location, calendar, chart, horoscope, and compatibility APIs. Group: Core Astrology."},{"name":"Compatibility","description":"Foundational location, calendar, chart, horoscope, and compatibility APIs. Group: Core Astrology."},{"name":"Muhurat","description":"Electional timing, festivals, planetary periods, transits, and astronomical events. Group: Timing & Calendar."},{"name":"Festivals","description":"Electional timing, festivals, planetary periods, transits, and astronomical events. Group: Timing & Calendar."},{"name":"Calendar","description":"Electional timing, festivals, planetary periods, transits, and astronomical events. Group: Timing & Calendar."},{"name":"Transit","description":"Electional timing, festivals, planetary periods, transits, and astronomical events. Group: Timing & Calendar."},{"name":"Dasha","description":"Electional timing, festivals, planetary periods, transits, and astronomical events. Group: Timing & Calendar."},{"name":"Astronomical","description":"Electional timing, festivals, planetary periods, transits, and astronomical events. Group: Timing & Calendar."},{"name":"Advanced","description":"Specialized Vedic calculation systems and advanced chart analysis. Group: Advanced Systems."},{"name":"Dosha","description":"Specialized Vedic calculation systems and advanced chart analysis. Group: Advanced Systems."},{"name":"Jaimini","description":"Specialized Vedic calculation systems and advanced chart analysis. Group: Advanced Systems."},{"name":"KP System","description":"Specialized Vedic calculation systems and advanced chart analysis. Group: Advanced Systems."},{"name":"Yogas","description":"Specialized Vedic calculation systems and advanced chart analysis. Group: Advanced Systems."},{"name":"Rectification","description":"Specialized Vedic calculation systems and advanced chart analysis. Group: Advanced Systems."},{"name":"Predictions","description":"Predictive, interpretive, life-pattern, and AI-assisted Jyotisha APIs. Group: Predictions & Insights."},{"name":"Prashna","description":"Predictive, interpretive, life-pattern, and AI-assisted Jyotisha APIs. Group: Predictions & Insights."},{"name":"Life Planning","description":"Predictive, interpretive, life-pattern, and AI-assisted Jyotisha APIs. Group: Predictions & Insights."},{"name":"Remedies","description":"Remedial guidance, samskara and shraddha knowledge, and naming APIs. Group: Remedies & Ritual Knowledge."},{"name":"Shraddha Service","description":"Remedial guidance, samskara and shraddha knowledge, and naming APIs. Group: Remedies & Ritual Knowledge."},{"name":"Life Samskaras","description":"Remedial guidance, samskara and shraddha knowledge, and naming APIs. Group: Remedies & Ritual Knowledge."},{"name":"Baby Names","description":"Remedial guidance, samskara and shraddha knowledge, and naming APIs. Group: Remedies & Ritual Knowledge."},{"name":"Moon Journal","description":"Saved preferences, journals, notifications, voice, and exported chart outputs. Group: Personalization & Output."},{"name":"Horoscope Preference","description":"Saved preferences, journals, notifications, voice, and exported chart outputs. Group: Personalization & Output."},{"name":"Voice","description":"Saved preferences, journals, notifications, voice, and exported chart outputs. Group: Personalization & Output."},{"name":"Web Push","description":"Saved preferences, journals, notifications, voice, and exported chart outputs. Group: Personalization & Output."},{"name":"Chart Export","description":"Saved preferences, journals, notifications, voice, and exported chart outputs. Group: Personalization & Output."},{"name":"User","description":"Account, plan, search, recommendation, community, and saved-content APIs. Group: Account & Discovery."},{"name":"Billing & Subscriptions","description":"Account, plan, search, recommendation, community, and saved-content APIs. Group: Account & Discovery."},{"name":"Search","description":"Account, plan, search, recommendation, community, and saved-content APIs. Group: Account & Discovery."},{"name":"Recommendations","description":"Account, plan, search, recommendation, community, and saved-content APIs. Group: Account & Discovery."},{"name":"Forum","description":"Account, plan, search, recommendation, community, and saved-content APIs. Group: Account & Discovery."},{"name":"Library Reader","description":"Account, plan, search, recommendation, community, and saved-content APIs. Group: Account & Discovery."},{"name":"Prashna Inquiries","description":"Account, plan, search, recommendation, community, and saved-content APIs. Group: Account & Discovery."}],"servers":[{"url":"/v1/jyotisha","description":"Gated developer API — X-API-Key required"}],"x-tagGroups":[{"name":"Core Astrology","description":"Foundational location, calendar, chart, horoscope, and compatibility APIs.","tags":["Geo","Panchang","Kundali","Horoscope","Compatibility"]},{"name":"Timing & Calendar","description":"Electional timing, festivals, planetary periods, transits, and astronomical events.","tags":["Muhurat","Festivals","Calendar","Transit","Dasha","Astronomical"]},{"name":"Advanced Systems","description":"Specialized Vedic calculation systems and advanced chart analysis.","tags":["Advanced","Dosha","Jaimini","KP System","Yogas","Rectification"]},{"name":"Predictions & Insights","description":"Predictive, interpretive, life-pattern, and AI-assisted Jyotisha APIs.","tags":["Predictions","Prashna","Life Planning"]},{"name":"Remedies & Ritual Knowledge","description":"Remedial guidance, samskara and shraddha knowledge, and naming APIs.","tags":["Remedies","Shraddha Service","Life Samskaras","Baby Names"]},{"name":"Personalization & Output","description":"Saved preferences, journals, notifications, voice, and exported chart outputs.","tags":["Moon Journal","Horoscope Preference","Voice","Web Push","Chart Export"]},{"name":"Account & Discovery","description":"Account, plan, search, recommendation, community, and saved-content APIs.","tags":["User","Billing & Subscriptions","Search","Recommendations","Forum","Library Reader","Prashna Inquiries"]}],"x-ashwagosha-readiness":{"published":"ready","excluded":["experimental","unavailable","internal"]},"x-ashwagosha-developer-access":{"mode":"gated","base_url":"/v1/jyotisha","header":"X-API-Key","scope_pattern":"jyotisha:read|jyotisha:write","quota_enforcement":"enforce_for_self_service","rate_limit_rollout":"off|warn|enforce","test_keys_are_read_only":true,"billing_enabled":false}}