---
title: "List categories"
method: GET
path: "/action_item_category"
tags: ["Action Item Category"]
---

# List categories

`GET /action_item_category`

List action item categories filtered by NRN, name, parent, or status.

Categories follow the NRN hierarchy. When querying for a specific NRN (without wildcards), the response includes categories from all ancestor NRN scopes, with the most specific category taking precedence when names overlap.

## Query parameters

- `nrn` string
- `name` string
- `parent_id` string
- `status` 'active' | 'inactive'

## Response `200`

A paginated list of categories.

- object
  - `results` Category[]
    - `id` string — The unique category ID.
    - `slug` string — Auto-generated URL-friendly slug.
    - `nrn` string — The NRN that owns this category.
    - `parent_id` string — The parent category ID, if this is a subcategory.
    - `name` string — The display name.
    - `description` string — A description of the category.
    - `color` string — Hex color code.
    - `icon` string — Icon name.
    - `unit_name` string — Display name for the unit of value.
    - `unit_symbol` string — Display symbol for the unit of value.
    - `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.
    - `status` 'active' | 'inactive' — The category status.
    - `children` Category[] — Subcategories of this category. Populated on read, empty array if none.
    - `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)