---
title: "Search work items with filtering, sorting, and pagination"
method: POST
path: "/work-center-service/work-items/search"
tags: ["Work Center Service"]
---

# Search work items with filtering, sorting, and pagination

`POST /work-center-service/work-items/search`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/work-center-service/work-items/search`
- Auth: none declared

Searches work items with filtering, sorting, and pagination.

## Request body

- object
  - `filters` WorkCenterServiceWorkItemsSearchPostRequestBodyContentApplicationJsonSchemaFiltersItems[]: Filter criteria. Multiple filters are ANDed together.
    - `field` 'name' | 'summary' | 'owner' | 'createdAt' | 'executionStartTime' | 'triggerType' | 'triggerLabel' | 'executionName' | 'executionDescription', required: The field name to filter on.
    - `operator` 'contains' | 'equals' | 'in' | 'before' | 'after', required: The filter operator.
    - `value` string, required: The filter value. Can be a string, array of strings, or null.
  - `sort` WorkCenterServiceWorkItemsSearchPostRequestBodyContentApplicationJsonSchemaSort: Sort configuration. Defaults to createdAt descending.
    - `field` 'createdAt' | 'executionStartTime' | 'triggerLabel' | 'triggerType' | 'executionName' | 'owner' | 'name' | 'summary' | 'executionDescription', required: The field to sort by.
    - `order` 'asc' | 'desc', required: The sort direction.
  - `skip` number, double: Number of items to skip. Defaults to 0.
  - `limit` number, double: Number of items to return (1-100). Defaults to 25.

## Response `200`

Paginated work item summaries

- WorkCenterServiceSearchWorkItemsResponse200
  - `data` WorkCenterServiceWorkItemsSearchPostResponsesContentApplicationJsonSchemaDataItems[], required: Paginated list of work item summaries.
    - `id` string, uuid, required: Unique identifier (UUID) of the work item.
    - `name` string, required: Human-readable name of the work item.
    - `summary` string, required: Brief summary of the work item.
    - `status` 'pending' | 'completed' | 'canceled', required: Current status of the work item.
    - `groups` WorkCenterServiceWorkItemsSearchPostResponsesContentApplicationJsonSchemaDataItemsGroups, required: Access control groups.
      - `read` string[], required: Array of group identifiers with read access to the work item.
      - `write` string[], required: Array of group identifiers with write access to the work item.
    - `rootExecution` WorkCenterServiceWorkItemsSearchPostResponsesContentApplicationJsonSchemaDataItemsRootExecution, required: Root execution metadata.
      - `id` string, required: Unique identifier of the root execution that started the ancestry chain.
      - `name` string, required: Human-readable name of the root execution.
      - `url` string: Optional URL to access the root execution (e.g., workflow execution UI link).
      - `trigger` WorkCenterServiceWorkItemsSearchPostResponsesContentApplicationJsonSchemaDataItemsRootExecutionTrigger, required: Trigger information defining what initiated the root execution.
        - `type` 'manual' | 'endpoint' | 'schedule' | 'eventSystem' | 'job' | 'session', required: Type of trigger that initiated the work item.
        - `label` string, required: Human-readable label for the trigger.
      - `startTime` string, date-time, required: ISO 8601 timestamp when the root execution started.
    - `execution` WorkCenterServiceWorkItemsSearchPostResponsesContentApplicationJsonSchemaDataItemsExecution, required: Execution that invoked createWorkItem.
      - `id` string, required: Unique identifier of the running job or session that invoked createWorkItem.
      - `name` string, required: Human-readable name of the parent job or session.
      - `type` string, required: Opaque execution type passed to the ancestry adapter (e.g. job, session).
      - `url` string: Optional URL to access the execution.
      - `description` string: Optional description of the execution, useful for differentiating between concurrent executions.
    - `metrics` WorkCenterServiceWorkItemsSearchPostResponsesContentApplicationJsonSchemaDataItemsMetrics, required: Work item operational metrics.
      - `owner` string, required: Account ID of the operator who claimed the work item.
      - `ownerUsername` string: Resolved username of the operator who claimed the work item.
      - `claimTime` string, required: ISO 8601 timestamp when the work item was claimed.
      - `finishState` string, required: Opaque finish state string emitted by the view component on completion.
    - `createdAt` string, required: ISO 8601 creation timestamp.
    - `updatedAt` string, required: ISO 8601 last updated timestamp.

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Work Center Service` added
  - api tag `workCenterService` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/work-center-service/work-items/search/post.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)