Track Order

Stay updated on your medication orders. Check real-time status, track deliveries, and view your complete order history.

Check Order Status

Get the current status and details of a specific order.

# Check status of order ORD-789
check_order_status({
  orderId: "ORD-789"
})

Parameters:

Parameter	Type	Required	Description
`orderId`	string	Yes	Your order ID

Response:

{
  "orderId": "ORD-789",
  "status": "out_for_delivery",
  "statusLabel": "Out for Delivery",
  "createdAt": "2026-04-18T10:30:00Z",
  "items": [
    {
      "name": "Amoxicillin 500mg",
      "quantity": 2,
      "price": 2500
    }
  ],
  "total": 5000,
  "pharmacy": {
    "name": "GreenCross Pharmacy",
    "phone": "+2348012345678"
  },
  "delivery": {
    "type": "delivery",
    "address": "12 Admiralty Way, Lekki",
    "partner": "Famasi Logistics",
    "riderName": "John",
    "riderPhone": "+2348076543210",
    "eta": "15 minutes"
  },
  "timeline": [
    {
      "status": "order_placed",
      "time": "2026-04-18T10:30:00Z",
      "message": "Order placed successfully"
    },
    {
      "status": "payment_received",
      "time": "2026-04-18T10:32:00Z",
      "message": "Payment confirmed"
    },
    {
      "status": "processing",
      "time": "2026-04-18T10:45:00Z",
      "message": "Pharmacy is preparing your order"
    },
    {
      "status": "out_for_delivery",
      "time": "2026-04-18T11:15:00Z",
      "message": "Order is on the way"
    }
  ]
}

Get Order History

View all your past and current orders.

# Get recent orders
get_order_history({
  limit: 10,
  page: 1,
  status: "completed"  // optional filter
})

Parameters:

Parameter	Type	Required	Description
`limit`	number	No	Number of orders to return (default: 10)
`page`	number	No	Page number for pagination
`status`	string	No	Filter by status (pending, completed, cancelled)

Response:

{
  "orders": [
    {
      "orderId": "ORD-789",
      "status": "completed",
      "createdAt": "2026-04-15T14:20:00Z",
      "completedAt": "2026-04-15T15:10:00Z",
      "items": [
        {
          "name": "Paracetamol 500mg",
          "quantity": 1,
          "price": 800
        }
      ],
      "total": 800,
      "pharmacy": {
        "name": "GreenCross Pharmacy"
      },
      "canRefill": true,
      "refillId": "REF-456"
    },
    {
      "orderId": "ORD-790",
      "status": "out_for_delivery",
      "createdAt": "2026-04-18T10:30:00Z",
      "items": [
        {
          "name": "Amoxicillin 500mg",
          "quantity": 2,
          "price": 2500
        }
      ],
      "total": 5000,
      "pharmacy": {
        "name": "GreenCross Pharmacy"
      }
    }
  ],
  "total": 24,
  "hasMore": true
}

Order Status Reference

Status	Meaning	Action Needed
`pending_payment`	Waiting for payment	Complete checkout
`payment_received`	Paid, not yet processing	None
`processing`	Pharmacy preparing	None
`ready_for_pickup`	Ready for collection	Go to pharmacy
`out_for_delivery`	With delivery partner	Wait for arrival
`completed`	Delivered/picked up	None
`cancelled`	Order cancelled	Place new order

Real-time Updates

For live order tracking, the MCP client automatically polls for updates every 30 seconds when you have an active delivery.

# Check current status
check_order_status({ orderId: "ORD-789" })

# The timeline shows progress through each step
# You'll see updated eta and rider info for deliveries

Example: Tracking Workflow

# View all recent orders
get_order_history({ limit: 5 })
# → Shows list of orders

# Check specific order details
check_order_status({ orderId: "ORD-789" })
# → Shows full status and timeline

# For active deliveries, check periodically
# to see updated location and ETA

Delivery Notifications

You’ll receive updates via:

SMS at each status change
In-app notifications (if using Famasi app)
MCP client status updates

Cancelling Orders

Orders can only be cancelled before they’re processed:

# Cancel an order (if still pending)
cancel_order({ orderId: "ORD-789" })

Next steps

Request Refill — Reorder from history
Place Order — Create new orders
Search Medications — Find medications