Preview

CommissionSeriesPoint is in Preview status and is subject to change without notice. For more information about Preview status, see the GraphQL API policy.

CommissionSeriesPoint

One bucket of a commission series. Both measures ride the same point rather than being selected by a measure argument, because they come from the same scan — so the Commissions chart, the Billings chart, and the revenue tiles share a single round trip.

This page contains

    Fields

    bucketStart: DateTime!

    Inclusive start of the bucket (RFC 3339, UTC). MONTH buckets always start on the first of the month, so a range beginning mid-month still yields that whole month as one bucket.

    commissionAmount: Float!

    Commission earned in this bucket, expressed in currency. Zero on a bucket with no commissions.

    grossRevenue: Float!

    Revenue that produced commissionAmount, apportioned to row grain upstream so it is safe to sum. Zero on a bucket with no commissions.

    currency: String

    ISO 4217 currency code for both measures, constant across an advisor's commissions. Carried onto zero-filled buckets from a bucket that has commissions; null only when the whole range is empty.

    Queries for CommissionSeriesPoint

    commissionSeries PREVIEW

    Commission amount and gross revenue bucketed over a date range, for the Commissions chart, the Billings chart, and the Performance Overview revenue tiles.

    Unlike commissionRecentActivity, which spans every source system and tenant for the advisor, this query covers cloud (SaaS) commissions for a single tenant — hence the mandatory tenant.

    Buckets are dense: every bucket in the range is returned, with zero for both measures where the advisor has no commissions, so a client never reimplements gap-filling. An advisor with no commissions at all therefore gets a full range of zeros rather than an empty list, and the number of points is a function of the range and granularity only, never of the data.