ephemeris

Calculate essential dignities (granular)

Mechanical endpoint returning essential dignity scores for Sun..Pluto.

post/ephemeris/dignities

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/ephemeris/dignities
  • 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_systemstring

House system code used for day/night derivation when lat/lon provided

latitudenumber

Optional latitude used to derive day/night for triplicity (omit to default to day chart)

longitudenumber

Optional longitude used to derive day/night for triplicity (omit to default to day chart)

Example request

{
  "date_time": {
    "iso": "2025-12-11T12:00:00Z"
  },
  "latitude": 40.7128,
  "longitude": -74.006
}

Response

Dignities calculated successfully

is_day_chartboolean required

Day/night flag used for triplicity scoring

metadataobject required

Calculation metadata

successboolean

Calculation success status

Example response

{
  "dignities": [
    {
      "accidental_dignities": {
        "tags": [
          "angular"
        ]
      }
    }
  ]
}

Changes

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