Sign in
Action Item Category

List categories

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.

get/action_item_category

Query parameters

nrnstring

Filter by NRN. Supports wildcards (e.g., organization=1:account=*).

namestring

Filter by category name.

parent_idstring

Filter by parent category ID to list subcategories.

status'active' | 'inactive'

Filter by category status.

Response

A paginated list of categories.

Example response

{
  "results": [
    {
      "id": "abc123def456",
      "slug": "security-vulnerabilities",
      "nrn": "organization=1:account=2",
      "name": "Security vulnerabilities",
      "description": "Tracks security issues found by automated scanners",
      "color": "#E53E3E",
      "icon": "shield",
      "unit_name": "Dollars",
      "unit_symbol": "$",
      "config": {
        "max_deferral_days": 90,
        "max_deferral_count": 3
      },
      "status": "active",
      "created_at": "2026-04-01T10:00:00.000Z",
      "updated_at": "2026-04-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 25,
    "total": 42
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.