---
title: "Get aggregated status counts for multiple jobs."
method: POST
path: "/jobs/status_aggregated"
tags: ["structure"]
---

# Get aggregated status counts for multiple jobs.

`POST /jobs/status_aggregated`

Returns counts of jobs by status (completed, running, failed, queued).
Exactly one of job_ids or dataset_name must be provided.
This endpoint can handle large numbers of job IDs since it returns aggregated data instead of individual job details.

## Request body

- AggregatedJobRequest
  - `dataset_name` string, nullable
  - `job_ids` JobId[], nullable
  - `node_id` string, uuid

## Response `200`

Aggregated status counts for specified jobs.

- JobCount
  - `completed` integer, required
  - `failed` integer, required
  - `queued` integer, required
  - `running` integer, required
  - `total` integer, required

## Other responses

- `400` — Bad request - exactly one of job_ids or dataset_name must be provided.

---

[API](https://skmtc.dev/structifyai/apis/structify.md) · [All operations](https://skmtc.dev/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/structifyai/structify/revisions/1364930b6980/schema)