# 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](/types/#scalars) | No further notes. |
| `revokedAt` | [String](/types/#scalars) | No further notes. |
| `revokedReason` | [String](/types/#scalars) | The root’s spoken revocation reason (at most 256 characters; present with revokedAt). |
| `tenureMonths` | [Int](/types/#scalars) `Int!` | REAL consecutive good-standing months (0 = no live streak / nothing evaluated yet). |
| `effectiveTenureMonths` | [Int](/types/#scalars) `Int!` | Tenure + any switcher clock credit — what the ladder reads. |
| `basis` | [String](/types/#scalars) `String!` | ladder \| heritage — how the current tier is earned. |
| `tierBp` | [Int](/types/#scalars) `Int!` | The earned share NOW, basis points (0 = not yet earning). |
| `nextTierAtMonths` | [Int](/types/#scalars) | The next ladder rung above the current effective months (absent at the top and for a standing heritage 100%). |
| `nextTierBp` | [Int](/types/#scalars) | No further notes. |
| `computedThroughMonth` | [String](/types/#scalars) | The last CLOSED month the engine decided (absent = no month ever evaluated). |
| `lifetime` | [GiveBackLifetimeTotal](/types/GiveBackLifetimeTotal/) `[GiveBackLifetimeTotal!]!` | Σ every accrued entry PER CURRENCY, minor units, currency-ascending. |
| `accruals` | [GiveBackAccrualEntry](/types/GiveBackAccrualEntry/) `[GiveBackAccrualEntry!]!` | The earned entries, NEWEST-FIRST + bounded (limit clamps \[1,200] default 50; before pages backward by entry id). |

## Used by

- [giveBack](/reference/billing-and-the-wallet/giveBack/)