---
agentTools:
  projectIndex: https://developers.brandwatch.com/llms.txt
---

# Retrieving Categories

Listing the Categories within your Project.

The following call will list the Categories in the Project with ID `162752818`:
(Click [here](https://developers.brandwatch.com/docs/retrieving-projects) to learn how to get your Project ID)

[block:code]
{
  "codes": [
    {
      "code": "curl -X GET 'https://api.brandwatch.com/projects/162752818/rulecategories'",
      "language": "curl"
    }
  ]
}
[/block]

The response will look like this:

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"resultsTotal\": 1,\n    \"resultsPage\": -1,\n    \"resultsPageSize\": -1,\n    \"results\": [\n        {\n            \"id\": 14205369,\n            \"name\": \"Example Category 1\",\n            \"displayName\": null,\n            \"multiple\": true,\n            \"queryIds\": [123],\n            \"queries\": [\n                {\n                    \"id\": 123,\n                    \"name\": \"queryName\"\n                }\n            ],\n            \"children\": [\n                {\n                    \"id\": 14205370,\n                    \"name\": \"Example Subcategory 1\",\n                    \"ordering\": 1,\n                    \"rules\": []\n                },\n                {\n                    \"id\": 14205371,\n                    \"name\": \"Example Subcategory 2\",\n                    \"ordering\": 2,\n                    \"rules\": []\n                }\n            ],\n            \"matchingType\": \"manual\"\n        }\n    ]\n}",
      "language": "json"
    }
  ]
}
[/block]

Here, the "Example Category 1" Category with ID `14205369` has two Subcategories, as identified in the `children` array.

You can then use these Category and Subcategory IDs when filtering or breaking down Mention calls. Elsewhere in the documentation you may see the top-level Categories being referred to as "Parent Categories".