# Retrieve all applications

Retrieve the list of all applications configured for the tenant, including their FQDN, port, and status details.

## Endpoints

`GET /sse/api/applications`

## Request

### Request URL

`https://{server-hostname}:8383/sse/api/applications`

### Scope

`SSE.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** (`string`, Mandatory): `application/json`

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/sse/api/applications \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body: `application/json`

`JSON Object`

- **applicationId** (`long`): The unique identifier (primary key) of the application.
- **name** (`string`): The display name of the application.
- **type** (`string`): The application type (may be null in GET response).
- **status** (`string`): Application status as string: 1 = Active, 2 = Inactive.
- **addedTime** (`long`): Timestamp (epoch milliseconds) when the application was created.
- **addedBy** (`long`): User ID of the administrator who created the application.
- **FQDN** (`JSON Object`): Nested object containing the FQDN, port, and protocol of the protected application.

### HTTP Code 401

#### Response Body: `application/json`

`JSON Object`

- **errorCode** (`long`): Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required).
- **errorMsg** (`string`): Authentication failure reason.

### HTTP Code 403

#### Response Body: `application/json`

`JSON Object`

- **errorCode** (`long`): Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin).
- **errorMsg** (`string`): Message indicating insufficient privileges to access this resource.

## Possible Response Codes

- **200**: HTTP code
- **401**: HTTP code
- **403**: HTTP code

## Sample Responses

### HTTP 200

#### List of all applications configured for the tenant

```json
[
  {
    "FQDN": {
      "protocol": "TCP",
      "fqdn": "portal.internal.company.com",
      "port": 443
    },
    "addedBy": 2,
    "name": "Internal Portal",
    "addedTime": 1711180800000,
    "applicationId": 2001,
    "type": null,
    "status": "1"
  },
  {
    "FQDN": {
      "protocol": "UDP",
      "fqdn": "dns.internal.company.com",
      "port": 53
    },
    "addedBy": 2,
    "name": "DNS Server",
    "addedTime": 1711180800000,
    "applicationId": 2002,
    "type": null,
    "status": "1"
  }
]
```

#### No applications configured for the tenant

```json
[]
```

### HTTP 401

#### Authentication credentials are missing or invalid

```json
{
  "errorMessage": "You are not authorized to perform this action",
  "errorCode": "UNAUTHORIZED"
}
```

### HTTP 403

#### User does not have the required SSE_Read role

```json
{
  "errorMessage": "User does not have permission to perform this operation",
  "errorCode": "FORBIDDEN"
}
```