Skip to content
CommissionSight Docs

Chargebacks

A chargeback is when a carrier posts a negative commission against a policy — clawing back money they previously paid. CommissionSight treats chargebacks as a first-class event: a CHARGEBACK flag, a dashboard figure, a results filter, and a dedicated enriched endpoint.

The chargeback endpoint

Terminal window
curl "https://api.commissionsight.com/v1/chargebacks?period=2026-05" -H "Authorization: Bearer $TOKEN"

For each chargeback this period it resolves the policy’s original payout (“record 0”) — when the carrier first paid, how much, and from which file — and whether the chargeback fully reverses it:

{
  "period": "2026-05",
  "data": [
    {
      "memberRefId": "…", "policyNumber": "P-9001", "planName": "Gold PPO",
      "chargebackAmount": 120.00,            // clawed back this period (positive magnitude)
      "paidOut": true,                       // the carrier did pay this policy at some point
      "originalPayout": {                    // record 0
        "period": "2026-02", "amount": 120.00,
        "fileId": "…", "fileName": "summit-health-2026-02.csv"
      },
      "fullyReversed": true                  // |chargeback| === original payout
    }
  ]
}

period defaults to the latest period with data; filter with ?carrierId=, page with limit/offset. paidOut: false means there’s no positive-commission record for the policy — the carrier charged back commission it never appears to have paid, which is worth investigating.

Need this across your whole history at once, with paid-first verdicts, lifetime paid-vs-clawed totals per policy, and a carrier-ready CSV? That’s the chargeback proof-out — an app-only enterprise feature.

Other ways chargebacks surface

  • Flag — members whose commission went net-negative carry a CHARGEBACK flag in results and the timeline.
  • Results filter — GET /v1/jobs/{jobId}/results?chargeback=true returns only the chargeback members for that period.
  • Rollup — GET /v1/reports/rollup totals include chargebackCount and chargebackAmount (powers the dashboard’s chargeback figure).

SDK

const cbs = await cs.listChargebacks({ period: '2026-05' });
for (const c of cbs.data) {
  if (!c.fullyReversed) console.log(c.policyNumber, 'partial clawback', c.chargebackAmount);
}