Retrieve incident categories.

get /v2/Categories

Returns an array of incident categories for incident types which have an Operational status of In service.

Query parameters

offset

Integer

int32

This query parameter allows you to set the number of items to be skipped. <br />The default value for this parameter is 0.

Example: 56

limit

Integer

int32

This query parameter allows you to set the number of items to retrieve. Maximum value: 100. <br />The default value for this parameter is 25.

Example: 56

showTriggerable

Boolean

_Example:_ `?showTriggerable=true;

Example: true

CLIENT REQUEST

          curl -X 'GET'

        -H
        'Accept: application/json'
      
      'http://localhost/v2/Categories?offset=56&limit=56&showTriggerable=true'

Responses

Success

Body

TotalResultsCountIntegerint32

ResultsArray[none]

RESPONSE

{
  "TotalResultsCount": 3,
  "Results": [
    {
      "Id": "ca6a313c-d47b-4b2e-8a83-ebfcb8fd26f0",
      "Name": "Category 1",
      "ParentId": null,
      "OperationalMode": "Active",
      "IconId": "0b9900d4-7c52-4116-adb0-b7200bb13acd"
    },
    {
      "Id": "3f5957a2-ba0e-403d-b0e6-cee7ff7bfec7",
      "Name": "Category 2",
      "ParentId": "2c311f92-2198-44bf-a3d9-554a42a79e68",
      "OperationalMode": "Active",
      "IconId": "27599660-2749-4d40-99b4-f7eb6e5e6068"
    },
    {
      "Id": "1c10506c-208e-4edc-96ab-0ab2af68018c",
      "Name": "Category 3",
      "ParentId": "3f5957a2-ba0e-403d-b0e6-cee7ff7bfec7",
      "OperationalMode": "Active",
      "IconId": "b2b8a5a6-9639-47f7-955b-11e8f4ec8936"
    }
  ]
}

The Web API was unable to process the request due to a client error (malformed request syntax, size too large, invalid request message framing, or deceptive request routing).

The token you submitted was either invalid or expired.

The token you submitted was valid, but either did not grant sufficient privilege to access the requested resource, or the Web API license is not active.

The Web API was unable to process the request.

The Web API received an invalid response from the Incident Manager role.

The Web API did not receive a response to the request. The Incident Manager role might be down at the moment.