ephemeris

Calculate house cusps (granular)

Mechanical endpoint returning house cusps for up to 5 house systems.

post/ephemeris/house-cusps

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/ephemeris/house-cusps
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Query parameters

output_modestring nullable

Deprecated: use preset+format. Accepts full|simple|llm.

formatstring

Headers

authorizationstring nullable
X-API-Keystring nullable
X-OpenEphemeris-API-Keystring nullable
apikeystring nullable

Request body

house_systemsstring[]

House system codes to compute (1-5 entries)

latitudenumber required

Observer latitude in decimal degrees

longitudenumber required

Observer longitude in decimal degrees

Example request

{
  "date_time": {
    "iso": "2025-12-11T12:00:00Z"
  },
  "house_systems": [
    "P",
    "W"
  ],
  "latitude": 40.7128,
  "longitude": -74.006
}

Response

House cusps calculated successfully

metadataobject required

Calculation metadata

successboolean

Calculation success status

Changes

No recorded changes to this operation across all 1 revision of this API.