---
title: "Get Billing"
method: GET
path: "/api/v1/orgs/{org_id}/billing"
tags: ["billing"]
---

# Get Billing

`GET /api/v1/orgs/{org_id}/billing`

## Path parameters

- `org_id` string, uuid, required

## Response `200`

Successful Response

- union
  - BillingNotConfigured — No Stripe credential in this environment (local dev, CI).
    - `state` 'not_configured'
  - BillingUnlinked — No Stripe customer carries this org id. Carries the org id so the pane can show it with a copy control — this is how the operator learns the id, which does not exist until the customer bootstraps their own org.
    - `state` 'unlinked'
    - `org_id` string, uuid, required
  - BillingNoSubscription — Customer matched, no non-canceled subscription. Real and days-long.
    - `state` 'no_subscription'
  - BillingSubscribed — Exactly one customer, one live subscription, one recurring item.
    - `state` 'subscribed'
    - `status` string, required
    - `collection_method` string, required
    - `days_until_due` integer, nullable, required
    - `invoiced_seats` integer, required
    - `member_seats` integer, required
    - `unit_amount` integer, required
    - `currency` string, required
    - `current_period_ends_at` string, date-time, required
    - `cancel_at_period_end` boolean, required
  - BillingNeedsAttention — Ambiguous Stripe shape. Never guess which subscription is real.
    - `state` 'needs_attention'
  - BillingUnavailable — Stripe could not be reached or answered an error.
    - `state` 'unavailable'

## Other responses

- `4XX` — Client Error
- `5XX` — Server Error

---

[API](https://skmtc.dev/rudus/apis/rudus-api.md) · [All operations](https://skmtc.dev/rudus/apis/rudus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rudus/rudus-api/revisions/f149124a4d80/schema)