Essential Dignities

GET

/reference/dignities

curl -X GET https://api.astroway.info/v1/reference/dignities \
  -H "Content-Type: application/json"

const res = await fetch('https://api.astroway.info/v1/reference/dignities', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
  },
});
const { ok, data, error } = await res.json();
if (!ok) throw new Error(error.message);
console.log(data);

import os, requests

r = requests.get(
    'https://api.astroway.info/v1/reference/dignities',
    headers={'Content-Type': 'application/json'},
)
result = r.json()
if not result['ok']:
    raise RuntimeError(result['error']['message'])
print(result['data'])

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->get('reference/dignities', [
]);
$result = json_decode($r->getBody(), true);
if (!$result['ok']) throw new \RuntimeException($result['error']['message']);
print_r($result['data']);

Classical (Ptolemy / Lilly) essential dignities table: domicile, exaltation degree, day/night/common triplicity rulers, detriment and fall, plus Lilly’s scoring weights.

Parameters

Query Parameters

fields

string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example

planets.name,planets.longitude

precision

integer

<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example

Responses

200

Successful calculation

application/json

object

boolean

data

object

items

Array<object>

nullable

object

sign

string

nullable

domicile

string

nullable

exaltation

string

nullable

exaltationDegree

number

nullable

triplicityDay

string

nullable

triplicityNight

string

nullable

triplicityCommon

string

nullable

detriment

string

nullable

fall

string

nullable

fallDegree

number

nullable

scores

object

domicile

number

nullable

exaltation

number

nullable

triplicity

number

nullable

term

number

nullable

face

number

nullable

detriment

number

nullable

fall

number

nullable

peregrine

number

nullable

count

number

nullable

Example

{
  "ok": true,
  "data": {
    "items": [
      {
        "sign": "Aries",
        "domicile": "Mars",
        "exaltation": "Sun",
        "exaltationDegree": 19,
        "triplicityDay": "Sun",
        "triplicityNight": "Jupiter",
        "triplicityCommon": "Saturn",
        "detriment": "Venus",
        "fall": "Saturn",
        "fallDegree": 21
      }
    ],
    "scores": {
      "domicile": 5,
      "exaltation": 4,
      "triplicity": 3,
      "term": 2,
      "face": 1,
      "detriment": -5,
      "fall": -4,
      "peregrine": 0
    },
    "count": 12
  }
}

400

Validation error

application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}

Was this helpful?