---
title: "corestack_billing_ledger_list"
url: https://docs.corefinity.com/mcp/tools/corestack_billing_ledger_list
type: tool
last_updated: 2026-11-13
feature: billing
related:
  - https://docs.corefinity.com/api/reference/billing/list-billing-ledger.md
  - https://docs.corefinity.com/guides/billing/billing-overview.md
---
# corestack_billing_ledger_list

**Billing ledger.** Page through a billing account's ledger, newest first: accruals, credits applied, invoices, payments, refunds, adjustments and write-offs, filtered by type and date. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

Page through a billing account's ledger, newest first: accruals, credits applied, invoices, payments, refunds, adjustments and write-offs, filtered by type and date.

Through the REST API (`/api/corestack/billing/…`) the account is `account`, as on the Billing pages; `account_id`, this tool's name, is accepted there too as its alias.

## Inputs

- `account_id` (integer, ≥ 1): One of your company's billing accounts (corestack_billing_account_get gives its id); omitted, the company's default account.
- `type` (string, up to 32 characters): The kind of entry to list: accrual, credit_applied, invoice, payment, refund, adjustment or write_off; omitted, every kind.
- `from` (string, up to 32 characters): A date or time (ISO 8601).
- `to` (string, up to 32 characters): A date or time after from (ISO 8601).
- `cursor` (string, up to 20 characters): next_cursor from the previous page.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "account_id": {
      "description": "One of your company's billing accounts (corestack_billing_account_get gives its id); omitted, the company's default account.",
      "minimum": 1,
      "type": "integer"
    },
    "cursor": {
      "description": "next_cursor from the previous page.",
      "maxLength": 20,
      "type": "string"
    },
    "from": {
      "description": "A date or time (ISO 8601).",
      "maxLength": 32,
      "type": "string"
    },
    "to": {
      "description": "A date or time after from (ISO 8601).",
      "maxLength": 32,
      "type": "string"
    },
    "type": {
      "description": "The kind of entry to list: accrual, credit_applied, invoice, payment, refund, adjustment or write_off; omitted, every kind.",
      "maxLength": 32,
      "type": "string"
    }
  },
  "type": "object"
}
```

## Refusals

- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_billing_ledger_list",
  "arguments": {}
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_billing_ledger_list. (Billing ledger.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/billing/ledger](https://docs.corefinity.com/api/reference/billing/list-billing-ledger.md)
- Guide: [Billing](https://docs.corefinity.com/guides/billing/billing-overview.md)
