GiveBackReport
object type
The caller group's give-back standing (the program's merchant-visible transparency surface): the derived tenure clock, the earned tier, the next rung, and the earned ledger. Figures are as of computedThroughMonth — the last CLOSED month the billing engine decided.
Fields
| Field | Type | Notes |
|---|---|---|
convertedFrom | String | No further notes. |
revokedAt | String | No further notes. |
revokedReason | String | The root’s spoken revocation reason (at most 256 characters; present with revokedAt). |
tenureMonths | Int Int! | REAL consecutive good-standing months (0 = no live streak / nothing evaluated yet). |
effectiveTenureMonths | Int Int! | Tenure + any switcher clock credit — what the ladder reads. |
basis | String String! | ladder | heritage — how the current tier is earned. |
tierBp | Int Int! | The earned share NOW, basis points (0 = not yet earning). |
nextTierAtMonths | Int | The next ladder rung above the current effective months (absent at the top and for a standing heritage 100%). |
nextTierBp | Int | No further notes. |
computedThroughMonth | String | The last CLOSED month the engine decided (absent = no month ever evaluated). |
lifetime | GiveBackLifetimeTotal [GiveBackLifetimeTotal!]! | Σ every accrued entry PER CURRENCY, minor units, currency-ascending. |
accruals | GiveBackAccrualEntry [GiveBackAccrualEntry!]! | The earned entries, NEWEST-FIRST + bounded (limit clamps [1,200] default 50; before pages backward by entry id). |