---
id: action-item-list
title: "List action items"
description: "List action items with filtering, sorting, and pagination."
sidebar_label: "List action items"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/action-items
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List action items"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/action_item"}
  context={"endpoint"}
>
  
</MethodEndpoint>



List action items with filtering, sorting, and pagination.

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


<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"query","name":"nrn","schema":{"type":"string"},"required":false,"description":"Filter by NRN (partial match supported).","example":"organization=1:account=2:namespace=3:application=4"},{"in":"query","name":"status","schema":{"type":"string","enum":["open","in_progress","pending_deferral","deferred","pending_verification","resolved","pending_rejection","rejected","closed"]},"required":false,"description":"Filter by status. Use `status[]` for multiple values.","example":"open"},{"in":"query","name":"status_not_in","schema":{"type":"string"},"required":false,"description":"Comma-separated statuses to exclude.","example":"closed,rejected"},{"in":"query","name":"category_id","schema":{"type":"string"},"required":false,"description":"Filter by category ID.","example":"abc123def456"},{"in":"query","name":"priority","schema":{"type":"string","enum":["low","medium","high","critical"]},"required":false,"description":"Filter by priority level.","example":"critical"},{"in":"query","name":"created_by","schema":{"type":"string"},"required":false,"description":"Filter by creator (user email or agent identifier).","example":"security-scanner-agent"},{"in":"query","name":"assignee_id","schema":{"type":"string"},"required":false,"description":"Filter by owner. Accepts a comma-separated list of nullplatform user IDs, and the token `none` for items nobody owns, so `none,2345` returns the unassigned pool together with the items owned by user `2345`.\n","example":"none,2345"},{"in":"query","name":"assigned","schema":{"type":"boolean"},"required":false,"description":"Filter by whether the item has an owner at all. Ignored when `assignee_id` is also present, since that filter is more specific.","example":false},{"in":"query","name":"due_date_before","schema":{"type":"string","format":"date"},"required":false,"description":"Filter items with a due date before this date.","example":"2026-06-01"},{"in":"query","name":"due_date_after","schema":{"type":"string","format":"date"},"required":false,"description":"Filter items with a due date after this date.","example":"2026-04-01"},{"in":"query","name":"min_value","schema":{"type":"number"},"required":false,"description":"Filter items with a value greater than or equal to this amount.","example":100},{"in":"query","name":"max_value","schema":{"type":"number"},"required":false,"description":"Filter items with a value less than or equal to this amount.","example":10000},{"in":"query","name":"sort","schema":{"type":"string","enum":["score","value","priority","createdAt","dueDate"]},"required":false,"description":"Sort field. Defaults to `score`.","example":"score"},{"in":"query","name":"order","schema":{"type":"string","enum":["asc","desc"]},"required":false,"description":"Sort direction. Defaults to `desc`.","example":"desc"},{"in":"query","name":"limit","schema":{"type":"integer","maximum":100},"required":false,"description":"Number of results per page. Max 100, default 25.","example":25},{"in":"query","name":"offset","schema":{"type":"integer"},"required":false,"description":"Pagination offset.","example":0}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"A paginated list of action items.","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique action item ID.","example":"xYz789AbCdEf"},"slug":{"type":"string","description":"Auto-generated URL-friendly slug.","example":"upgrade-base-image-to-fix-cve-2026-1234"},"nrn":{"type":"string","description":"The NRN that owns this action item.","example":"organization=1:account=2:namespace=3:application=4"},"title":{"type":"string","description":"The title.","example":"Upgrade base image to fix CVE-2026-1234"},"description":{"type":"string","description":"The description. Supports Markdown.","example":"The current base image has a critical vulnerability."},"status":{"type":"string","enum":["open","in_progress","pending_deferral","deferred","pending_verification","resolved","pending_rejection","rejected","closed"],"description":"The current status.","example":"open"},"priority":{"type":"string","enum":["low","medium","high","critical"],"description":"Priority level.","example":"critical"},"score":{"type":"integer","description":"Calculated score based on value and priority.","example":2000},"category_id":{"type":"string","description":"The category ID.","example":"abc123def456"},"value":{"type":"number","description":"Estimated benefit of resolving the item.","example":500},"created_by":{"type":"string","description":"The creator email or agent identifier.","example":"security-scanner-agent"},"assignee_id":{"type":"integer","description":"The nullplatform user ID of the item's owner, or `null` when nobody owns it.","example":2345},"assigned_at":{"type":"string","format":"date-time","description":"When the current assignment was made. ISO 8601 date-time.","example":"2026-08-20T14:32:00Z"},"assigned_by":{"type":"string","description":"Who made the current assignment: a user email or an agent identifier.","example":"jane@example.com"},"due_date":{"type":"string","format":"date-time","description":"Optional deadline. ISO 8601 date-time.","example":"2026-05-01T00:00:00Z"},"deferred_until":{"type":"string","format":"date","description":"Date until which the item is deferred.","example":null},"resolved_at":{"type":"string","format":"date","description":"Date when the item was resolved.","example":null},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Key-value pairs for classification.","example":{"source":"container-scan","cve":"CVE-2026-1234"}},"affected_resources":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"The resource type.","example":"application"},"name":{"type":"string","description":"The resource name.","example":"my-api-service"},"permalink":{"type":"string","description":"A link to the resource.","example":"https://app.nullplatform.com/applications/4"},"description":{"type":"string","description":"A brief description.","example":"Main API service"}},"title":"AffectedResource"}},"references":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The reference name.","example":"CVE-2026-1234"},"permalink":{"type":"string","description":"A link to the reference.","example":"https://nvd.nist.gov/vuln/detail/CVE-2026-1234"},"description":{"type":"string","description":"A brief description.","example":"NVD entry for this vulnerability"}},"title":"Reference"}},"metadata":{"type":"object","description":"Flexible metadata.","example":{"cve_id":"CVE-2026-1234"}},"deferral_count":{"type":"integer","description":"Number of times this item has been deferred.","example":0},"config":{"type":"object","description":"Deferral limits for a category. Approval gating for resolve, defer, and reject\nis no longer configured here. It is driven by approval actions in the approvals\nengine. See the `action_item` entity in the Approval API.\n","properties":{"max_deferral_days":{"type":"integer","description":"Maximum number of days an item can be deferred into the future.","example":90},"max_deferral_count":{"type":"integer","description":"Maximum number of times an item can be deferred.","example":3}},"title":"CategoryConfig"},"comments":{"type":"array","description":"Comments on this item. Populated on read.","items":{"type":"object","properties":{"id":{"type":"string","description":"The comment ID.","example":"cmt123AbCdEf"},"author":{"type":"string","description":"The comment author.","example":"jane@example.com"},"content":{"type":"string","description":"The comment text.","example":"This should be prioritized for the next sprint."},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp.","example":"2026-04-06T14:30:00.000Z"}},"title":"Comment"}},"audit_logs":{"type":"array","description":"Audit trail of all status transitions and field updates on this item.","items":{"type":"object","description":"A single audit log entry recording a status transition or field update on an action item.","properties":{"id":{"type":"string","description":"The unique audit log entry ID.","example":"3c35f973-d53b-4e60-a578-2e8fba1dbbb1"},"actor":{"type":"string","description":"The email of the user who performed the action.","example":"jane@example.com"},"action":{"type":"string","description":"The action that was performed.","example":"deferred"},"details":{"type":"object","description":"Additional context about the action, such as previous and new status or the deferral reason.","example":{"from":"open","to":"deferred","reason":"Waiting for the next maintenance window."}},"timestamp":{"type":"string","format":"date-time","description":"When the action was performed.","example":"2026-04-06T12:00:00.000Z"}},"title":"AuditLog"}},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp.","example":"2026-04-06T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp.","example":"2026-04-06T12:00:00.000Z"}},"title":"ActionItem"}},"pagination":{"type":"object","description":"Pagination metadata returned with list responses.","properties":{"offset":{"type":"integer","description":"The current pagination offset.","example":0},"limit":{"type":"integer","description":"The number of results returned per page.","example":25},"total":{"type":"integer","description":"The total number of items matching the query.","example":42}},"title":"Pagination"}}}}}},"4XX":{"description":"Client error responses due to invalid input, missing parameters, or unauthorized access.\n\nRequest validation errors use a different shape:\n```json\n{\n  \"type\": \"ValidationError\",\n  \"errors\": [{ \"message\": \"body must have required property 'defer_until'\" }]\n}\n```\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Standard error response.","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"Machine-readable error code.","example":"bad_request"},"error":{"type":"string","description":"Short description of the error type.","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}},{"type":"object","description":"Request validation error response.","required":["type","errors"],"properties":{"type":{"type":"string","example":"ValidationError"},"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","example":"body must have required property 'until'"}}}}}}]}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error.","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type.","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred on the server."}}}}}}}}
>
  
</StatusCodes>