---
title: "Get Team Billing"
method: GET
path: "/billing/teams/{team_id}"
tags: ["billing"]
---

# Get Team Billing

`GET /billing/teams/{team_id}`

Team billing snapshot: tier, seats, pool balance, reset date.

## Path parameters

- `team_id` string, required

## Response `200`

Successful Response

- TeamBillingStatusResponse — GET /billing/teams/{id} — the team's billing snapshot for the UI.
  - `team_id` string, required
  - `tier` 'free' | 'pro' | 'teams' | 'admin', required
  - `billing_access_source` 'none' | 'subscription' | 'comped' | 'legacy_unknown', required
  - `subscription_status` 'pending' | 'active' | 'past_due' | 'on_hold' | 'paused' | 'cancelled' | 'failed' | 'expired', nullable
  - `cancel_at_period_end` boolean
  - `current_period_end` string, date-time, nullable
  - `past_due_ends_at` string, date-time, nullable
  - `billing_interval` string, required
  - `seat_limit` integer, required
  - `billed_seat_quantity` integer, nullable
  - `seats_used` integer, required
  - `seat_reconciliation_required` boolean
  - `pool_balance_cents` integer, required
  - `pool_balance_dollars` number, required
  - `monthly_credit_reset_at` string, date-time, nullable
  - `has_subscription` boolean
  - `has_billing_account` boolean

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-12** `ab200f4d1489` — 7 info
  - added the optional property `billed_seat_quantity` to the response with the `200` status
  - added the optional property `cancel_at_period_end` to the response with the `200` status
  - added the optional property `current_period_end` to the response with the `200` status
  - added the optional property `past_due_ends_at` to the response with the `200` status
  - …3 more

[Change history](https://skmtc.dev/repowise/apis/repowise-hosted-api/changes/billing/teams/:team_id/get.md)

---

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