---
title: "Get Cloud billing state"
method: GET
path: "/api/cloud/billing/state"
tags: ["Cloud"]
---

# Get Cloud billing state

`GET /api/cloud/billing/state`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/cloud/billing/state`
- Auth: API key in cookie `hk_token`

Returns authoritative billing state for the authenticated active Cloud team. Requires team.manage_settings. A pending plan is reported only while checkout is pending; a paid plan is never described as Free.

## Response `200`

Cloud billing state

- object
  - `billing` 'monthly' | 'annual'
  - `pending_plan_code` 'pro' | 'business'
  - `plan_code` string, required
  - `subscription_status` string, required
  - `team_id` string, uuid, required

## Other responses

- `401`: Unauthorized
- `403`: Team billing access denied
- `404`: Cloud not hosted

---

[API](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api.md) · [All operations](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/revisions/bb2df36ab2a4?raw)