Ayurveda API

Ship a cited Ayurveda feature, not another dosha quiz.

DoshaAyurvedic ConstitutionDinacharyaBrahma MuhurtaRitucharya …and so much more

99.95%+uptime

Start building in seconds.

Want to try without writing code? Try this domain live in API playground →

Terminal
npm install @roxyapi/sdk
import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.ayurveda.get(/* ... */)
SDK docs

Want to ship faster? Clone a free template and go from zero to production in 30 minutes.

Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.

Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.

POST /api/v2/ayurveda/constitution
{
  "frame": {
    "ayanamsa": "lahiri",
    "ayanamsaDegrees": 23.72820922463809
  },
  "lagnaSign": "leo",
  "moonSign": "scorpio",
  "factors": [
    {
      "id": "lagna-sign",
      "input": "leo",
      "doshas": [
        "pitta"
      ],
      "weight": 2,
      "source": {
        "text": "Brihat Jataka",
        "chapter": "18",
        "verse": "note to 20, the Satyacharya extract",
        "translation": "N. Chidambaram Iyer",
        "year": 1885,
        "publicDomain": true,
        "note": "Chapter 18, not 19: the running head on the printed pages reads CH. 19 while the chapter opening precedes the list and chapter 19 begins after the Pisces entry, in two independent scans and in the Rao translation. It is an appended authority the translator credits to Satyacharya, never a verse of Varahamihira. All twelve rows agree across both translations; the two translations order the pair of humour words differently in seven rows, which carries no weight because the sets are identical."
      }
    },
    {
      "id": "moon-sign",
      "input": "scorpio",
      "doshas": [
        "pitta"
      ],
      "weight": 1,
      "source": {
        "text": "Brihat Jataka",
        "chapter": "18",
        "verse": "20",
        "translation": "N. Chidambaram Iyer",
        "year": 1885,
        "publicDomain": true,
        "note": "The verse expressly equates the effects of a sign occupied by the Moon with the effects of the same sign rising, which is what licenses reading the rising-sign table across to the Moon. The humours themselves come from whichever sign table the signDoshaScheme convention names, so this citation covers the read-across and not the table. Hora Sara chapter 29 states a bodily temperament from the Moon sign directly and is cited by reference only, because no public-domain English of it exists."
      }
    },
    {
      "id": "strongest-planet",
      "input": "Mars Sun Moon",
      "doshas": [
        "vata",
        "pitta",
        "kapha"
      ],
      "weight": 2,
      "source": {
        "text": "Saravali",
        "chapter": "38",
        "verse": "5",
        "translation": "R. Santhanam",
        "year": 1983,
        "publicDomain": false,
        "note": "Referenced, never quoted: no public-domain English exists. Three limits ride with it. The verse names only the five non-luminaries while shadbala ranks seven grahas; it says strengths rather than shadbala, so the choice of metric is ours; and its own frame is the five mahabhutas, with the humours named after them. The blend it licenses is what the composite share split rests on."
      }
    }
  ],
  "composite": {
    "vata": 7,
    "pitta": 87,
    "kapha": 6,
    "dominant": "pitta",
    "secondary": "vata",
    "type": "pitta",
    "convention": "roxyapi/v1",
    "weighting": {
      "lagnaSign": 2,
      "moonSign": 1,
      "strongestPlanet": 2,
      "strongPlanetThreshold": 0.9,
      "dualTypeMargin": 10
    }
  },
  "strengthRanking": [
    {
      "graha": "Mars",
      "totalVirupas": 525.53,
      "rank": 1,
      "strong": true
    },
    {
      "graha": "Sun",
      "totalVirupas": 521.16,
      "rank": 2,
      "strong": true
    },
    {
      "graha": "Moon",
      "totalVirupas": 511.89,
      "rank": 3,
      "strong": true
    }
  ],
  "planetDoshas": [
    {
      "graha": "Sun",
      "sanskritName": "sūrya",
      "doshas": [
        "pitta"
      ],
      "dhatu": "bone",
      "dhatuSanskrit": "asthi",
      "doshaSource": {
        "text": "Brihat Jataka",
        "chapter": "2",
        "verse": "8 to 11",
        "translation": "N. Chidambaram Iyer",
        "year": 1885,
        "publicDomain": true,
        "note": "Confirmed row for row against the independent B. Suryanarain Rao translation. The Moon and Venus rows read vata before kapha in BOTH translations, which is the reading widely circulated material diverges from. The verses cover the seven grahas only, so Rahu and Ketu carry no humour here and none is supplied."
      },
      "dhatuSource": {
        "text": "Brihat Jataka",
        "chapter": "2",
        "verse": "11",
        "translation": "N. Chidambaram Iyer",
        "year": 1885,
        "publicDomain": true,
        "note": "The two translations disagree on two of the seven rows. Saturn is snayu, which is attested as sinew, tendon, muscle and nerve alike, so the Sanskrit ships and no English is chosen; Iyer reads muscles and Rao reads nerves. These seven are not the sapta-dhatu set and must not be joined to one."
      }
    },
    {
      "graha": "Moon",
      "sanskritName": "candra",
      "doshas": [
        "vata",
        "kapha"
      ],
      "dhatu": "blood",
      "dhatuSanskrit": "rakta",
      "doshaSource": {
        "text": "Brihat Jataka",
        "chapter": "2",
        "verse": "8 to 11",
        "translation": "N. Chidambaram Iyer",
        "year": 1885,
        "publicDomain": true,
        "note": "Confirmed row for row against the independent B. Suryanarain Rao translation. The Moon and Venus rows read vata before kapha in BOTH translations, which is the reading widely circulated material diverges from. The verses cover the seven grahas only, so Rahu and Ketu carry no humour here and none is supplied."
      },
      "dhatuSource": {
        "text": "Brihat Jataka",
        "chapter": "2",
        "verse": "11",
        "translation": "N. Chidambaram Iyer",
        "year": 1885,
        "publicDomain": true,
        "note": "The two translations disagree on two of the seven rows. Saturn is snayu, which is attested as sinew, tendon, muscle and nerve alike, so the Sanskrit ships and no English is chosen; Iyer reads muscles and Rao reads nerves. These seven are not the sapta-dhatu set and must not be joined to one."
      }
    }
  ],
  "summary": "The chart reads pitta, and pitta carries the largest share of it at 87 percent. Several grahas share the strength in this chart, so the reading is a blend rather than one humour, which is what the classical rule on several strong planets allows. The reading is built from three cited factors: the rising sign, the sign the Moon occupies, and the strongest graha by shadbala. The weights across those factors are a RoxyAPI convention and are published in this response, because the primary texts give the factors and never the weighting.",
  "conventions": {
    "signDoshaScheme": "satyacharya",
    "ayanamsa": "lahiri"
  },
  "meta": {
    "disclaimer": "For general wellness and cultural interest only. This is not medical advice, and it is unrelated to the diagnosis, cure, mitigation, prevention or treatment of any disease or condition. Consult a qualified professional."
  }
}

