---
title: "Get team billing"
method: GET
path: "/v1/teams/{teamId}/billing"
tags: ["Teams"]
---

# Get team billing

`GET /v1/teams/{teamId}/billing`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/teams/{teamId}/billing`
- Auth: HTTP bearer

Returns the team's plan, subscription state, and billable usage meters.

## Path parameters

- `teamId` string, required

## Query parameters

- `checkoutSessionId` string

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `checkout` object, nullable, required
      - `planCode` 'free' | 'go' | 'plus' | 'gold' | 'enterprise' | 'internal', required: Plan code.
      - `status` 'processing' | 'activated' | 'failed', required
    - `teamId` string, required
    - `planCode` 'free' | 'go' | 'plus' | 'gold' | 'enterprise' | 'internal', required: Plan code.
    - `billingCustomerRefs` object[], required
      - `id` string, required
      - `provider` 'stripe', required
      - `accountKey` string, required
      - `stripeCustomerId` string, nullable, required
      - `diagnostics` object
    - `subscriptions` object[], required
      - `id` string, required
      - `provider` 'stripe', required
      - `planCode` 'free' | 'go' | 'plus' | 'gold' | 'enterprise' | 'internal', nullable, required: Plan code.
      - `status` string, required
      - `providerStatus` string, nullable, required
      - `currentPeriodEnd` string, date-time, nullable, required
      - `cancelAtPeriodEnd` boolean, nullable, required
      - `diagnostics` object
    - `resourceCharges` object[], required
      - `id` string, required
      - `subjectType` 'site' | 'space' | 'domain', required
      - `kind` string, required
      - `status` string, required
      - `graceUntil` string, date-time, nullable, required
    - `seatBilling` object, required
      - `billableSeats` integer, nullable, required
    - `stripeCustomerId` string, nullable, required: Deprecated compatibility field.
    - `subscription` object, nullable, required: Deprecated compatibility field.
      - `id` string, required
      - `provider` 'stripe', required
      - `planCode` 'free' | 'go' | 'plus' | 'gold' | 'enterprise' | 'internal', nullable, required: Plan code.
      - `status` string, required
      - `providerStatus` string, nullable, required
      - `currentPeriodEnd` string, date-time, nullable, required
      - `cancelAtPeriodEnd` boolean, nullable, required
      - `diagnostics` object
    - `usage` object, required
      - `storageBytes` integer, required
      - `storageQuotaBytes` union, required: Plan limit value; "unlimited" when the plan does not limit this axis.
        - integer
        - 'unlimited'
      - `storageOverageBytes` integer, required
      - `buildsDeploysToday` integer, required: Publishes and builds pooled into one meter for the current UTC day.
      - `buildsDeploysDaily` union, required: Pooled daily plan allowance for publishes and builds. Passing it warns; it never blocks.
        - integer
        - 'unlimited'
      - `buildsDeploysThisMonth` integer
      - `buildsDeploysMonthly` union: Plan limit value; "unlimited" when the plan does not limit this axis.
        - integer
        - 'unlimited'

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

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