---
title: "Per-user seat utilization for an account"
method: GET
path: "/accounts/{account_id}/seats/usage"
tags: ["Account"]
---

# Per-user seat utilization for an account

`GET /accounts/{account_id}/seats/usage`

Per-user seat utilization for an account over a calendar month, classifying each active user as an automator or participant based on their automator-event count. 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
- `limit` integer
- `cursor` string

## Response `200`

Per-user seat utilization

- SeatUsage — Per-user seat utilization for an account
  - `account_id` string — Id of the account
  - `interval_start` integer — Start of the period, in epoch milliseconds
  - `interval_end` integer — End of the period, in epoch milliseconds
  - `users` SeatUsageUser[] — Per-user seat utilization
    - `user_id` string — The user's ID
    - `email` string — The user's email address
    - `name` string — The user's full name
    - `classification` 'automator' | 'participant' — automator if the user has at least 30 automator events in the month, otherwise participant
    - `events` integer — Number of automator events by this user in the month
    - `last_active_time` integer — The user's most recent activity in epoch milliseconds
  - `cursor` string — Cursor for fetching the next page of results. Null if no more results.

## 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)