Skip to main content

Get Supplier Overview

GET 
/api/reporting/suppliers/overview

Macro supplier dashboard for the resolved period: headline KPIs (purchase volume, sales volume, profit, active suppliers), the hottest/coldest movers, a 12-month growth heatmap, and the full leaderboard. KPIs and trends are read from monthly supplier metric snapshots.

Authentication: Requires Bearer token (scope: reports)

Required parameters:

  • period_mode: yoy | qoq | mom | custom

When period_mode=custom, date_from and date_to (YYYY-MM-DD or m/d/Y) are both required and date_to must be on or after date_from.

Optional:

  • growth_basis: spend | sales | profit | margin (default: sales) — the basis used to rank movers and the heatmap
  • min_volume: numeric — minimum purchase volume before a supplier qualifies as a mover (default: 1000)
  • include_archived: boolean — include archived suppliers (default: false)

Request​

Responses​

Successful response