Parameters & Payload

Every request field, its defaults, and the tier/version selectors.

A request needs a question and a birthDetails object. Everything else is optional and defaults sensibly.

#Request body

Field	Type	Required	Notes
`question`	string	Yes	Non-empty. Blank → `400 INVALID_INPUT` before any billing.
`birthDetails`	object	Yes	All four sub-fields required (below).
`language`	string	No	ISO code from the 14 supported. Omit for English; auto-detected too.
`speed`	string	No	`"standard"` (default), `"fast"`, or `"eco"`. See tiers.
`version`	string	No	`"2"` (default) or `"2.5"`. Accepted only with `speed:"standard"`.
`service_tier`	string	No Planned	`"flex"`/`"standard"`/`"priority"` — planned; Vedika Standard 2.5 only.
`responseFormat`	string	No	`"text"` (default), `"markdown"`, or `"json"`.
`conversationId`	string	No	Stable id that enables multi-turn memory.
`saveConversation`	boolean	No	Persist the conversation for later retrieval.
`includeRemedies`	boolean	No	Include suggested remedies in the reading when applicable.
`system`	string	No	Optional astrology-system hint (e.g. Vedic, Western, KP); the engine chooses when omitted.

#birthDetails

datetime: Local wall-clock time, ISO 8601, no offset — e.g. "1990-05-15T10:30:00".
latitude: Decimal degrees, e.g. 28.6139.
longitude: Decimal degrees, e.g. 77.2090.
timezone: IANA name ("Asia/Kolkata") or a fixed offset ("+05:30").

Important

Invalid coordinates or timezone return 400 before any wallet reservation, so malformed requests are never charged. See Error Codes.

#Full payload

{
  "question": "When will I get married, and what will my partner be like?",
  "birthDetails": {
    "datetime": "1990-05-15T10:30:00",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "Asia/Kolkata"
  },
  "language": "hi",
  "speed": "standard",
  "version": "2.5",
  "responseFormat": "markdown",
  "conversationId": "u123-sess1"
}

#Tier & version selectors

speed chooses the delivery tier; version pins the Standard model. A version on a non-standard speed, or an unknown value, is rejected before billing. Full matrix: Model Catalog.

Note

Requesting speed:"fast" (Vedika Swift) on a Starter or Professional key returns 403 PLAN_UPGRADE_REQUIRED. Requesting speed:"eco" when the economy engine is momentarily unavailable returns 503 ECO_UNAVAILABLE before any charge.