---
title: "List Seat balances by Customer"
method: GET
path: "/seat-balances"
tags: ["Seat Metrics"]
---

# List Seat balances by Customer

`GET /seat-balances`

List Seat balances grouped by Customer and seat type.

## Query parameters

- `excludeZeroQuantity` boolean
- `customerAliases` string
- `customerIds` string

## Headers

- `Authorization` string, required
- `Sequence-Version` '2024-07-30'

## Response `200`

OK

- ListCustomerSeatBalancesEndpointListCustomerSeatBalancesPaginatedResponseModel
  - `items` CustomerSeatBalances[], required — Seat balances
    - `id` string, required — Customer ID
    - `sequenceAccountId` string, required — Sequence Account ID
    - `legalName` string, required — Legal name
    - `customerAliases` string[], required
    - `total` integer, required — Total seats balance
    - `changeTimestamp` string, required — Timestamp of when the customer seats last changed
    - `balances` SeatBalance[], required — Seat balance per seat type
      - `seatType` string, required — Seat type
      - `total` integer, required — Total seats for this seat type
      - `changeTimestamp` string, required — Timestamp of change
  - `pagination` PaginationMeta3, required — Results pagination
    - `after` string, nullable — Cursor for the page after this (if it exists)
    - `before` string, nullable — Cursor for the page before this (if it exists)
    - `totalResultSize` integer, nullable — Total number of entries across all pages

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/sequencehq/apis/sequence.md) · [All operations](https://skmtc.net/sequencehq/apis/sequence/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequencehq/sequence/versions/cae64b02699f/schema)