POST /api/v1/ask

curl -X POST https://askbiz.co/api/v1/ask \
  -H "x-api-key: abz_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Which of my products had the worst margin last month?"
  }'

curl -X POST https://askbiz.co/api/v1/ask \
  -H "x-api-key: abz_generic_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Is a 22% gross margin healthy for this business?",
    "context": {
      "currency": "KES",
      "symbol": "KSh",
      "biz_type": "retail",
      "region": "Nairobi, Kenya",
      "revenue": 480000,
      "margin": 22,
      "top_products": ["Cooking oil 2L", "Maize flour 2kg", "Sugar 1kg"]
    }
  }'

{
  "answer": "Fanta Orange 300ml had the worst margin last month at 11%, well below your 34% average. You sold 210 units at that margin, which cost you roughly KSh 9,800 in foregone profit compared to your average line.",
  "insight_header": "Fanta Orange 300ml is dragging your margin down",
  "verdict": "watch",
  "verdict_sentence": "One low-margin product is quietly eating into an otherwise healthy month.",
  "confidence": "high",
  "kpi_cards": [
    { "label": "Worst margin product", "value": "Fanta Orange 300ml" },
    { "label": "Margin", "value": "11%" }
  ],
  "chart": {
    "type": "bar",
    "labels": ["Fanta Orange 300ml", "Coca-Cola 500ml", "Sprite 500ml"],
    "values": [11, 34, 29],
    "label": "Margin %"
  },
  "table": null,
  "recommendations": [
    "Reprice Fanta Orange 300ml or renegotiate your supplier cost — it's the only line below 20% margin.",
    "Check whether the low margin is a pricing mistake or a deliberate loss-leader."
  ],
  "follow_up_questions": [
    "What was my average margin across all products last month?",
    "How much would repricing this item to 25% margin add to my monthly profit?"
  ],
  "meta": {
    "model": "askbiz-v1",
    "latency_ms": 1840,
    "requests_remaining": 87
  }
}