☰ DiAstrologer API Docs

Timing Predictions

3 endpoint(s).

Endpoint Method Summary Auth
/api/v1/timing/categories GET Get Event Categories
/api/v1/timing/events GET Get Available Events
/api/v1/timing/predict POST Predict Event Timing

GET /api/v1/timing/categories

Get Event Categories

Get list of event categories available for timing prediction.

Response 200 — VedicApiResponse

Example

curl -X GET 'https://api.example.com/api/v1/timing/categories' \
  -H 'Authorization: Bearer <API_KEY>'

GET /api/v1/timing/events

Get Available Events

Get list of available event types for timing prediction.

Optional: Filter by category (Marriage, Career, etc.)

Param In Type Required Description
category query any no

Response 200 — VedicApiResponse

Example

curl -X GET 'https://api.example.com/api/v1/timing/events' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/timing/predict

Predict Event Timing

Predict when a life event is likely to occur.

Analyzes: - Current and upcoming Vimshottari Dasha periods - Transit conditions for relevant planets - Classical timing rules from Parashari Jyotish

Event Categories: - Marriage: First marriage, meeting partner, engagement - Career: Job change, promotion, business start - Children: Conception, birth, adoption - Wealth: Inheritance, gains, property - Health: Major illness, recovery, surgery - Education: Higher education, certification - Travel: Foreign travel, relocation

Request body (application/json)

Field Type Required Description
date string yes Birth date (YYYY-MM-DD)
time string yes Birth time (HH:MM:SS)
latitude number yes
longitude number yes
timezone string yes IANA timezone
event_category string yes Category: Marriage, Career, Children, etc.
event_code any no Specific event code (optional)
years_ahead integer no Years to predict ahead
gender any no Gender of native (male/female)
marital_status any no Marital status (unmarried/married/divorced/widowed/minor)
marriage_date any no Marriage date if married (YYYY-MM-DD)

Response 200 — VedicApiResponse

Example

curl -X POST 'https://api.example.com/api/v1/timing/predict' \
  -H 'Authorization: Bearer <API_KEY>'