Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/sagar-grv/ayush-synapse/llms.txt

Use this file to discover all available pages before exploring further.

The NAMASTE endpoints expose the loaded traditional Indian medicine codes covering Ayurveda, Siddha, and Unani systems. Codes are loaded from the bundled sample-namaste.csv file and persisted to the database on application startup. All responses return plain JSON — no authentication token is required in demo mode.

​
GET /namaste — List All NAMASTE Codes

Returns the complete set of NAMASTE codes currently loaded in the database. Method: GET
Path: /namaste
Auth: None required (open in demo mode)

​
Query Parameters

This endpoint accepts no query parameters. To search or filter, use GET /api/search.

​
Response

Returns a JSON array of NAMASTE code objects.
​
code
string
Unique NAMASTE code identifier, e.g. NAM-001.
​
display
string
Human-readable name for the condition, e.g. Common Cold.
​
definition
string
Clinical definition of the condition, e.g. An upper respiratory tract infection caused by various viruses.
​
system
string
AYUSH medical system this code belongs to. One of Ayurveda, Siddha, or Unani.

​
Example

curl -X GET http://localhost:5000/namaste
Response
[
  {
    "code": "NAM-001",
    "display": "Common Cold",
    "definition": "An upper respiratory tract infection caused by various viruses",
    "system": "Ayurveda"
  },
  {
    "code": "NAM-004",
    "display": "Joint Pain",
    "definition": "Pain in one or more joints",
    "system": "Siddha"
  },
  {
    "code": "NAM-005",
    "display": "Digestive Issues",
    "definition": "Problems with digestion or gastrointestinal function",
    "system": "Unani"
  }
]

​
GET /namaste/{code} — Get a Specific NAMASTE Code

Returns the full detail record for a single NAMASTE code identified by its code string. Method: GET
Path: /namaste/{code}
Auth: None required (open in demo mode)

​
Path Parameters

​
code
string
required
The NAMASTE code identifier to retrieve, e.g. NAM-001. Must match a code stored in the database exactly (case-sensitive).

​
Response

Returns a single NAMASTE code object on success.
​
code
string
Unique NAMASTE code identifier.
​
display
string
Human-readable name for the condition.
​
definition
string
Clinical definition of the condition.
​
system
string
AYUSH medical system: Ayurveda, Siddha, or Unani.
Returns HTTP 404 with the following body when the code does not exist:
404 Response
{
  "error": "Code not found"
}

​
Example

curl -X GET http://localhost:5000/namaste/NAM-001
Response — 200 OK
{
  "code": "NAM-001",
  "display": "Common Cold",
  "definition": "An upper respiratory tract infection caused by various viruses",
  "system": "Ayurveda"
}

​
Sample NAMASTE Codes

The following codes are included in sample-namaste.csv and are loaded at startup. The table below shows the first six entries spanning all three AYUSH systems.
CodeDisplaySystem
NAM-001Common ColdAyurveda
NAM-002HeadacheAyurveda
NAM-003FeverAyurveda
NAM-004Joint PainSiddha
NAM-005Digestive IssuesUnani
NAM-006Skin RashAyurveda
NAMASTE codes are loaded from sample-namaste.csv at application startup. The CSV uses four columns in this order: code, display, definition, system. The bundled file ships with 100 codes: 24 Ayurveda, 45 Siddha, and 31 Unani entries. System assignments are not strictly sequential — for example, NAM-004 is Siddha and NAM-005 is Unani, both appearing within the first six rows. If the database already contains NAMASTE codes on startup, the CSV load is skipped and the existing rows are used instead.

Build docs developers (and LLMs) love

Get started for freeTalk to us