Essential Dignities

GET

/reference/dignities

• Production

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

Authorizations

• ApiKeyAuth

Code Samples

cURL

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

Node.js

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);

Python

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

<?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']);

Responses

200

Successful calculation

object

ok

boolean

Example

true

data

object

items

Array<object>

object

sign

string

domicile

string

exaltation

string

exaltationDegree

number

detriment

string

fall

string

fallDegree

number

scores

object

domicile

number

exaltation

number

triplicity

number

term

number

face

number

detriment

number

fall

number

count

number

400

Validation error

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

Example

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