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

**Billing contracts.** List a billing account's active contract lines: what each covers and what it costs a month. Scope: read.

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

## When to use it

List a billing account's active contract lines: what each covers and what it costs a month.

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.

### 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"
    }
  },
  "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_contracts_list",
  "arguments": {}
}
```

## The answer

One row per contract line. Each line's `contract` says when that contract bills from, in the words the Control Panel's Billing page uses:

- `billing_starts`: `started`, or `on_delivery` while its site or CoreCluster is still being created. Nothing is billed for it and its free trial has not started yet.
- `billing_starts_at`: the first hour it bills (ISO 8601, UTC). When a create took longer to finish, it is when the site or CoreCluster was first ready, and the free trial runs its full length from then. It is `null` while the contract is `on_delivery`, and for a contract opened before this field existed (its `starts_on` is then its first day).
- `billing_starts_note`: the sentence to show while the contract is `on_delivery`, "Billing starts when your site is ready." or "Billing starts when your CoreCluster is ready."; otherwise `null`.
- `billing_period`: `monthly` or `annual` — how often the contract is invoiced.
- `first_billed_at`: the first hour the contract was charged for (ISO 8601, UTC), or `null` while nothing has been charged yet (during a free trial).
- `money_back`: the money-back guarantee it was opened with — `{days, until, state}` — or `null` when it carries none. `until` is when the window ends (ISO 8601, UTC), or `null` until the first paid hour ("from your first paid day"); `state` is `available`, `claimed`, `refunded` or `expired`.

## Prompt

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

## The same task elsewhere

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