Skip to main content

​
Sales Reports Endpoints

​
Upload sales report

Upload a parsed sales report for a specific date range. 
POST /api/v1/sales_report
Content-Type: application/json
Request body: 
{
  "date_from": "2026-03-01",
  "date_to": "2026-03-27",
  "report": {
    "gross_sales": 1234.56,
    "order_count": 42,
    "product_amount": 1100.00,
    "total_fees": 134.56,
    "shipping_amount": 41.58,
    "total_refund_amount": 0.00,
    "refunded_orders": 0,
    "refunded_fees": 0.00,
    "adjustments": 0.00,
    "net_sales_minus_fees": 965.44,
    "net_sales": 1100.00
  }
}
Response: 
{"status": "ok"}

​
Get sales gaps

Returns months that are missing sales report data so the agent knows what to backfill. 
GET /api/v1/sales_report/gaps
Response: 
{
  "gaps": ["2026-01-01", "2026-02-01"]
}
Each gap is the first day of a month that needs data. The agent backfills up to 2 months per sync cycle, oldest first.