← All endpoints / Panchang

Occultations

GET/api/v1/panchang/occultations
GEThttps://vedintelastroapi.com/api/v1/panchang/occultations

Next time the Moon occults a planet, visible from a given location — first through fourth contact times. Starter plan and above.

Parameters

NameInRequiredTypeDescription
api_keyqueryYesstringYour VedIntel™ AstroAPI key. Get one at https://vedintelastroapi.com/auth/signupe.g. vai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
dobqueryYesstringDate of birth in DD/MM/YYYY formate.g. 01/10/1977
tobqueryYesstringTime of birth in HH:MM (24-hour) formate.g. 11:40
latqueryYesnumberBirth latitude with decimalse.g. 11
lonqueryYesnumberBirth longitude with decimalse.g. 77
tzqueryYesnumberTimezone offset from UTC. IST = 5.5e.g. 5.5
langqueryNostring
en | hi | ta | te | sa | kn | ml | bn …
default: en
Response language code. Use "auto" to detect from tz+lat.
ayanamsaqueryNostring
lahiri | raman | kp
default: lahiri
Ayanamsa system
datequeryNostringDate in DD/MM/YYYY format. Defaults to today.
planetqueryNostring
mercury | venus | mars | jupiter | saturn | uranus | neptune | pluto
default: mercury
Occulted planet. Default: mercury.

Example Request

curl -X GET "https://vedintelastroapi.com/api/v1/panchang/occultations?api_key=vai_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&dob=01%2F10%2F1977&tob=11%3A40&lat=11&lon=77&tz=5.5&lang=en&ayanamsa=lahiri&date=VALUE&planet=mercury" \
  -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "status": 200,
  "response": {
    "next_occultation": {
      "planet": "venus",
      "found": true,
      "visible_at_location": true,
      "first_contact": {
        "utc": "01:09:01",
        "unix": 293764142
      }
    }
  },
  "remaining_api_calls": 4998
}
← Back to all endpointsInteractive Docs
Get a free API key →