---
title: "Financial trends analytics"
method: GET
path: "/admin/analytics/financial-trends"
tags: ["Admin"]
---

# Financial trends analytics

`GET /admin/analytics/financial-trends`

## Request

- Base URL: `https://api.presscart.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.presscart.com/admin/analytics/financial-trends`
- Auth: HTTP bearer

Revenue, profit, margin and COGS time series over a date range, plus breakdowns by product, outlet, campaign and customer (read-only, ascend-processor accounting DB + primary DB for product names).

## Query parameters

- `from` string, required
- `to` string, required
- `granularity` 'day' | 'week' | 'month', required

## Response `200`

Financial trends retrieved successfully

- object
  - `from` string, required
  - `to` string, required
  - `granularity` 'day' | 'week' | 'month', required
  - `series` object[], required
    - `period` string, required
    - `revenue` number, required
    - `cogs` number, required
    - `profit` number, required
    - `margin` number, required
    - `order_items` number, required
  - `totals` object, required
    - `revenue` number, required
    - `cogs` number, required
    - `profit` number, required
    - `margin` number, required
    - `order_items` number, required
  - `breakdowns` object, required
    - `by_product` object[], required
      - `id` string, nullable, required
      - `label` string, required
      - `revenue` number, required
      - `cogs` number, required
      - `profit` number, required
      - `margin` number, required
      - `order_items` number, required
    - `by_outlet` object[], required
      - `id` string, nullable, required
      - `label` string, required
      - `revenue` number, required
      - `cogs` number, required
      - `profit` number, required
      - `margin` number, required
      - `order_items` number, required
    - `by_campaign` object[], required
      - `id` string, nullable, required
      - `label` string, required
      - `revenue` number, required
      - `cogs` number, required
      - `profit` number, required
      - `margin` number, required
      - `order_items` number, required
    - `by_customer` object[], required
      - `id` string, nullable, required
      - `label` string, required
      - `revenue` number, required
      - `cogs` number, required
      - `profit` number, required
      - `margin` number, required
      - `order_items` number, required

## Other responses

- `503`: Accounting database is not configured or unreachable

---

[API](https://skmtc.dev/presscart/apis/presscart-prod-api.md) · [All operations](https://skmtc.dev/presscart/apis/presscart-prod-api/llms.txt) · [OpenAPI document](https://skmtc.dev/presscart/apis/presscart-prod-api/revisions/2154581d845e?raw)