---
title: "Query account daily maximum concurrent test runs"
method: GET
path: "/accounts/{account_id}/reports/usage/maxTestRunConcurrency"
tags: ["Reporting"]
---

# Query account daily maximum concurrent test runs

`GET /accounts/{account_id}/reports/usage/maxTestRunConcurrency`

Same as `/workspaces/{workspace_id}/reports/usage/maxTestRunConcurrency` but returns one block per active workspace the authenticated caller has access to within the account. Each workspace's response includes its own `configured_test_run_concurrency_limit`, which can differ across workspaces in the same account (for example, one workspace might have a higher browser quota than another). Use this endpoint for account-wide capacity dashboards or to flag which workspaces are running near their limit.

Scope to a single workspace by passing its identifier as the `workspace_id` query parameter while still authenticating with account-level credentials. Time range, `test_type`, and default-range semantics are identical to the workspace-level endpoint.

## Path parameters

- `account_id` string, required

## Query parameters

- `start_time` integer
- `end_time` integer
- `test_type` 'api' | 'browser' | 'mobile' | 'performance'
- `workspace_id` string
- `include_configured_limit` boolean

## Response `200`

Daily maximum concurrent test run data per workspace in the account

- AccountMaxTestRunConcurrencyResponse — Daily maximum concurrent test run data for every workspace the caller has access to within an account. Each workspace carries its own `configured_test_run_concurrency_limit`, which may differ across workspaces in the same account.
  - `start_time` integer — Inclusive start of the queried time range as Unix epoch milliseconds, echoed from the request (or the default-derived value when the request omits it).
  - `end_time` integer — Exclusive end of the queried time range as Unix epoch milliseconds, echoed from the request (or the default-derived value when the request omits it).
  - `workspaces` WorkspaceMaxTestRunConcurrencyResponse[] — One entry per workspace in the account the caller has access to (or the single entry corresponding to the `workspace_id` query parameter when that is set). Each entry is a full `WorkspaceMaxTestRunConcurrencyResponse` including its own daily maximum test run concurrency buckets and configured limit.
    - `workspace_id` string — Identifier of the workspace this block describes. Always populated with this block's workspace identifier.
    - `start_time` integer — Inclusive start of the queried time range as Unix epoch milliseconds, echoed from the request (or the default-derived value when the request omits it).
    - `end_time` integer — Exclusive end of the queried time range as Unix epoch milliseconds, echoed from the request (or the default-derived value when the request omits it).
    - `configured_test_run_concurrency_limit` integer — The workspace's configured maximum concurrent test runs for the requested `test_type` at the time of the query. For `browser`, this is the sum of the workspace's Linux, macOS, and Windows browser quotas. For `api`, `mobile`, or `performance`, this is the single numeric quota for that resource. Returns `0` if the workspace has no configured quota for the requested test type. Compare `max_test_run_concurrency` against this value to see how close the workspace is running to its purchased capacity.
    - `time_buckets` UsageMaxTestRunConcurrencyBucket[] — Daily-only time buckets for this endpoint. One entry per UTC calendar day in the queried range that had any runs of the requested test type. Ordered by `bucket_start_time` ascending. Days with no runs are omitted.
      - `bucket_start_time` integer — Inclusive start of the day (midnight UTC) as Unix epoch milliseconds. Maximum test run concurrency is always computed against UTC calendar days.
      - `bucket_end_time` integer — Exclusive end of the day (midnight UTC of the next day) as Unix epoch milliseconds. Always 24 hours after `bucket_start_time`.
      - `max_test_run_concurrency` integer — Maximum number of test runs of the queried `test_type` that were executing simultaneously at any instant during this day. Computed via a sweep-line over run start/end times in the underlying billable events data.

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `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)
