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

**Invoices.** Page through a billing account's invoices, newest first, optionally by status and with their lines. Scope: read.

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

## When to use it

Page through a billing account's invoices, newest first, optionally by status and with their lines.

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.
- `status` (array of one of `open`, `collecting`, `paid`, `unpaid`, `void`, `refunded`, `written_off`, 1–7 items)
- `with` (one of `lines`)
- `limit` (integer, 1–100, default `25`)
- `cursor` (string, up to 20 characters): next_cursor from the previous page.
- `overdue` (boolean): Only invoices past their due day with something left to pay.
- `issued_from` (string, a day `YYYY-MM-DD`): Issued on or after this day.
- `issued_to` (string, a day `YYYY-MM-DD`): Issued on or before this day; a range that ends before it starts is refused.
- `search` (string, at most 100 characters): An invoice number, or part of one.

These are the Invoices page's filters and `GET /api/corestack/billing/invoices`'s, with the same checks. `total` counts the
invoices the status and filters choose, whatever the cursor (the page's "1–25 of N").

### 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"
    },
    "issued_from": {
      "description": "Issued on or after this day (YYYY-MM-DD).",
      "format": "date",
      "type": "string"
    },
    "issued_to": {
      "description": "Issued on or before this day (YYYY-MM-DD).",
      "format": "date",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "overdue": {
      "description": "Only invoices past their due day with something left to pay.",
      "type": "boolean"
    },
    "search": {
      "description": "An invoice number, or part of one.",
      "maxLength": 100,
      "type": "string"
    },
    "status": {
      "items": {
        "enum": [
          "open",
          "collecting",
          "paid",
          "unpaid",
          "void",
          "refunded",
          "written_off"
        ],
        "type": "string"
      },
      "maxItems": 7,
      "minItems": 1,
      "type": "array"
    },
    "with": {
      "enum": [
        "lines"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
```

## Refusals

- `invalid_arguments`: `fields` names the field with the page's message: a status you cannot see, a day that is not
  `YYYY-MM-DD`, or `issued_to` before `issued_from`.
- 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_invoices_list",
  "arguments": {"overdue": true, "issued_from": "2026-01-01"}
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_billing_invoices_list with overdue true, issued_from 2026-01-01. (Invoices.) Tell me what it returned.
```

## The same task elsewhere

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