---
title: "Read a category"
method: GET
path: "/action_item_category/{id}"
tags: ["Action Item Category"]
---

# Read a category

`GET /action_item_category/{id}`

Get a single action item category by ID. Includes parent and children if applicable.

## Path parameters

- `id` string, required

## Response `200`

The category.

- 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.

## 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)