Almuten Figuris

POST

/almuten

request.sh

curl -X POST https://api.astroway.info/v1/almuten \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }'

▸ Спробувати POST /almuten

• Production

Calculate the Almuten Figuris — the planet with the highest essential dignity score across the key chart positions.

Authorizations

• ApiKeyAuth

Request Body ^required

Media type application/json

Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss). Defaults to lat/lon/tz=0 if omitted; pass real values for accurate computation.

object

date required

string

/^\d{4}-\d{2}-\d{2}$/

time required

string

/^\d{2}:\d{2}:\d{2}$/

timezoneOffset

number

0 nullable

latitude

number

0 nullable

longitude

number

0 nullable

houseSystem

string

default: P

name

string

""

city

string

""

zodiacType

string

Allowed values: tropical sidereal

ayanamsaId

number

nullable

cosmogram

boolean

key additional

nullable

Example

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

almuten

object

planet

string

nullable

score

number

nullable

scores

object

Sun

number

nullable

Moon

number

nullable

Mercury

number

nullable

Venus

number

nullable

Mars

number

nullable

Jupiter

number

nullable

Saturn

number

nullable

chart

object

planets

Array

nullable

houses

object

ascendant

number

nullable

cusps

Array

nullable

Example

{
  "ok": true
}

400

Validation error

Media type 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

Media type application/json

Example

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