---
title: "Get Seat Change Preview"
method: GET
path: "/billing/team/{team_id}/seat-preview"
tags: ["billing"]
---

# Get Seat Change Preview

`GET /billing/team/{team_id}/seat-preview`

Preview cost impact of adding or removing seats without applying changes.

Requires MANAGE_BILLING permission.

Args:
    team_id: Team UUID.
    action: Either 'add' or 'remove'.
    count: Number of seats to change.
    auth: Authenticated user context.

Returns:
    SeatChangePreview with current/new seat counts and pricing.

## Path parameters

- `team_id` string, required

## Query parameters

- `action` string, required — 'add' or 'remove'
- `count` integer — Number of seats to add/remove

## Response `200`

Successful Response

- SeatChangePreview — Preview of a seat-count change before it is applied.
  - `current_seats` integer, required — Current number of seats
  - `new_seats` integer, required — Seat count after the change
  - `unit_price` integer, required — Price per seat in whole dollars
  - `interval` string, required — Billing interval: 'month' or 'year'
  - `new_total` integer, required — New total cost per interval in whole dollars
  - `proration_amount` integer, nullable — Estimated proration charge in whole dollars, if available

## 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/revisions/31dfe831e079/schema)