## List Entries

**post** `/v1/credits/listEntries`

Fetches a list of credit ledger entries. Returns lists of ledgers per customer. Ledger entries are returned in chronological order. Ledger entries associated with voided credit grants are not included.

### Returns

- **data:** `array of object`

  - **customer\_id:** `string`

  - **ledgers:** `array of object`

    - **credit\_type:** `CreditTypeData`

    - **ending\_balance:** `object`

      the effective balances at the end of the specified time window

      - **effective\_at:** `string`

        the ending_before request parameter (if supplied) or the current billing period's end date

      - **excluding\_pending:** `number`

        the ending balance, including the balance of all grants that have not expired before the effective_at date and deductions that happened before the effective_at date

      - **including\_pending:** `number`

        the excluding_pending balance plus any pending invoice deductions and expirations that will happen by the effective_at date

    - **entries:** `array of CreditLedgerEntry`

    - **pending\_entries:** `array of CreditLedgerEntry`

    - **starting\_balance:** `object`

      - **effective\_at:** `string`

        the starting_on request parameter (if supplied) or the first credit grant's effective_at date

      - **excluding\_pending:** `number`

        the starting balance, including all posted grants, deductions, and expirations that happened at or before the effective_at timestamp

      - **including\_pending:** `number`

        the excluding_pending balance plus any pending activity that has not been posted at the time of the query

- **next\_page:** `string`