Skip to content

Annual, Monthly and Daily Profections​

POST
/api/calc/profections

Annual profections: one whole sign per year of life from a natal place, with the ruler of the sign arrived at as the Lord of the Year, plus the monthly and daily subdivisions.

The year turns on the solar return, not on the calendar birthday — the Sun comes back to its natal degree up to a day either side, and a year that starts on the wrong day puts the wrong lord in charge at both ends. Each year in the window therefore costs one solar return to find its boundary, which is why years is capped at 30.

from chooses the place profected. The Ascendant is the standard and the default; Valens also profects the Moon, the Sun, the Lot of Fortune and the Midheaven, each answering a different question.

Authorizations​

ApiKeyAuth

API key for authentication. Get your API key from the dashboard.

Type
API Key (header: X-Api-Key)

Request Body​

application/json
JSON
{
  
"dateTime": "string",
  
"location": {
  
  
"longitude": 0,
  
  
"latitude": 0,
  
  
"timezone": "string"
  
},
  
"houseSystem": "placidus",
  
"from": "ascendant",
  
"startAge": 0,
  
"years": 1,
  
"includeMonths": true,
  
"includeDays": false,
  
"traditional": {
  
  
"sectMethod": "string",
  
  
"horizon": "string",
  
  
"reverseLotsByNight": true,
  
  
"lots": [
  
  
  
"string"
  
  
],
  
  
"bounds": "string",
  
  
"triplicity": "string",
  
  
"antisciaOrb": 0
  
}
}

Responses​

Profections over the requested window

application/vnd.api+json
JSON
{
  
"data": {
  
  
"from": "string",
  
  
"fromLongitude": 0,
  
  
"fromSign": "string",
  
  
"sect": "string",
  
  
"years": [
  
  
  
{
  
  
  
  
"level": "string",
  
  
  
  
"age": 0,
  
  
  
  
"index": 0,
  
  
  
  
"start": "string",
  
  
  
  
"end": "string",
  
  
  
  
"sign": "string",
  
  
  
  
"signsFromNatal": 0,
  
  
  
  
"house": 0,
  
  
  
  
"houseFromAscendant": 0,
  
  
  
  
"lord": "string",
  
  
  
  
"lordPosition": {
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
"sign": "string",
  
  
  
  
  
"house": 0,
  
  
  
  
  
"quadrantHouse": 0
  
  
  
  
},
  
  
  
  
"months": [
  
  
  
  
  
{
  
  
  
  
  
  
"level": "string",
  
  
  
  
  
  
"age": 0,
  
  
  
  
  
  
"index": 0,
  
  
  
  
  
  
"start": "string",
  
  
  
  
  
  
"end": "string",
  
  
  
  
  
  
"sign": "string",
  
  
  
  
  
  
"signsFromNatal": 0,
  
  
  
  
  
  
"house": 0,
  
  
  
  
  
  
"houseFromAscendant": 0,
  
  
  
  
  
  
"lord": "string",
  
  
  
  
  
  
"lordPosition": {
  
  
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
  
  
"sign": "string",
  
  
  
  
  
  
  
"house": 0,
  
  
  
  
  
  
  
"quadrantHouse": 0
  
  
  
  
  
  
},
  
  
  
  
  
  
"months": [
  
  
  
  
  
  
  
{
  
  
  
  
  
  
  
}
  
  
  
  
  
  
],
  
  
  
  
  
  
"days": [
  
  
  
  
  
  
  
{
  
  
  
  
  
  
  
}
  
  
  
  
  
  
]
  
  
  
  
  
}
  
  
  
  
],
  
  
  
  
"days": [
  
  
  
  
  
{
  
  
  
  
  
  
"level": "string",
  
  
  
  
  
  
"age": 0,
  
  
  
  
  
  
"index": 0,
  
  
  
  
  
  
"start": "string",
  
  
  
  
  
  
"end": "string",
  
  
  
  
  
  
"sign": "string",
  
  
  
  
  
  
"signsFromNatal": 0,
  
  
  
  
  
  
"house": 0,
  
  
  
  
  
  
"houseFromAscendant": 0,
  
  
  
  
  
  
"lord": "string",
  
  
  
  
  
  
"lordPosition": {
  
  
  
  
  
  
  
"longitude": 0,
  
  
  
  
  
  
  
"sign": "string",
  
  
  
  
  
  
  
"house": 0,
  
  
  
  
  
  
  
"quadrantHouse": 0
  
  
  
  
  
  
},
  
  
  
  
  
  
"months": [
  
  
  
  
  
  
  
{
  
  
  
  
  
  
  
}
  
  
  
  
  
  
],
  
  
  
  
  
  
"days": [
  
  
  
  
  
  
  
{
  
  
  
  
  
  
  
}
  
  
  
  
  
  
]
  
  
  
  
  
}
  
  
  
  
]
  
  
  
}
  
  
]
  
}
}

Playground​

Authorization
Body

Samples​

Powered by VitePress OpenAPI

AstroAPI Documentation