GET /v1/dignities — Essential dignities, scores, and dispositorship chains for celestial bodies.

Dignities

Compute essential dignities for celestial bodies at a given moment. For a chart, dignities=true on /v1/natal-chart (and the synastry, Davison, progressed, and return charts) attaches the same records at no extra cost, with the sect found from the chart itself.

Compute essential dignities for celestial bodies at a given moment. Returns the dignity or debility status, a numerical score, peregrine detection, and optionally the full dispositorship chain.

Text

GET  /v1/dignities
POST /v1/dignities

Credit cost: 1

Parameters

Parameter	Type	Required	Default	Description
`datetime`	string	One of `datetime` or `jd`	—	ISO 8601 UTC datetime
`jd`	number	One of `datetime` or `jd`	—	Julian Day in UT1
`bodies`	string	No	`"planets"`	Comma-separated body names
`sidereal`	string	No	—	Ayanamsha for sidereal mode
`rulership`	string	No	`"traditional"`	`"traditional"` or `"modern"`
`day_chart`	boolean	No	—	`true` assesses the day triplicity ruler, `false` the night one. Omitted, no triplicity is assessed: the endpoint has no location, so it cannot find the sect itself
`dispositors`	boolean	No	`false`	Include dispositorship chains

Response

JSON

{
  "data": {
    "dignities": [
      {
        "body": "sun",
        "sign": "capricorn",
        "sign_degree": 24.819,
        "domicile_ruler": "saturn",
        "in_domicile": false,
        "in_detriment": false,
        "exaltation_ruler": "mars",
        "exaltation_degree": 28.0,
        "in_exaltation": false,
        "in_fall": false,
        "triplicity_ruler": null,
        "in_triplicity": false,
        "term_ruler": "saturn",
        "in_term": false,
        "face_ruler": "sun",
        "in_face": true,
        "peregrine": false,
        "score": 1
      }
    ],
    "dispositors": {
      "chains": [
        [
          { "body": "sun", "sign": "capricorn", "dispositor": "saturn" },
          { "body": "saturn", "sign": "pisces", "dispositor": "jupiter" },
          { "body": "jupiter", "sign": "taurus", "dispositor": "venus" },
          { "body": "venus", "sign": "sagittarius", "dispositor": "jupiter" },
          { "body": "jupiter", "sign": "taurus", "dispositor": "venus" }
        ]
      ],
      "mutual_receptions": [
        { "body_a": "venus", "sign_a": "sagittarius", "body_b": "jupiter", "sign_b": "taurus" }
      ],
      "final_dispositors": []
    }
  },
  "meta": { "..." }
}

Field	Type	Description
`dignities[].body`, `sign`, `sign_degree`		The body and where it is (sidereal sign and degree when `sidereal` is set)
`dignities[].domicile_ruler`, `in_domicile`, `in_detriment`		The sign's ruler under the chosen rulership; whether the body is it, or the ruler of the opposite sign
`dignities[].exaltation_ruler`, `exaltation_degree`, `in_exaltation`, `in_fall`		The planet exalted in this sign and the degree of its exaltation (`null` for the four signs with none); whether the body is it, or is exalted in the opposite sign
`dignities[].triplicity_ruler`, `in_triplicity`		The day or night ruler of the sign's element, per `day_chart`; `null` and `false` when `day_chart` is omitted
`dignities[].term_ruler`, `in_term`		The ruler of the Egyptian term (bound) the degree falls in
`dignities[].face_ruler`, `in_face`		The ruler of the face (decan) the degree falls in
`dignities[].peregrine`	boolean	No dignity and no debility at all
`dignities[].score`	integer	Lilly's score: +5 domicile, +4 exaltation, +3 triplicity, +2 term, +1 face, −5 detriment, −4 fall, −5 peregrine, summed
`dispositors`	object	Present when `dispositors=true`
`dispositors.chains[]`	array	One chain per body, in body order. Each link is a body, the sign it occupies, and that sign's ruler. A chain ends at a body in its own sign (a final dispositor), or, in a cycle, on the link that repeats its first body, or when the ruler is not among the requested bodies
`dispositors.mutual_receptions[]`	array	Pairs of bodies each in the other's domicile
`dispositors.final_dispositors[]`	array	Every body in its own domicile

Which tables

The rulers and exaltations are Ptolemy's (Tetrabiblos I.17–19), with Lilly's exaltation degrees (Sun 19° Aries, Moon 3° Taurus, Mercury 15° Virgo, Venus 27° Pisces, Mars 28° Capricorn, Jupiter 15° Cancer, Saturn 21° Libra, the North Node 3° Gemini). The triplicity rulers are Lilly's two-ruler table (Christian Astrology p. 104): Sun by day and Jupiter by night for fire, Venus and the Moon for earth, Saturn and Mercury for air, Mars by day and by night for water — not the three-ruler Dorothean scheme. The terms are the Egyptian terms as Ptolemy reports them (Tetrabiblos I.21), not Ptolemy's own; the faces follow the Chaldean order from Mars in the first face of Aries. Scores are Lilly's. The test suite holds every record to these tables at sixteen instants across a century, by day and by night.

Examples

Essential dignities with dispositorship

Bash

curl "https://api.morphemeris.com/v1/dignities?datetime=2024-03-20T12:00:00Z&dispositors=true" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

javascript

const res = await fetch(
  "https://api.morphemeris.com/v1/dignities?datetime=2024-03-20T12:00:00Z&dispositors=true",
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const { data } = await res.json();

Python

import requests

res = requests.get(
    "https://api.morphemeris.com/v1/dignities",
    params={"datetime": "2024-03-20T12:00:00Z", "dispositors": "true"},
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

Modern rulership for a day chart

Bash

curl "https://api.morphemeris.com/v1/dignities?datetime=1990-06-15T18:30:00Z&rulership=modern&day_chart=true" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

Dignities

Dignities

Parameters

Response

Which tables

Examples

Essential dignities with dispositorship

Modern rulership for a day chart

On this page