Preview

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

commissionRecentActivity

Recent commission activity for the Catalog Advisor dashboard, newest first. Ordered by status date falling back to the start of the commission period, so commissions with no status date keep a sensible position. Returns an empty list when the advisor has no commissions.

This query spans every source system and every tenant for the advisor, so summing amount here will not reconcile with commissionSeries, which is scoped to cloud commissions for a single tenant. That divergence is deliberate: use this query for the activity feed and commissionSeries for any total a chart or tile reports.

This page contains

    Authorization Rules

    This request requires authorization with at least one of the following scopes:

    Scopes

    ROLE_RESELLER

    ROLE_CHANNEL_ADMIN

    Arguments

    advisorId ID!

    Advisor (tenant) whose commission activity is returned. Always applied, so a caller can never read another organization's activity.

    salesAgentUuid ID

    Optional sales representative filter, matched case-insensitively and narrowing within the advisor scope. Roughly a quarter of commissions carry a rep UUID, so a rep-scoped total is a lower bound on what that rep contributed and never their actual commissions — do not build payout or compensation features on it. An unmatched value returns an empty list, which is the expected outcome for reps with no warehouse UUID.

    limit Int

    Maximum number of rows to return. Omit it to return every matching row — there is no server-imposed ceiling. Zero or negative is rejected as invalid input.

    Return Fields

    [CommissionRecentActivityItem!]! PREVIEW

    Interactive example

    This is an example query. Use the embedded interactive tool below to edit the query.

    Hint: use Ctrl + Space for autocompleting fields.