Error reference

All error codes

Every code the Grahvani API can return. Each links to the page named by the doc_url in the error itself — so a link we put on the wire always resolves.

Code	HTTP	Type	Meaning
`engine_rejected_input`	`400`	`invalid_request`	The computation refused the inputs
`invalid_horary_number`	`400`	`invalid_request`	Horary number outside 1–249
`invalid_moment`	`400`	`invalid_request`	The `moment` timestamp could not be parsed
`invalid_time`	`400`	`invalid_request`	Birth time is not `HH:MM:SS`
`invalid_timezone`	`400`	`invalid_request`	Timezone is not an IANA name
`key_not_found`	`400`	`invalid_request`	No such API key on this account
`last_active_key`	`400`	`invalid_request`	Refusing to revoke your only key
`missing_field`	`400`	`invalid_request`	A required input is absent
`too_many_keys`	`400`	`invalid_request`	Key limit reached for this account
`unknown_ayanamsa`	`400`	`invalid_request`	Not one of the supported schools
`unknown_plan`	`400`	`invalid_request`	No such plan
`unknown_varga`	`400`	`invalid_request`	Not a supported divisional chart
`invalid_api_key`	`401`	`authentication`	The key is not valid
`missing_api_key`	`401`	`authentication`	No API key was sent
`admin_only`	`403`	`permission`	That route needs an admin token
`quota_exhausted`	`429`	`quota`	Out of units for this period
`rate_limit_exceeded`	`429`	`rate_limit`	Too many requests per minute
`engine_error`	`500`	`internal`	The computation failed
`unknown_operation`	`500`	`internal`	Route mapped to an operation we cannot serve
`not_available_in_school`	`501`	`not_implemented`	Real operation, absent in that ayanāṁśa
`not_implemented`	`501`	`not_implemented`	Not implemented
`engine_unavailable`	`503`	`internal`	The computation service is unreachable

The narrative — retry policy, why 501 is not 404, why we never silently fall back to another ayanāṁśa — is in the error handling guide.

Introduction API reference Errors OpenAPI spec llms.txt

Grahvani API — a product of AstroCorp Techlab Pvt Ltd · GSTIN 36AAMCC3512G1ZU

Base URL https://api.grahvani.in