---
title: "Inspect account billing"
description: "Returns the account's plan, Free or Pro (an active Stripe subscription), whether it may hold VMs, its site limit, the Stripe subscription status, the monthly Pro price, the VM quota, and the…"
canonical: "https://www.cool.computer/docs/api-reference/billing/inspect-account-billing"
---
# Inspect account billing

> Returns the account's plan, Free or Pro (an active Stripe subscription), whether it may hold VMs, its site limit, the Stripe subscription status, the monthly Pro price, the VM quota, and the…

```http
GET https://api.cool.computer/api/billing
```

Returns the account's plan, Free or Pro (an active Stripe subscription), whether it may hold VMs, its site limit, the Stripe subscription status, the monthly Pro price, the VM quota, and the per-computer guest-memory ceiling.

## Authorization

- A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

## Responses

- `200`: The account billing status.
  - `application/json` (object)
    - `plan` ("free" or "pro", required): pro while the Stripe subscription is active; free otherwise, including after Pro lapses.
    - `compute_allowed` (boolean, required): Whether the account may hold and use VMs: true on Pro. On Free, its computers with a VM are fenced until it is Pro again; its sites keep serving.
    - `site_limit` (integer or null, required): How many sites the account holds at once, with a VM or without: 20 on Free, null (any number) on Pro. Creating or claiming a site past it answers 403 site_limit_reached.
    - `subscription_status` ("none" or "incomplete" or "incomplete_expired" or "active" or "past_due" or "canceled" or "unpaid" or "paused" or "unmanaged", required)
    - `price_cents` (2000, required)
    - `currency` ("usd", required)
    - `interval` ("month", required)
    - `computer_limit` (20, required): VMs a Pro account holds at once.
    - `guest_memory_ceiling_mib` (8192, required): Guest-visible memory ceiling for each live computer. Physical residency is measured and not pre-allocated per computer.
    - `account_memory_limit_mib` (8192, required): Memory all of the account's computers may hold together, idle ones included. It is a ceiling, not a reservation: one busy computer may use whatever the account's idle computers leave, about 110 MiB each.
    - `checkout_available` (boolean, required)
    - `management_available` (boolean, required)
    - `renews_at` (string or null, date-time, required): When the paying subscription next renews; null when it is set to end, or when no paying subscription or period is known.
    - `ends_at` (string or null, date-time, required): When a paying subscription set to cancel ends; null otherwise.
- `401`: Unauthorized.
- `429`: Too Many Requests. If the problem code is api_request_rate_exceeded, wait for Retry-After seconds; other problem codes describe a separate limit.
- `500`: Internal Server Error.
- `default`: A machine-readable API error with a stable code and recovery instruction.

An error is an `application/problem+json` document with a stable `code`; [API errors](/docs/api-reference/errors) says how to handle one.

## Example

```sh
curl "https://api.cool.computer/api/billing" \
  -H "authorization: Bearer $TOKEN"
```
