Partners

Rev-share attribution + payout reconciliation

Joins partner_revshare_attributions (who qualifies, with locked rev-share %) against entity_mrr_snapshots (Stripe-sourced) to compute payouts for the period.

Default period: previous calendar month. If no MRR snapshots exist for the period (Stripe webhook not wired yet), payouts come back as 0 with the attribution list still populated for audit.

Auth: ptx_live_… provisioning key. Rate limit: 30/min per partner key.

get/api/v1/partner/revshare

Request

Base URL: https://www.agenttax.io
URL: https://www.agenttax.io/api/v1/partner/revshare
Auth: API key in header X-API-Key

Query parameters

fromstring date-time

ISO date-time. Defaults to start of current calendar month (usage) / previous month (revshare).

tostring date-time

ISO date-time. Must be after from. Exclusive upper bound.

Response

Attribution list + computed payouts. Sorted by payout descending.

Example response

{
  "partner": {
    "revshare_triggered_at": "2026-04-01T00:00:00Z"
  },
  "period": {
    "from": "2026-04-01T00:00:00Z",
    "to": "2026-04-01T00:00:00Z"
  },
  "totals": {
    "attributed_mrr_usd": "12.3400",
    "payout_usd": "12.3400"
  },
  "per_entity": [
    {
      "revshare_pct": 0.1,
      "mrr_usd": "12.3400",
      "payout_usd": "12.3400",
      "window_ends_at": "2026-04-01T00:00:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.