Get dashboard stats
Returns all data needed to render the merchant dashboard in a single call: KPI cards, daily revenue trend, gateway split, and fees vs net breakdown.
Authentication: Merchant JWT (x-auth-token). The :storeId in the path must be included in the JWT’s stores array — otherwise the endpoint returns 401.
Timezone: All date parameters are interpreted in COT (UTC-5). date_to is inclusive end-of-day. Dates in the response are COT calendar dates.
Currency filter: Strict — a store with both COP and USD wallets that requests currency=COP will receive only COP data.
Zero-days: daily_revenue and fees_vs_net include an entry for every day in the range, including days with no transactions (value: 0, fees: 0, net_to_merchant: 0). This ensures chart libraries render a continuous line/bar without gaps.
Delta calculations: delta_revenue_pct and delta_orders_pct compare the requested window against the immediately preceding window of equal length. A 30-day request (Apr 1–Apr 30) compares against the 30 days prior (Mar 2–Mar 31). Returns null when the previous window has zero activity (avoids division by zero).
Gateway split: Only includes gateways for which fee data has been synced from the ledger (Order_financials). pct values sum to ~1.0 with floating-point tolerance.
Path Parameters
The store ID to fetch dashboard data for. Must be owned by the authenticated user.
2366
Query Parameters
3-letter currency code (e.g. COP, USD).
^[A-Z]{3}$"COP"
Start of the date range (YYYY-MM-DD, COT timezone, inclusive).
"2026-04-01"
End of the date range (YYYY-MM-DD, COT timezone, inclusive end-of-day).
"2026-04-30"
Response
Dashboard stats