Structured JSON with documented fields. Not hallucinated text. See all endpoints

Works with your stack

Claude CodeCursorAntigravityChatGPTWindsurfVS Code CopilotOpenAI AgentsGeminiLangChainCrewAIVercel AI SDK

Ayurveda API for dosha profiles, the dinacharya daily routine and the ritucharya seasonal regimen, with a verse cited on every value. Read the vata, pitta and kapha constitution from a verified sidereal birth chart, compute brahma muhurta and the six dosha periods from the real sunrise at any location, resolve the Ayurvedic season from actual solar ingress instants under two published conventions, and serve the catalogue of three doshas, fifteen sub-doshas, six tastes and twenty qualities straight from the primary texts. Deterministic, cacheable and localized. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.

Every Ayurveda calculation is covered by 11,693 automated tests per deploy, 2,801 of them gold-standard tests locked to named external references such as NASA JPL Horizons, with a public MIT benchmark repo anyone can clone and re-run. See how we test.

Multi-language API responses

EnglishDeutschEspanolFrancaisHindiPortuguesRusskiyTurkce

Key Features

Everything you need from our Ayurveda API, built for production:

Constitution read from a verified sidereal birth chart rather than from a quiz, scoring the three factors that carry a classical rule: the rising sign, the sign the Moon occupies, and the strongest graha by shadbala, each returned with the chapter and verse behind it

Brahma muhurta and the six dosha periods computed from the real sunrise at the place the caller sends, which a fixed clock grid gets wrong everywhere except an equinox near the equator

Two dosha-period conventions returned side by side: the sunrise-anchored thirds the frame chapter states, and the modern clock grid labelled as modern, so a product can show one and reconcile against the other

Ayurvedic season resolved from actual solar ingress instants, in either the tropical reckoning published almanacs use or the sidereal one that runs about 24 days later, with the choice echoed in every response

Two classical sign tables offered as a typed convention, because they agree exactly on only three signs of twelve and share no humour at all on two of them

