---
title: "Get billing status"
method: GET
path: "/billing/status"
tags: ["billing"]
---

# Get billing status

`GET /billing/status`

## Request

- Base URL: `https://storeinspect.com/api/v1`
- URL: `https://storeinspect.com/api/v1/billing/status`
- Auth: HTTP bearer

Returns the current plan, subscription state, billing cadence, contact credits, and whether paid API access is active. Existing valid API keys can use this endpoint while billing is inactive.

## Response `200`

Current billing state for the API key owner.

- BillingStatusResponse
  - `object` 'billing_status', required
  - `plan` object, required
    - `slug` 'free' | 'pro' | 'business' | 'enterprise', required
    - `name` string, required
    - `status` string, required
    - `billing` 'monthly' | 'annual' | 'null', nullable, required
    - `trial` object, required
      - `active` boolean, required
      - `ends_at` string, date-time, nullable, required
    - `cancel_at_period_end` boolean, required
    - `current_period_end` string, date-time, nullable, required
  - `api_access` object, required
    - `enabled` boolean, required
  - `contact_credits` object, required
    - `total` integer, required
    - `used` integer, required
    - `remaining` integer, required
  - `has_billing_account` boolean, required
  - `actions` object, required
    - `can_create_subscription_link` boolean, required
    - `can_manage_billing` boolean, required
  - `request_id` string, required

## Other responses

- `401`: Missing, invalid, revoked, or suspended API key.
- `403`: The API key does not have billing:read.
- `429`: Too many billing status requests.

---

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