Financial Reports

Financial reports are where everything comes together. These read-only endpoints aggregate your daily financials, ad spend, COGS, and fixed costs into actionable summaries. Use the P&L summary for detailed breakdowns over any date range, or hit the overview endpoint for a quick snapshot of today, this week, and this month.

These endpoints require the stats:read scope. They are read-only — all underlying data is managed through the other financial endpoints.

GET/financials/summary

Get P&L summary

This endpoint returns a full profit & loss report for the specified date range. All costs are broken down by category so you can see exactly where the money is going. If no date range is provided, it defaults to the current month.

Required attributes

Name
start
Type
string
Description
Start date in YYYY-MM-DD format.
Name
end
Type
string
Description
End date in YYYY-MM-DD format.

Optional attributes

Name
store
Type
string
Description
Filter by store identifier. Omit to aggregate across all stores.

Request

GET

/financials/summary

curl -G https://api.dealdome.eu/financials/summary \
  -H "Authorization: Bearer {token}" \
  -d start=2026-04-01 \
  -d end=2026-04-13

Response

{
  "start": "2026-04-01",
  "end": "2026-04-13",
  "revenue": 15820.40,
  "cogs": 3955.10,
  "shipping_cost": 1120.80,
  "ad_spend": 4350.00,
  "transaction_fees": 474.61,
  "fixed_costs": 445.00,
  "total_costs": 10345.51,
  "net_profit": 5474.89,
  "margin_percent": 34.6,
  "days": 13,
  "avg_daily_revenue": 1217.00,
  "avg_daily_profit": 421.15
}

GET/financials/overview

Get KPI overview

This endpoint returns a quick snapshot of your key performance indicators for three time periods: today, this week (Monday to now), and this month (1st to now). It's designed for dashboard widgets and quick status checks.

Optional attributes

Name
store
Type
string
Description
Filter by store identifier. Omit to aggregate across all stores.

Request

GET

/financials/overview

curl -G https://api.dealdome.eu/financials/overview \
  -H "Authorization: Bearer {token}"

Response

{
  "today": {
    "revenue": 1245.80,
    "ad_spend": 350.00,
    "net_profit": 456.73,
    "roas": 3.56,
    "orders": 47
  },
  "this_week": {
    "revenue": 8420.60,
    "ad_spend": 2180.00,
    "net_profit": 2890.45,
    "roas": 3.86,
    "orders": 312
  },
  "this_month": {
    "revenue": 15820.40,
    "ad_spend": 4350.00,
    "net_profit": 5474.89,
    "roas": 3.64,
    "orders": 589
  }
}