v2

latestOpenAPI 3.1.02026-08-01244220427.0 KB
AI Advisor

Chat With Advisor

Handle a chat request and return a structured AI advisor response.

Uses Mistral AI with the Scout personality to provide business insights.

Returns: AIAdvisorResponse: Advisor message, transaction metrics and summary, date range, optional warning, and timestamp.

Raises: HTTPException: with status 503 if AI backend (MISTRAL_API_KEY) is not configured; with status 500 for other internal errors.

post/api/ai-advisor

Request body

messagestring required
dateRangeOverrideobject nullable
userIdstring nullable
programIdstring nullable
transactionSummaryobject nullable
transactionDetailsobject[] nullable
currencyCodestring
currencySymbolstring

Response

Successful Response

responsestring required
transactionCountinteger required
transactionSummaryobject required
dateRangeobject required
warningstring nullable
timestampstring required