API Endpoints Reference
Complete reference for all Meridian Ephemeris API endpoints.
Base URL
https://api.astromcp.io
Authentication
Most endpoints (except basic health checks) require authentication via JWT or API key. Some metadata endpoints may require authentication depending on deployment.
Authorization: Bearer YOUR_JWT_TOKEN
X-API-Key: YOUR_API_KEY
Quick Reference
| Endpoint | Method | Purpose |
|----------|--------|---------|
| /ephemeris/natal-chart | POST | Enhanced natal chart payload |
| /ephemeris/venus-star-points | POST | Venus Star Points (VSP) natal cycle |
| /comparative/composite | POST | Calculate composite chart |
| /comparative/synastry | POST | Calculate synastry (inter-aspects) |
| /comparative/natal-transits | POST | Natal vs Transits overlay |
| /predictive/transits/planet-to-degree | POST | Find exact transit timing |
| /location/autocomplete | GET | Search for locations |
| /timezone/lookup | POST | Resolve IANA timezone from coordinates |
| /timezone/offset | POST | Get UTC offset at datetime (DST-aware) |
| /meta/openapi.json | GET | OpenAPI specification |
| /meta/version | GET | API version info |
| /health | GET | Health check (public) |
Detailed Endpoint Pages
- Natal Charts
- Standalone Calculations
- Progressed Charts
- Relocation
- Batch Utilities
- Predictive
- Transits
- Venus Cycle Suite
- Returns
- Location
- Visualization
- Metadata & Utilities
Timezone (Summary)
POST /timezone/lookup
POST /timezone/lookup
{
"latitude": { "decimal": 40.7128 },
"longitude": { "decimal": -74.0060 }
}
POST /timezone/offset
POST /timezone/offset
{
"latitude": { "decimal": 40.7128 },
"longitude": { "decimal": -74.0060 },
"datetime": { "iso": "2024-06-15T12:00:00Z" }
}