Skip to content
AstroWay/api v2.325.0 · docs
all systems operational

Prashna: number to sign

POST
/vedic/prashna/number
request.sh
curl -X POST https://api.astroway.info/v1/vedic/prashna/number \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{ "system": "navamsa108", "number": 45 }'

A querent’s number read as a sign. system navamsa108 (default): 1-108 as the navamsas from 0 Aries, the sign and its navamsa. ashtamangala: the three-digit Prasna Marga number (digits 1-8) with each digit’s planet and parity and the tithi, nakshatra, weekday, rasi and bhuta from its remainders. Numbers above 108 point at /vedic/kp/horary (KP 1-249).

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
4
Idempotency-Key
string
>= 1 characters <= 255 characters /^[\x21-\x7E]+$/

Unique per logical operation, kept across retries. For 24 hours from the first request, a repeat with the same key, method, path, body and query string returns the stored response with Idempotent-Replayed: true and costs 0 credits. The same key with a different body or query string is a 409 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running is a 409 IDEMPOTENCY_IN_PROGRESS. Only 2xx responses are kept. See /idempotency/.

Example
01HXY2A7ZM0ABCDEF
Media type application/json

A number given by the querent and the system to read it in.

object
system

Navamsa108 (default): a number 1-108 read as the navamsas of the zodiac from 0 Aries. ashtamangala: the three-digit Prasna Marga number, each digit 1-8. KP numbers 1-249 are /v1/vedic/kp/horary.

string
default: navamsa108
Allowed values: navamsa108 ashtamangala
number required
integer
>= 1 <= 888
Example
{
"system": "navamsa108",
"number": 45
}

Successful calculation

Media type application/json
object
ok
boolean
data
object
system
string
nullable
number
number
nullable
sign
number
nullable
signName
string
nullable
navamsaInSign
number
nullable
navamsaSign
number
nullable
navamsaSignName
string
nullable
span
object
start
number
nullable
end
number
nullable
arudha
string
nullable
kpNumbers
string
nullable
sources
object
navamsa108
object
text
string
nullable
ref
string
nullable
status
string
nullable
Example
{
"ok": true,
"data": {
"system": "navamsa108",
"number": 45,
"sign": 4,
"signName": "Leo",
"navamsaInSign": 9,
"navamsaSign": 8,
"navamsaSignName": "Sagittarius",
"span": {
"start": 146.6667,
"end": 150
},
"arudha": "send this number as the number field of /v1/vedic/prashna/chart to cast the chart with this Arudha",
"kpNumbers": "/v1/vedic/kp/horary",
"sources": {
"navamsa108": {
"text": "Kerala practice; worked example (number 45 is Leo, Sagittarius navamsa) in Zenodo record 6569610",
"ref": "not in Prasna Marga Part I, which uses the Ashtamangala number",
"status": "secondary"
}
}
}
}

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"
}
]
}
}

Missing or invalid API key

Media type application/json
Example
{
"ok": false,
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid API key"
}
}