NUnullplatform
Action Item Category

List categories

Changed on

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

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/action_item_category
  • Auth
    HTTP bearer

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

  • 728d4df70ca1Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response property became optional for the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      removed subschema #1 subschema #2 from the response body oneOf list for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property message deprecated

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status