Getting Started

Getting Started

Everything you need to start using the AstroYantra API

Quick start

First request in a few lines

Authenticate with a bearer token, hit the base URL, and send structured JSON. The examples below mirror the rest of the docs console.

JavaScript example
Minimal authenticated request for a data endpoint.
fetch('https://services.siyoltechnologies.com/api/astronomy/planetary-positions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    date: '2026-03-11',
    time: '12:30:00',
    latitude: 28.6139,
    longitude: 77.2090
  })
});

Authentication

Most endpoints require `Authorization: Bearer YOUR_API_KEY`.

Generate an API key

Base URL

https://services.siyoltechnologies.com

All responses are JSON. Keep a single base URL in your client and swap only the endpoint path.

Operational limits and errors

Use these as the baseline behaviors when building retries, quotas, and UI messaging.

400
Bad Request
Invalid parameters or malformed date/time values.
401
Unauthorized
Missing or invalid bearer token.
402
Payment Required
Monthly quota has been exhausted.
429
Rate Limited
Too many requests in a short time window.
500
Server Error
Unexpected processing failure on the API side.

Endpoints

GET/api/astronomy/zodiac-signs

List Zodiac Signs

Returns all 12 zodiac signs. No authentication required - great for testing.

JSON
{
  "signs": [
    "Aries",
    "Taurus",
    "Gemini",
    "Cancer",
    "Leo",
    "Virgo",
    "Libra",
    "Scorpio",
    "Sagittarius",
    "Capricorn",
    "Aquarius",
    "Pisces"
  ]
}
GET/api/astronomy/planets

List Planets

Returns all planets used in Vedic astrology. Free endpoint.

JSON
{
  "planets": [
    "Sun",
    "Moon",
    "Mercury",
    "Venus",
    "Mars",
    "Jupiter",
    "Saturn",
    "Rahu",
    "Ketu"
  ]
}