---
title: "Account seat allocation and utilization"
method: GET
path: "/accounts/{account_id}/seats"
tags: ["Account"]
---

# Account seat allocation and utilization

`GET /accounts/{account_id}/seats`

Allocated, used, and available seats for an account, split by automator and participant.  Available is max(allocated - used, 0). Available to company administrators and company-scoped API keys (USER_MANAGEMENT or REPORTING).

## Path parameters

- `account_id` string, required

## Query parameters

- `month` integer
- `year` integer

## Response `200`

Seat allocation and utilization summary

- SeatSummary — Seat allocation and utilization for an account
  - `account_id` string — Id of the account
  - `interval_start` integer — Start of the period the used counts cover, in epoch milliseconds
  - `interval_end` integer — End of the period the used counts cover, in epoch milliseconds
  - `has_subscription` boolean — False for accounts with no subscription; total/available are then omitted.
  - `automators` SeatCount — Allocated, used, and available counts for a single seat class
    - `total` integer — Allocated seats for this class. Omitted when the account has no subscription.
    - `used` integer — Seats consumed for the queried month.
    - `available` integer — max(total - used, 0). Omitted when total is unknown.
  - `participants` SeatCount — Allocated, used, and available counts for a single seat class
    - `total` integer — Allocated seats for this class. Omitted when the account has no subscription.
    - `used` integer — Seats consumed for the queried month.
    - `available` integer — max(total - used, 0). Omitted when total is unknown.

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Account not found
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)