Introduction
Welcome to the PlanetsXP API. Our RESTful API provides precise astrological and numerical calculations, giving you the building blocks to create powerful dating apps, daily horoscope widgets, and complex Jyotish platforms.
Authentication
The PlanetsXP API uses API keys to authenticate requests. You can view and manage your API keys in the Developer Dashboard.
Authentication to the API is performed via the HTTP Authorization header using the Bearer scheme.
Header Example
Authorization: Bearer pxp_live_YOUR_SECRET_KEYBase URL
All API requests should be made to the following base URL. We strictly enforce HTTPS.
https://api.planetsxp.com/v1
Standard JSON Request Format
For POST endpoints that require birth details, we use a standardized JSON payload across all our products (Vedic, KP, Lal Kitab) to make integration predictable.
| Parameter | Type | Description |
|---|---|---|
day |
Integer | Day of birth (1-31). |
month |
Integer | Month of birth (1-12). |
year |
Integer | Year of birth (e.g., 1990). |
hour |
Integer | Hour of birth in 24h format (0-23). |
min |
Integer | Minute of birth (0-59). |
lat |
Float | Latitude of birth location (e.g., 28.6139). |
lon |
Float | Longitude of birth location (e.g., 77.2090). |