The catalogue from the primary texts: three doshas, fifteen sub-doshas with seat and function, six tastes with the complete eighteen-cell dosha matrix, and twenty qualities as ten opposed pairs each with its action word

Every recorded disagreement between the source texts is stated in the response rather than resolved silently, including the one that decides which dosha a quality pair joins to

Framed throughout for general wellness and cultural interest, with the scope stated in every response in the language it was requested in

All 8 Endpoints

Every one is live in the public OpenAPI spec and callable as an MCP tool. Click any endpoint to view detailed documentation, parameters, and response examples.

Ayurvedic constitution from a birth chart - Dosha profile APIRead the Ayurvedic constitution from a sidereal birth chart and return the vata, pitta and kapha shares with a verse behind every factor. Three factors are scored, each one carrying a classical rule that it shows the native humour: the rising sign, the sign the Moon occupies, and the strongest graha by shadbala. The composite that blends them is a RoxyAPI convention rather than a classical one, so its version and its weights ship inside the response, and every response states that this is general wellness and cultural interest only.Dinacharya daily routine - Brahma muhurta and dosha clock APICompute the dinacharya daily routine for one date and one place: sunrise, sunset, the brahma muhurta window, and the six dosha periods of the day and the night. The default division cuts the actual day and the actual night into thirds, which is what the frame chapter states, and the modern clock grid is returned alongside it under its own label so a caller can show either. The brahma muhurta is a fixed window of 96 to 48 minutes before sunrise rather than a share of the night, which is the reading the classical commentary settles on.Ayurveda seasonal regimen - Ritucharya and ritu resolution APIResolve the ritucharya, the Ayurvedic season, for a date from the real solar ingress instants and return the regimen the primary text gives for it. The response carries the season with its exact opening and closing instants, the half of the year the sun is in, where each dosha stands in the seasonal cycle, the taste that grows across the season, and the behaviour items the chapter states. Season boundaries are measured in the tropical zodiac by default, which is what published almanacs use, and the sidereal reading is available as a convention and runs about 24 days later.Daily Ayurveda reading - Dosha clock and brahma muhurta by location APIGet one days Ayurveda reading for a place: sunrise, the brahma muhurta window, the six dosha periods cut from the actual day and night, and the season the date falls in with where each dosha stands in its yearly cycle. It composes the routine and the season routes for one location so a widget needs one call rather than two. The default conventions apply throughout and are echoed; call those two routes directly to choose a different season scheme, zodiac, hemisphere or dosha clock.List the three doshas - Dosha catalogue APIReturn vata, pitta and kapha with the qualities, seats and five sub-doshas each carries, and the three states the seasonal cycle moves them through. Every quality is one of the twenty gunas and every state is described as a position and a quality rather than as a complaint, which is what lets the catalogue join to the tastes and qualities endpoints without a lookup table in between. Each entry carries the verse it comes from, and the second primary text is recorded where it reads the list differently.Get one dosha - Vata pitta kapha profile APIReturn one dosha with its elements, qualities, seats, five sub-doshas and three states. Use it to render a dosha card or a glossary entry without pulling the whole catalogue, and read qualityGunas to join it to the twenty qualities.List the six tastes - Ayurveda rasa and dosha matrix APIReturn the six rasas, the tastes of Ayurveda, with the complete eighteen-cell matrix of which taste lowers and raises which dosha, in both directions. The order is the one the root verse gives, which is also the order of strength it states, and it puts bitter before pungent where most modern lists reverse them. The matrix is returned on each taste and again as a per-dosha index, so a caller can read it either way without deriving one from the other.List the twenty qualities - Ayurveda guna pairs APIReturn the twenty gunas, the qualities of Ayurveda, as the ten opposed pairs the commentaries spell out, each member with the single action word attached to it, and the half-verse that states the like-increases-like rule the whole domain runs on. Each quality carries the doshas that hold it, so the pairs join straight to the dosha catalogue. One pair carries a recorded disagreement between the two commentaries, and the response states it rather than resolving it silently, because the choice decides which dosha that pair joins to.

What You Can Build with Ayurveda API

Real-world applications and use cases for integrating Ayurveda API into your projects:

Wellness and meditation apps: a dosha profile card built from a birth chart, a morning routine anchored to the users own sunrise, and a seasonal guide that changes on the real ingress instant

Multi-domain AI companions: the Ayurvedic constitution beside the Vedic chart the app already fetched, read through the classical rules with a verse on each factor

Yoga and Ayurveda studios in the German, French and Russian markets, where the Sanskrit vocabulary is already the working vocabulary and a localized gloss is what is missing

