Ashwagosha APIs

Quickstart

Make your first API request

Use a read-only test key from a trusted backend. The complete key is shown once when it is created.

1. Create a test keyOpen the developer console and grant jyotisha:read.
2. Set the environment variableStore the key in your backend secret manager as ASHWAGOSHA_API_KEY.
3. Send the requestCall the gated endpoint and treat non-success responses as errors.

export ASHWAGOSHA_API_KEY='ag_test_<prefix>_<secret>'

curl --fail-with-body \
  --dump-header - \
  -H 'Accept: application/json' \
  -H "X-API-Key: ${ASHWAGOSHA_API_KEY}" \
  https://api.ashwagosha.com/v1/jyotisha/horoscope/rashi-profile/Simha

# pip install requests
import os
import requests

response = requests.get(
    "https://api.ashwagosha.com/v1/jyotisha/horoscope/rashi-profile/Simha",
    headers={
        "Accept": "application/json",
        "X-API-Key": os.environ["ASHWAGOSHA_API_KEY"],
    },
    timeout=15,
)
response.raise_for_status()
print("request_id=", response.headers.get("X-Request-ID"))
print("rate_limit=", response.headers.get("RateLimit"))
print(response.json())

const apiKey = process.env.ASHWAGOSHA_API_KEY;
if (!apiKey) throw new Error("ASHWAGOSHA_API_KEY is required");

const response = await fetch(
  "https://api.ashwagosha.com/v1/jyotisha/horoscope/rashi-profile/Simha",
  {
    headers: {
      "Accept": "application/json",
      "X-API-Key": apiKey,
    },
  },
);

if (!response.ok) {
  throw new Error(`${response.status} ${await response.text()}`);
}

console.log("request_id=", response.headers.get("x-request-id"));
console.log("rate_limit=", response.headers.get("ratelimit"));
console.log(await response.json());

Response excerpt

Selected fields are shown below. Use the Swagger response schema as the complete contract.

{
  "rashi": 5,
  "sign": "Simha",
  "lord": "Sun",
  "element": "Fire (Agni)",
  "lucky_day": "Sunday"
}

Headers to keep

Common errors

{
  "type": "https://api.ashwagosha.com/problems/missing-api-key",
  "title": "API key required",
  "status": 401,
  "detail": "Missing, invalid, inactive, or expired developer API key.",
  "instance": "/v1/jyotisha/horoscope/rashi-profile/Simha",
  "request_id": "4fd7c4f4d2e6470fb7d47a9c72dfe5bb"
}

Developer access

Manage your API key

API access is separate from webapp access. A verified identity can activate the free Developer plan immediately. No administrator approval is required. Manage the credential in the developer console.

Credential handling

• Store the key in a server-side secret manager or protected environment variable.
• Never place it in browser JavaScript, mobile or desktop bundles, source control, URLs, or logs.
• Update every backend instance immediately after rotation; the old key stops working at once.

API reference

Jyotisha API

Jyotisha is the only API currently published for third-party integrations. Review its operation groups below, then open the interactive reference or download the OpenAPI document.

Before production

API fundamentals

Apply these rules to every integration. Operation-specific details remain authoritative in the Swagger reference.

Authentication matrix

Plans and limits

Preview tiers

Credit schedule

Resources

Continue with the reference

Open the interactive contract, manage credentials, or contact the API team.