> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Job throughput analytics for dashboard charts.

> Job throughput buckets

### Path parameters

<ParamField path="tenant_id" type="string" required>
  Tenant identifier
</ParamField>

### Query parameters

<ParamField query="hours" type="integer (int32)">
  Lookback window in hours (1-168, default 24)
</ParamField>

<ParamField query="bucket_minutes" type="integer (int32)">
  Bucket width in minutes (5-240, default 60)
</ParamField>

### Response

`JobThroughputResponse`

<ResponseField name="bucketMinutes" type="integer (int32)" required />

<ResponseField name="buckets" type="JobThroughputBucket[]" required>
  <Expandable title="JobThroughputBucket">
    <ResponseField name="bucketStart" type="string (date-time)" required />

    <ResponseField name="jobsCreated" type="integer (int64)" required />

    <ResponseField name="jobsFailed" type="integer (int64)" required />

    <ResponseField name="jobsFinished" type="integer (int64)" required />

    <ResponseField name="jobsSucceeded" type="integer (int64)" required />
  </Expandable>
</ResponseField>

<ResponseField name="generatedAt" type="string (date-time)" required />

<ResponseField name="partial" type="boolean" required />

<ResponseField name="scannedJobs" type="integer (int64)" required />

<ResponseField name="tenantId" type="string" required />

<ResponseField name="totalJobsHint" type="integer (int64)" />

<ResponseField name="totals" type="JobThroughputTotals" required>
  <Expandable title="JobThroughputTotals">
    <ResponseField name="jobsCreated" type="integer (int64)" required />

    <ResponseField name="jobsFailed" type="integer (int64)" required />

    <ResponseField name="jobsFinished" type="integer (int64)" required />

    <ResponseField name="jobsSucceeded" type="integer (int64)" required />
  </Expandable>
</ResponseField>

<ResponseField name="windowHours" type="integer (int32)" required />

### Status codes

| Code  | Meaning                |
| ----- | ---------------------- |
| `200` | Job throughput buckets |
| `401` | Unauthorized           |
| `422` | Validation error       |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/jobs/throughput' \
    --header 'x-stateset-api-key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "bucketMinutes": 1,
    "buckets": [
      {
        "bucketStart": "2026-08-31T14:22:05Z",
        "jobsCreated": 1,
        "jobsFailed": 1,
        "jobsFinished": 1,
        "jobsSucceeded": 1
      }
    ],
    "generatedAt": "2026-08-31T14:22:05Z",
    "partial": true,
    "scannedJobs": 1,
    "tenantId": "acme-outdoors",
    "totalJobsHint": 1,
    "totals": {
      "jobsCreated": 1,
      "jobsFailed": 1,
      "jobsFinished": 1,
      "jobsSucceeded": 1
    },
    "windowHours": 1
  }
  ```
</ResponseExample>