> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Help Desk Departments

> Returns the available help desk departments for routing support tickets.

# List Help Desk Departments

Returns the list of help desk departments configured by the operator. Used to populate a department selector when creating new support tickets.

## Authentication

Requires a valid customer bearer token.

## Query Parameters

<ParamField query="_shape" type="string">
  Comma-separated list of field paths to include in the response. When provided, only the
  specified fields are returned — useful for reducing payload size. Supports nested paths
  using dot notation.
</ParamField>

## Response

<ResponseField name="Departments" type="Department[]" required>
  Array of available departments.
</ResponseField>

<ResponseField name="Departments[].Id" type="number" required>
  Unique identifier for the department. Use as `DepartmentId` when creating a message.
</ResponseField>

<ResponseField name="Departments[].Name" type="string" required>
  Display name of the department.
</ResponseField>

<ResponseField name="Departments[].Description" type="string" required>
  Description of the department's scope.
</ResponseField>

## Examples

### Fetch departments

```http theme={null}
GET /api/public/helpdesk/departments
Authorization: Bearer {token}
```

```json theme={null}
{
  "Departments": [
    { "Id": 1, "Name": "General", "Description": "General enquiries" },
    { "Id": 2, "Name": "Billing", "Description": "Invoice and payment issues" },
    { "Id": 3, "Name": "Facilities", "Description": "Building and equipment" }
  ]
}
```

## TypeScript Integration

```typescript theme={null}
import endpoints from '@/api/endpoints'

const { resource: departments } = useTypedData(httpClient, endpoints.helpDesk.departments())
```