Habit and routine products: the brahma muhurta window and the six dosha periods as real timestamps for a users own place, which is the part a printed timetable cannot supply

Editorial and newsletter platforms: a seasonal column that turns over on the ingress rather than on the first of the month, in every language the API ships

AI agents over Remote MCP: what is my dosha, when is brahma muhurta today, what season am I in, each answered with its citation and its scope in the payload

What developers are saying

DM

Dhani M.

Indie App Developer

Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.

Email feedback
TH

Tom H.

Senior Developer

The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.

Email feedback
CW

Chris W.

Backend Engineer

Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.

Email feedback

Do not take our word for it. Ask the agents.

The receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.

Opens a live web search in a new tab.

Getting started with Ayurveda API.

From zero to production in 3 steps. No signup required for testing.

3 Steps to Ship

1Install the SDKnpm i @roxyapi/sdk
2Get your API keyView Plans
3Make your first callView Docs

Agent-Ready Infrastructure

MCP

Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 18+ domains under one key.

  • Remote MCP server — every endpoint auto-discovered as a tool by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
  • Token-optimized responses — opt-in compact mode returns the same data with each field name sent once, cutting the tokens your agent reads per call by roughly 40 to 52 percent. Lossless, and one call still counts as one request.
  • llms.txt — AI-native discovery surface for ChatGPT, Perplexity, and Gemini citation
  • AGENTS.md — 2026 execution playbook for Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI. Bundled in the SDK.

From your AI agent to a verified Ayurveda answer.

Your AI agentyour model, your voice
Remote MCPauto-discovered, no local setupToken-optimized
Roxy Ephemeris11,693 tests, 2801 vs NASA JPL
Verified result18 domains, one flat rate

Your agent grounds every answer in verified calculations and replies in your own voice, so it never hallucinates a chart, date, or reading. No local setup, no AGPL, no hosted-AI markup.

Audit it yourself: every Ayurveda endpoint runs live in the API playground

Ayurveda API FAQ

What is an Ayurveda API?

It turns birth data, a date and a location into the Ayurvedic values an app needs: the vata, pitta and kapha constitution, the brahma muhurta window, the six dosha periods of the day and night, and the season with the regimen the primary text gives for it. Every value carries the work, chapter and verse it comes from, and every response states that it is for general wellness and cultural interest rather than medical advice. One key also unlocks every other RoxyAPI domain and a Remote MCP server.

Can a birth chart show a dosha?

The classical Jyotish texts do assign a humour to each graha and to each rising sign, and one of them states that the strongest planet imparts its humour to the native. This API scores exactly the three factors that carry such a rule and returns the verse behind each. What no primary text states is how to weigh those factors against each other, so the blend that produces the percentage split is labelled as a RoxyAPI convention, versioned, and published with its own weights inside the response.

When is brahma muhurta today?

It opens 96 minutes before sunrise and closes 48 minutes before it, so it moves with the date and the place. Send a date, a latitude and a longitude and the API returns both instants along with sunrise, sunset and the six dosha periods. The window is a fixed offset rather than a share of the night, which is the reading the classical commentary settles on outright, and calculators that scale it to the night length are following the reading it rejects.

What Ayurvedic season am I in?

Send a date and the API resolves the ritu from the real solar ingress instants and returns the season with its exact opening and closing times, the half of the year the sun is in, where each dosha stands in its yearly cycle, and the behaviour items the chapter gives. Boundaries are measured in the tropical zodiac by default, which is what published almanacs use for seasons; the sidereal reading is available as a convention and runs about 24 days later.

Is any of this medical advice?

No. Every response from this API carries a scope statement in the requested language: it is for general wellness and cultural interest only, it is not medical advice, and it is unrelated to the diagnosis, mitigation, prevention or treatment of any condition. No route accepts a health complaint, no field names a substance, and no endpoint returns a recommendation of one. Anyone with a health question should speak to a qualified professional.

Which texts is the Ayurveda API built from?

The Charaka Samhita and the Ashtanga Hridaya for the doshas, the tastes, the qualities, the daily routine and the seasonal regimen, and the Brihat Jataka for the graha and sign rules the constitution reads. Every value ships with the work, chapter and verse it comes from, and with whether the cited translation may be quoted or only referenced. Where two texts disagree, both readings are returned rather than one being chosen quietly.

Start using Ayurveda API today.

Ship a cited Ayurveda feature, not another dosha quiz.

All 18 domains included with every plan. Every endpoint, MCP server, SDK, and starters.

Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key