---
title: "List action items"
method: GET
path: "/action_item"
tags: ["Action Item"]
---

# List action items

`GET /action_item`

List action items with filtering, sorting, and pagination.

Default sort order is by score descending, then by creation date descending.

## Query parameters

- `nrn` string
- `status` 'open' | 'in_progress' | 'pending_deferral' | 'deferred' | 'pending_verification' | 'resolved' | 'pending_rejection' | 'rejected' | 'closed'
- `status_not_in` string
- `category_id` string
- `priority` 'low' | 'medium' | 'high' | 'critical'
- `created_by` string
- `assignee_id` string
- `assigned` boolean
- `due_date_before` string, date
- `due_date_after` string, date
- `min_value` number
- `max_value` number
- `sort` 'score' | 'value' | 'priority' | 'createdAt' | 'dueDate'
- `order` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Response `200`

A paginated list of action items.

- object
  - `results` ActionItem[]
    - `id` string — The unique action item ID.
    - `slug` string — Auto-generated URL-friendly slug.
    - `nrn` string — The NRN that owns this action item.
    - `title` string — The title.
    - `description` string — The description. Supports Markdown.
    - `status` 'open' | 'in_progress' | 'pending_deferral' | 'deferred' | 'pending_verification' | 'resolved' | 'pending_rejection' | 'rejected' | 'closed' — The current status.
    - `priority` 'low' | 'medium' | 'high' | 'critical' — Priority level.
    - `score` integer — Calculated score based on value and priority.
    - `category_id` string — The category ID.
    - `value` number — Estimated benefit of resolving the item.
    - `created_by` string — The creator email or agent identifier.
    - `assignee_id` integer — The nullplatform user ID of the item's owner, or `null` when nobody owns it.
    - `assigned_at` string, date-time — When the current assignment was made. ISO 8601 date-time.
    - `assigned_by` string — Who made the current assignment: a user email or an agent identifier.
    - `due_date` string, date-time — Optional deadline. ISO 8601 date-time.
    - `deferred_until` string, date — Date until which the item is deferred.
    - `resolved_at` string, date — Date when the item was resolved.
    - `labels` object — Key-value pairs for classification.
    - `affected_resources` AffectedResource[]
      - `type` string — The resource type.
      - `name` string — The resource name.
      - `permalink` string — A link to the resource.
      - `description` string — A brief description.
    - `references` Reference[]
      - `name` string — The reference name.
      - `permalink` string — A link to the reference.
      - `description` string — A brief description.
    - `metadata` object — Flexible metadata.
    - `deferral_count` integer — Number of times this item has been deferred.
    - `config` CategoryConfig — Deferral limits for a category. Approval gating for resolve, defer, and reject is no longer configured here. It is driven by approval actions in the approvals engine. See the `action_item` entity in the Approval API.
      - `max_deferral_days` integer — Maximum number of days an item can be deferred into the future.
      - `max_deferral_count` integer — Maximum number of times an item can be deferred.
    - `comments` Comment[] — Comments on this item. Populated on read.
      - `id` string — The comment ID.
      - `author` string — The comment author.
      - `content` string — The comment text.
      - `created_at` string, date-time — Creation timestamp.
    - `audit_logs` AuditLog[] — Audit trail of all status transitions and field updates on this item.
      - `id` string — The unique audit log entry ID.
      - `actor` string — The email of the user who performed the action.
      - `action` string — The action that was performed.
      - `details` object — Additional context about the action, such as previous and new status or the deferral reason.
      - `timestamp` string, date-time — When the action was performed.
    - `created_at` string, date-time — Creation timestamp.
    - `updated_at` string, date-time — Last update timestamp.
  - `pagination` Pagination — Pagination metadata returned with list responses.
    - `offset` integer — The current pagination offset.
    - `limit` integer — The number of results returned per page.
    - `total` integer — The total number of items matching the query.

## Other responses

- `4XX` — Client error responses due to invalid input, missing parameters, or unauthorized access. Request validation errors use a different shape: ```json { "type": "ValidationError", "errors": [{ "message": "body must have required property 'defer_until'" }] } ```
- `5XX` — Server error responses indicating an issue on the API side.

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)