# /applications - List applications

**GET /applications**

Get list of system applications visible to the user based on hierarchical organization permissions.
Supports filtering by type, version, system, organization, and status.

**Query String Examples:**

1. **Single type filter**: `?type=mail`
2. **Multiple types filter**: `?type=mail&type=webtop`
3. **Status filter**: `?status=unassigned`
4. **With pagination and sorting**: `?page=1&page_size=50&sort_by=instance_of&sort_direction=asc`
5. **Combined filters**: `?type=mail&status=assigned&organization_id=org_abc123`



## Servers
- Backend API server (port 8080): https://api.your-domain.com/api (Backend API server (port 8080))
- Collect API server (port 8081): https://collect.your-domain.com/api (Collect API server (port 8081))


## Authentication methods
- Bearer auth


## Parameters


### Query parameters
- **page** (integer)
  Page number
- **page_size** (integer)
  Items per page
- **search** (string)
  Search term
- **sort_by** (string)
  Field to sort applications by
- **sort_direction** (string)
  Sort direction
- **type** (array[string])
  Filter applications by type (instance_of). Supports multiple values.
- **version** (array[string])
  Filter applications by version. Supports multiple values.
  Uses prefixed format "application:version" (e.g., "nethvoice:1.5.3") to avoid ambiguity
  when the same version exists for multiple application types.
- **system_id** (array[string])
  Filter applications by system ID. Supports multiple values.
- **organization_id** (array[string])
  Filter applications by organization ID. Supports multiple values.
- **status** (array[string])
  Filter applications by assignment status. Supports multiple values.


## Responses
### 200
Applications retrieved successfully

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object)


### 401
Unauthorized - invalid or missing token

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 403
Forbidden - insufficient permissions

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)



[Powered by Bump.sh](https://bump.sh)