---
title: "Read the authenticated tenant's hosted billing and usage status"
method: POST
path: "/api/v1/billing/status"
tags: ["Community SaaS"]
---

# Read the authenticated tenant's hosted billing and usage status

`POST /api/v1/billing/status`

## Request

- Base URL: `https://agent.getaxonflow.com`
- URL: `https://agent.getaxonflow.com/api/v1/billing/status`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/docs/api/v1/billing/status/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns subscription status, current monthly governed-event usage,
configured Hosted Starter limits, and whether a Stripe customer portal
can be opened. The response is tenant-isolated by authenticated scope
and PostgreSQL row-level security.

## Response `200`

Tenant billing status

- object
  - `status` 'payment_required' | 'pending' | 'active' | 'prepaid_active' | 'past_due' | 'canceled', required
  - `paid_until` string, date-time, nullable
  - `price_usd_monthly` string, required
  - `plan` object, required
  - `billing_portal_available` boolean, required
  - `launch_accepted` boolean, required
  - `usage` object, required

## Other responses

- `401`: Missing or invalid tenant credentials
- `503`: Billing status or usage storage is unavailable

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/revisions/34d30fcb7fa1?raw)