Morphemeris DocsDignities
GET /v1/dignities — Essential dignities, scores, and dispositorship chains for celestial bodies.
Dignities
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.
GET /v1/dignities
POST /v1/dignitiesCredit 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 | — | Whether this is a day chart (affects triplicity rulers) |
dispositors | boolean | No | false | Include dispositorship chains |
Response
{
"data": {
"dignities": [
{
"body": "sun",
"sign": "aries",
"dignity": "exaltation",
"debility": null,
"score": 4,
"peregrine": false
},
{
"body": "saturn",
"sign": "aries",
"dignity": null,
"debility": "fall",
"score": -4,
"peregrine": false
},
{
"body": "mercury",
"sign": "taurus",
"dignity": null,
"debility": null,
"score": 0,
"peregrine": true
}
],
"dispositors": {
"chains": {
"sun": ["mars"],
"moon": ["venus", "mars"],
"mercury": ["venus", "mars"]
},
"final_dispositor": "mars",
"mutual_receptions": []
}
},
"meta": { "..." }
}| Field | Type | Description |
|---|---|---|
dignities[].body | string | Body name |
dignities[].sign | string | Zodiac sign the body occupies |
dignities[].dignity | string or null | Essential dignity: "domicile", "exaltation", "triplicity", "term", or "face" |
dignities[].debility | string or null | Essential debility: "detriment" or "fall" |
dignities[].score | number | Numerical dignity score (positive = dignified, negative = debilitated) |
dignities[].peregrine | boolean | True if the body has no essential dignity or debility |
dispositors | object | Present when dispositors=true |
dispositors.chains | object | Each body's dispositorship chain (list of ruling bodies) |
dispositors.final_dispositor | string or null | Body that rules itself (if one exists) |
dispositors.mutual_receptions | array | Pairs of bodies in mutual reception |
Examples
Essential dignities with dispositorship
curl "https://api.morphemeris.com/v1/dignities?datetime=2024-03-20T12:00:00Z&dispositors=true" \
-H "Authorization: Bearer morphemeris_live_YOUR_KEY"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();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
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"