> For the complete documentation index, see [llms.txt](https://docs.vomevolunteer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vomevolunteer.com/resources/categories/list-all-categories.md).

# List all categories

Returns the categories in your organization, newest first.

#### Endpoint

```plaintext
GET api/categories/
```

#### Supported query parameters

| Parameter   | Description                                         |
| ----------- | --------------------------------------------------- |
| `page`      | Page number.                                        |
| `page_size` | Results per page, up to 100.                        |
| `search`    | Matches part of a category title, case-insensitive. |
| `site_id`   | Only categories linked to this site.                |

#### Example response

```json
{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "d610ab31-e480-4ef1-9e35-94f94ebacde9",
      "created_at": "2024-09-06T02:57:15.008656Z",
      "title": "Community Outreach",
      "description": "Programs and roles related to outreach work.",
      "cover_image": null,
      "sites": [],
      "chat_enabled": false,
      "chat_announcement_only": false
    }
  ]
}
```
