Get dashboard home stats (JWT-only)
Wraps the `get_merchant_dashboard_data` Postgres RPC for the dashboard home view. Coin (`value_type`) is selected server-side based on the active environment. **JWT-only**: this endpoint resolves the company via the Postgres `auth.uid()` session variable, which is only populated when the caller's Bearer token is forwarded to Supabase. API-key authentication therefore returns 403.
Authorization
apiKey Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.
In: header
Query Parameters
"today""today" | "week" | "monthly"Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://loading/v1/api/dashboard-stats/"{
"success": true,
"timestamp": "2026-02-27T00:00:00.000Z",
"data": {
"timeframe": "today",
"metrics": {},
"kpis": {},
"salesOvertime": []
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}