--- title: "REST API call to retrieve the lists of cases based on different categories" slug: "rest-api-call-to-retrieve-the-lists-of-cases-based-on-different-categories" tags: ["Product Usage", "DLP 11.12.x"] updated: 2026-09-09T08:08:00Z published: 2026-09-09T08:08:00Z canonical: "docs.trellix.com/rest-api-call-to-retrieve-the-lists-of-cases-based-on-different-categories" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # REST API call to retrieve the lists of cases based on different categories You can retrieve (GET) various lists of cases based on these categories: resolution, status, priority, group, and user. ### GET request URL `https://<epo_server_name:port>/rest/dlp/rest/dlp/cases/categories` Where, `epo_server_name:port` is the server IP address and port number. ### Request Parameters | Parameter name | Description | Required | Values | | --- | --- | --- | --- | | **Authorization** | User credentials for ePO - On-prem. | Required | | **Sample GET request URL** `https://172.27.108.53:8443/rest/dlp/cases/categories` **Sample cURL command** `curl -k -v -X GET 'https://172.27.108.53:8443/rest/dlp/cases/categories' -u '<user>:<password>'` ### Response parameters The response to this API call returns the list of cases based on resolution, status, priority, group, and user. | Element | Description | Data type | | --- | --- | --- | | **resolution** | List of cases categorized by resolution | String | | **status** | List of cases categorized by status | String | | **priority** | List of cases categorized by priority | String | | **group** | List of cases categorized by group | String | | **user** | List of cases categorized by users | String | ### Sample response ``` {    "resolution": {        "1": "Under investigation",        "2": "User notified",        "3": "Manager notified",        "4": "False positive"    },    "status": {        "1": "New",        "2": "In progress",        "3": "Escalated",        "4": "Resolved",        "5": "Closed"    },    "priority": {        "1": "Info",        "2": "Normal",        "3": "Low",        "4": "Resolve immediately",        "5": "Urgent"    },    "group": {        "3": "Group Reviewer"    },    "user": {        "8": "user1",        "9": "user2"    } } ``` ### Status and error codes List of HTTP status codes returned for the query. | Code | Description | | --- | --- | | **200 OK** | Returns the lists of cases categorized by resolution, status, priority, group, and user. | | **404 Not Found** | Incorrect ePO - On-prem URL. | | **500 Internal Server Error** | An error on the server side that failed the request. See the ePO - On-prem `orion.log` file for more details about the error. |