API Reference

Introduction

This reference contains the curated, versioned Jyotisha developer API. Use the grouped sidebar to browse operations and the Try this request panel to call the gated v1 routes.

How to use the APIs

Developer base URL: https://api.ashwagosha.com/v1/jyotisha.

Every documented operation requires X-API-Key. The interactive panel sends requests only to this v1 developer base.

Authentication: Protected operations require an Ashwagosha user JWT:

Header: Authorization: Bearer YOUR_TOKEN

Create a read-only test key at /api/console for interactive requests. Keep production credentials in a trusted backend. A developer key does not replace a user JWT when an operation requires both.

Guidelines

Credential errors: The gated facade returns 401 for a missing or invalid API key, 403 for a missing service scope, and retryable 503 when credential validation is unavailable.

Preview policy: Plan and credit values are informational warnings in this iteration. Billing and paid quota enforcement are disabled.

Application errors: Refer to each operation's documented response schema and status codes.

API groups

The same group metadata drives this overview, the sidebar, and the downloadable OpenAPI document.

Select an endpoint from the sidebar on the left.