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

**Billing standing.** Read your company's billing standing: whether an unpaid invoice is on the non-payment ladder, every date the Control Panel has told you about (the final notice, the suspension date, termination and the retrieval deadline), any pause, the services involved and how to restore them. Read only. Scope: read.

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

## When to use it

Read your company's billing standing: whether an unpaid invoice is on the non-payment ladder, every date the Control Panel has told you about, any pause, the services involved and how to restore them. Read only.

Through the REST API (`/api/corestack/billing/standing`) the same read is `standing`; `account_id`, this tool's name, is accepted there as the alias of the page's `account`.

## 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

- `billing_forbidden`: your account does not have billing rights (ask the company owner).
- `tenant_mismatch`: `account_id` is not one of your company's accounts.
- The refusals every tool can answer: `invalid_arguments`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

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

## The answer

- `state`: `good`, `overdue`, `final_notice`, `suspended` or `retrieval` — the most advanced fact of the account.
- `cases[]`: one per open unpaid invoice: `invoice_id`, `number`, `outstanding`, `currency`, `due_at`, `overdue_days`, `stage`, `final_notice_at`, `suspend_on`, `suspended_at`, `terminate_on`, `terminated_at`, `retrieval_until`, `delete_on`, `disputed`.
- `paused_until`: the company's pause, or null. A pause holds every step.
- `suspended_services[]`: `type` (`site` or `cluster`), `id`, `name`, `since`, `phase` (`suspended` or `retrieval`).
- `restore`: how to put things right. While suspended: `how = pay_invoices`, with `invoice_ids`, `pay_urls` (open one in a browser to pay), `automatic = true` and the `promise`. In retrieval: `how = staff_reinstatement`, `automatic = false`, `retrieval_until`, `contact`, and `settled` once paid. While deleting: `how = none`.

Paying is always done in a browser: this server never moves money.

## Prompt

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

## The same task elsewhere

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