---
title: "Get Team Full Billing Status"
method: GET
path: "/billing/team/{team_id}/full-status"
tags: ["billing"]
---

# Get Team Full Billing Status

`GET /billing/team/{team_id}/full-status`

Get full billing status for a team (for billing/admin/owner roles).

This endpoint returns comprehensive billing information including
payment methods, usage, and credit limits.

Requires: MANAGE_BILLING permission (owner, admin, or billing role)

Args:
    team_id: Team UUID
    auth: Authenticated user context

Returns:
    Full team billing status including payment methods and usage

## Path parameters

- `team_id` string, required

## Response `200`

Successful Response

- TeamBillingFullStatusResponse — Full billing status for a team (for billing/admin/owner roles).
  - `team_id` string, required
  - `team_name` string, required
  - `payment_plan` string, required
  - `has_payment_method` boolean, required
  - `payment_methods` PaymentMethodInfo[]
    - `id` string, required
    - `type` string
    - `brand` string, required
    - `last4` string, required
    - `exp_month` integer, nullable
    - `exp_year` integer, nullable
    - `billing_name` string, nullable
    - `billing_address` BillingAddress — Billing address on file for a payment method, as held by Stripe. All fields are optional because Stripe only returns the components the customer provided. The UI renders this read-only; it is never edited in Pioneer (changes are made in the Stripe customer portal).
      - `line1` string, nullable
      - `line2` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postal_code` string, nullable
      - `country` string, nullable
  - `billing_name` string, nullable — Customer-level billing name on file in Stripe (display-only).
  - `billing_address` BillingAddress — Billing address on file for a payment method, as held by Stripe. All fields are optional because Stripe only returns the components the customer provided. The UI renders this read-only; it is never edited in Pioneer (changes are made in the Stripe customer portal).
    - `line1` string, nullable
    - `line2` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postal_code` string, nullable
    - `country` string, nullable
  - `total_usage` number, required
  - `credit_limit` number, required
  - `free_tier_remaining` number, required
  - `exceeds_free_tier` boolean, required
  - `cancel_at_period_end` boolean — True when the subscription is scheduled to cancel at the end of the current billing period.
  - `current_period_end` string, nullable — ISO timestamp when the current billing period ends. Present when cancel_at_period_end is true.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)