API Reference
Complete reference for all Morphemeris API endpoints.
API Reference
All endpoints are served from https://api.morphemeris.com/v1/ and support both GET and POST methods.
Every request requires an API key in the Authorization header.
Endpoints
| Endpoint | Description | Credit cost |
|---|---|---|
/v1/positions | Planetary positions (ecliptic or equatorial) | 1 |
/v1/houses | House cusps for any of 22 systems | 1 |
/v1/chart | Positions + houses combined | 1 |
/v1/stars | Fixed star positions | 1 or 5 |
/v1/ayanamsha | Sidereal ayanamsha values | 1 |
/v1/delta-t | Delta T (UT1 → TT correction) | 1 |
/v1/sidereal-time | Greenwich and local sidereal time | 1 |
Response envelope
All successful responses share a common envelope:
{
"data": { ... },
"meta": {
"version": "1.0-beta",
"request_id": "a1b2c3d4-e5f6-...",
"timestamp": "2024-03-20T12:00:00.123Z",
"credits_used": 1,
"credits_remaining": 999,
"computation_ms": 0.42
},
"warnings": []
}Time input
Every endpoint that computes for a moment in time accepts one of:
datetime— ISO 8601 UTC string (e.g.,2024-03-20T12:00:00Z)jd— Julian Day number in UT1 (e.g.,2460388.0)
Provide exactly one. If both are given, the API returns conflicting_parameters.
See Time Input for details on formats and conversion.