Birth Time Rectification¶
8 endpoint(s).
| Endpoint | Method | Summary | Auth |
|---|---|---|---|
/api/v1/btr/event-categories |
GET |
Get Event Category Summary | |
/api/v1/btr/event-dasha-match |
POST |
Match Events With Dasha | |
/api/v1/btr/lagna-traits/{lagna} |
GET |
Get Lagna Traits | |
/api/v1/btr/life-events |
GET |
Get All Life Events | |
/api/v1/btr/life-events/{category} |
GET |
Get Events By Category | |
/api/v1/btr/pranapada |
POST |
Full Pranapada | |
/api/v1/btr/validate |
POST |
Quick Validate | |
/api/v1/btr/verify |
POST |
Quick Validate |
GET /api/v1/btr/event-categories¶
Get Event Category Summary
Get summary of all event categories available for BTR.
Shows count of events in each category and their average validation weight.
Response 200 — VedicApiResponse
Example
curl -X GET 'https://api.example.com/api/v1/btr/event-categories' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/btr/event-dasha-match¶
Match Events With Dasha
Match life events with Dasha periods for birth time validation.
This is the MOST PRACTICAL method for BTR: - Provide known life events with dates - System calculates Dasha running at each event - Matches Dasha lords with expected event indicators - High match = birth time likely correct - Low match = birth time needs rectification
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
life_events |
array[LifeEventInput] |
yes | List of life events with dates |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/btr/event-dasha-match' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/v1/btr/lagna-traits/{lagna}¶
Get Lagna Traits
Get expected physical and personality traits for a Lagna (Ascendant).
Useful for validating birth time by comparing native's traits with classical descriptions.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
lagna |
path | string | yes |
Response 200 — VedicApiResponse
Example
curl -X GET 'https://api.example.com/api/v1/btr/lagna-traits/${lagna}' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/v1/btr/life-events¶
Get All Life Events
Get all 74 life events for Birth Time Rectification.
Events are categorized by life area (Marriage, Career, Children, etc.) with classical house/planet associations.
Response 200 — VedicApiResponse
Example
curl -X GET 'https://api.example.com/api/v1/btr/life-events' \
-H 'Authorization: Bearer <API_KEY>'
GET /api/v1/btr/life-events/{category}¶
Get Events By Category
Get life events for a specific category.
Valid categories: Marriage, Career, Children, Wealth, Health, Property, Education, Parents, Legal, Siblings, Accidents, Spiritual, Travel, Death, Inheritance, Theft, Reputation, etc.
| Param | In | Type | Required | Description |
|---|---|---|---|---|
category |
path | string | yes |
Response 200 — VedicApiResponse
Example
curl -X GET 'https://api.example.com/api/v1/btr/life-events/${category}' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/btr/pranapada¶
Full Pranapada
Full Pranapada calculation with detailed breakdown.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/btr/pranapada' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/btr/validate¶
Quick Validate
Quick birth time validation using Pranapada method.
Pranapada in houses 2, 4, 5, 9, 10, 11 from Ascendant indicates auspicious birth time. Other houses may indicate need for verification.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/btr/validate' \
-H 'Authorization: Bearer <API_KEY>'
POST /api/v1/btr/verify¶
Quick Validate
Quick birth time validation using Pranapada method.
Pranapada in houses 2, 4, 5, 9, 10, 11 from Ascendant indicates auspicious birth time. Other houses may indicate need for verification.
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
date |
string |
yes | Birth date in YYYY-MM-DD format |
time |
string |
yes | Birth time in HH:MM:SS format (24-hour) |
latitude |
number |
yes | Birth place latitude |
longitude |
number |
yes | Birth place longitude |
timezone |
string |
no | Timezone name (e.g., Asia/Kolkata) |
place_name |
any |
no | Birth place name for display |
name |
string |
yes | Native's name (required) |
email |
any |
no | Email (optional, for follow-ups) |
phone |
any |
no | Phone (optional, for WhatsApp follow-ups) |
current_location |
any |
no | Current location for muhurta calculations |
gender |
any |
no | Gender of native (male/female) |
marital_status |
any |
no | Current marital status |
marriage_date |
any |
no | Marriage date if married (YYYY-MM-DD) |
Response 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/btr/verify' \
-H 'Authorization: Bearer <API_KEY>'