---
title: "Get Jobs By Group Filter (Kanban)"
method: POST
path: "/jobs/group/filter"
---

# Get Jobs By Group Filter (Kanban)

`POST /jobs/group/filter`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/jobs/group/filter`
- Auth: API key in header `x-api-key`

Returns, per job status within a category, a capped list of jobs plus the full count — the Job Kanban board's per-column data. Does not check the enable_kanban_view company policy (unlike Get Jobs Summary). Returns 200 with an empty array if the category has no statuses.

## Request body

- object
  - `job_category_uid` string, required
  - `filter_rules` object[]
  - `sort` 'ASC' | 'DESC'
  - `sort_by` 'created_at' | 'updated_at' | 'job_title' | 'job_priority' | 'scheduled_start_time' | 'due_date' | 'work_order_number' | 'work_order_string' | 'job_total' | 'job_category.category_name'
  - `count` integer: Max jobs returned per status column.
  - `fields_to_select` string: Comma-separated top-level keys to restrict the job object to. job_total is always included.

## Response `200`

200

## Other responses

- `404`: 404

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/jobs/group/filter/post.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)