DevelopersAPI reference
Dashboard API
REST endpoints for dashboard in SKUFlow: 1 operations with parameters, request and response fields, permissions and curl examples.
Base URL: https://app.skuflow.ai/api. Every call needs Authorization: Bearer skf_… (Authentication); {organizationId} ($ORGANIZATION_ID in the examples) is your business's id.
| Operation | Endpoint | Risk |
|---|---|---|
| Dashboard figures | GET /organizations/{organizationId}/dashboard | read |
Dashboard figures
GET /organizations/{organizationId}/dashboard
Counts and money for the dashboard: new requests, quotes awaiting approval, outstanding and overdue balances, payments collected this month and tips. Read-only. today is the business's date; it defaults to today in the organization's timezone.
| Permission | reports.read (Owner, Admin, Staff, Member) |
| Risk | read, OAuth scope skuflow.read. Read: reads only. |
| MCP tool | dashboard_stats (toolset reports, in the default set) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
today | query | string | No | A calendar date in the business's own calendar, YYYY-MM-DD. |
Example
curl "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/dashboard" \
-H "Authorization: Bearer $SKUFLOW_API_KEY"Response
200: the answer's fields
| Field | Type | Description |
|---|---|---|
customers | integer | |
invoicesOutstanding | integer | SENT invoices. |
invoicesOutstandingCents | integer | Balance still due on SENT invoices, in integer cents. |
invoicesOverdue | integer | |
invoicesOverdueCents | integer | Balance still due on OVERDUE invoices, in integer cents. |
paymentsCollectedCents | integer | Payments received, net of refunds, tips excluded, in integer cents. |
paymentsThisMonthCents | integer | The same for payments dated this calendar month up to today, in integer cents. |
tipsThisMonthCents | integer | Tips this month, in integer cents. |
requestsNew | integer | NEW requests. |
quotesAwaitingApproval | integer | SENT quotes still within their date. |