# TokenEntry

object type

One platform token-ledger fact. The wallet's balance = Σ these rows' signed amounts EXACTLY — cached in the SAME transaction as every append (ruling: the ledger never lies — drawdowns record IN FULL and the balance may transiently dip below zero; the floor is the exhaustion CASCADE, never entry-clamping).

## Fields

| Field | Type | Notes |
| --- | --- | --- |
| `id` | [ID](/types/#scalars) `ID!` | No further notes. |
| `type` | [String](/types/#scalars) `String!` | No further notes. |
| `caption` | [String](/types/#scalars) `String!` | No further notes. |
| `status` | [String](/types/#scalars) `String!` | active (a posted fact) — the void lane is FSM data with NO wire op (corrections are authority adjustment entries). |
| `parentId` | [ID](/types/#scalars) `ID!` | The owning TokenAccount. |
| `rootId` | [ID](/types/#scalars) `ID!` | The org-group family root. |
| `createdAt` | [String](/types/#scalars) `String!` | No further notes. |
| `updatedAt` | [String](/types/#scalars) `String!` | No further notes. |
| `revisionNum` | [Int](/types/#scalars) `Int!` | No further notes. |
| `revision` | [ID](/types/#scalars) `ID!` | No further notes. |
| `entryKind` | [String](/types/#scalars) `String!` | purchase \| plan_included \| grant \| drawdown \| transfer \| adjustment (the registry roster VERBATIM — NO refund, NO expiry; plan_included = the monthly fee's beyond-overhead share auto-credited at settle — banks forever, fungible with purchases). |
| `amountTokens` | [Int](/types/#scalars) `Int!` | The SIGNED integer token amount — the sign IS the flow direction (purchase/grant +, drawdown −, transfer ±, adjustment ±). |
| `reason` | [String](/types/#scalars) | The reason text — always present on grant/adjustment (root money moves say why); optional narration otherwise. |
| `tokenPurchaseId` | [ID](/types/#scalars) | The settled TokenPurchase. |
| `billingChargeId` | [ID](/types/#scalars) | The BillingCharge whose settle minted this credit. |
| `transferCounterpartRootId` | [ID](/types/#scalars) | The transfer counterpart's org group. |
| `transferCounterpartEntryId` | [ID](/types/#scalars) | The transfer counterpart's entry (the sum-conserving pair cross-reference — transfer entries only). |
| `drawdownLines` | [TokenDrawdownLine](/types/TokenDrawdownLine/) `[TokenDrawdownLine!]` | The per-(event × dimension) itemization (drawdown entries only — the transparency law; ruling: each line names ITS usage event). |
| `carriedInMicroTokens` | [Int](/types/#scalars) | The µtoken accrual carried INTO this entry from prior sub-token usage. |
| `carriedOutMicroTokens` | [Int](/types/#scalars) | The µtoken remainder carried OUT to the wallet's microTokenCarry after this entry materialized. |
| `rateCardVersion` | [Int](/types/#scalars) | The rate card that priced this entry. |