---
title: "Get Application by Id"
slug: "get-application-by-id"
updated: 2026-02-18T12:52:40Z
published: 2026-02-18T12:52:58Z
canonical: "support.perimeter81.com/get-application-by-id"
---

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

# Get Application by Id

Get/v2.3/applications/{applicationId}

This GET API will allow to retrieve detailed information for a specific application by Id. Required permissions [application:read]

SecurityHTTPType bearer

Path parametersapplicationIdstringRequired

Responses200

Application retrieved successfully

<select class='api-response-data' aria-label='Media type'><option value='35a44388-9761-4fd1-ab4f-642255c5ea47'>application/json</option>
</select>Expand AllOneOfobjectobjectidstring    

Unique application ID

namestring    

Application name

typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp",
  "ssh",
  "vnc"
]
enabledboolean    

Application enabling status

policyobject  

Application related Policy data

idstring    

Policy Id

namestring    

Policy name

createdAtstring    

Application create date

networkobject  

Application related Network data

idstring    

Network Id

namestring    

Network name

dnsstring    

DNS of the network

subnetstring    

Subnet of the network

iconobject  

Application icon

namestring    

Icon name

urlstring    

Icon URL

users Array of object   

List of IDs of assigned users

object  

Application users

idstring    

Unique User ID

fullNamestring    

User's firstname and lastname

usernamestring    

User's username

groups Array of object   

List of IDs of assigned groups

object  

Application groups

idstring    

Unique Group ID

namestring    

Group's name

authobject (ApplicationAuth)  

Authentication settings related to the application

authEnabledboolean    
authUsernamestring    Min length1
authPasswordstring    Min length1
authDomainstring    Pattern^(?!:\/\/)([a-zA-Z0-9-_]+\.)*[a-zA-Z0-9][a-zA-Z0-9-_]*\.[a-zA-Z0-9]{2,11}?$Exampledomain.com

aliasobject (ApplicationAlias)  

URL alias settings to access the application via a user-friendly URL under your own domain

aliasEnabledboolean    
cnamestring    Min length1
sslCertificatestring    Min length1

displayIconAtLoginboolean    

Determines if the application icon is displayed during user login

fqdnstring    

Fully qualified domain name (FQDN) associated with the application

Min length1
hostobject (ApplicationHost)  

Application host settings

valuestring    Min length1
sourcestring    Min length1

portobject (ApplicationPort)  

Application port settings

valueOneOfintegerintegerMinimum1Maximum65353
stringstringMin length1

sourcestring    Min length1

updatedAtstring    

Application update date

headersobject  

Web Application headers

attributesobject (HttpAttributes)  

HTTP Application attributes

checkStatusinteger    Default200
checkPathstring    Default""ExamplecheckPath
startRelativePathstring    Default""Pattern^$|^\/[\w\d-._~!$&'()*+,;=:@/?#%]+$Example/startRelativePath

objectobjectidstring    

Unique application ID

namestring    

Application name

typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp",
  "ssh",
  "vnc"
]
enabledboolean    

Application enabling status

policyobject  

Application related Policy data

idstring    

Policy Id

namestring    

Policy name

createdAtstring    

Application create date

networkobject  

Application related Network data

idstring    

Network Id

namestring    

Network name

dnsstring    

DNS of the network

subnetstring    

Subnet of the network

iconobject  

Application icon

namestring    

Icon name

urlstring    

Icon URL

users Array of object   

List of IDs of assigned users

object  

Application users

idstring    

Unique User ID

fullNamestring    

User's firstname and lastname

usernamestring    

User's username

groups Array of object   

List of IDs of assigned groups

object  

Application groups

idstring    

Unique Group ID

namestring    

Group's name

authobject (ApplicationAuth)  

Authentication settings related to the application

authEnabledboolean    
authUsernamestring    Min length1
authPasswordstring    Min length1
authDomainstring    Pattern^(?!:\/\/)([a-zA-Z0-9-_]+\.)*[a-zA-Z0-9][a-zA-Z0-9-_]*\.[a-zA-Z0-9]{2,11}?$Exampledomain.com

aliasobject (ApplicationAlias)  

URL alias settings to access the application via a user-friendly URL under your own domain

aliasEnabledboolean    
cnamestring    Min length1
sslCertificatestring    Min length1

displayIconAtLoginboolean    

Determines if the application icon is displayed during user login

fqdnstring    

Fully qualified domain name (FQDN) associated with the application

Min length1
hostobject (ApplicationHost)  

Application host settings

valuestring    Min length1
sourcestring    Min length1

portobject (ApplicationPort)  

Application port settings

valueOneOfintegerintegerMinimum1Maximum65353
stringstringMin length1

sourcestring    Min length1

updatedAtstring    

Application update date

headersobject  

Web Application headers

attributesobject  checkStatusinteger    Default200
checkPathstring    Default""ExamplecheckPath
startRelativePathstring    Default""Pattern^$|^\/[\w\d-._~!$&'()*+,;=:@/?#%]+$Example/startRelativePath
sslCertificateVerificationboolean    Defaulttrue

objectobjectidstring    

Unique application ID

namestring    

Application name

typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp",
  "ssh",
  "vnc"
]
enabledboolean    

Application enabling status

policyobject  

Application related Policy data

idstring    

Policy Id

namestring    

Policy name

createdAtstring    

Application create date

networkobject  

Application related Network data

idstring    

Network Id

namestring    

Network name

dnsstring    

DNS of the network

subnetstring    

Subnet of the network

iconobject  

Application icon

namestring    

Icon name

urlstring    

Icon URL

users Array of object   

List of IDs of assigned users

object  

Application users

idstring    

Unique User ID

fullNamestring    

User's firstname and lastname

usernamestring    

User's username

groups Array of object   

List of IDs of assigned groups

object  

Application groups

idstring    

Unique Group ID

namestring    

Group's name

authobject (ApplicationAuth)  

Authentication settings related to the application

authEnabledboolean    
authUsernamestring    Min length1
authPasswordstring    Min length1
authDomainstring    Pattern^(?!:\/\/)([a-zA-Z0-9-_]+\.)*[a-zA-Z0-9][a-zA-Z0-9-_]*\.[a-zA-Z0-9]{2,11}?$Exampledomain.com

aliasobject (ApplicationAlias)  

URL alias settings to access the application via a user-friendly URL under your own domain

aliasEnabledboolean    
cnamestring    Min length1
sslCertificatestring    Min length1

displayIconAtLoginboolean    

Determines if the application icon is displayed during user login

fqdnstring    

Fully qualified domain name (FQDN) associated with the application

Min length1
hostobject (ApplicationHost)  

Application host settings

valuestring    Min length1
sourcestring    Min length1

portobject (ApplicationPort)  

Application port settings

valueOneOfintegerintegerMinimum1Maximum65353
stringstringMin length1

sourcestring    Min length1

updatedAtstring    

Application update date

attributesobject (RdpAttributes)  

RDP Application attributes

clientTypestring    

RDP client type

Valid values[
  "web",
  "native"
]Default"web"
disableClipboardboolean    Defaultfalse
disablePrintingboolean    Defaultfalse
ignoreTLSVerificationboolean    Defaulttrue
adminConsoleboolean    Defaultfalse
maxConnectionsOneOfintegerintegerMinimum1Maximum1024Default32
integerintegerMinimum1Maximum1Default1

rdpSecurityOneOfstringstringValid values[
  "any",
  "nla",
  "nla-ext",
  "tls",
  "vmconnect",
  "rdp"
]Default"any"
stringstringValid values[
  "any"
]Default"any"

enableMultiMonitorsboolean    

objectobjectidstring    

Unique application ID

namestring    

Application name

typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp",
  "ssh",
  "vnc"
]
enabledboolean    

Application enabling status

policyobject  

Application related Policy data

idstring    

Policy Id

namestring    

Policy name

createdAtstring    

Application create date

networkobject  

Application related Network data

idstring    

Network Id

namestring    

Network name

dnsstring    

DNS of the network

subnetstring    

Subnet of the network

iconobject  

Application icon

namestring    

Icon name

urlstring    

Icon URL

users Array of object   

List of IDs of assigned users

object  

Application users

idstring    

Unique User ID

fullNamestring    

User's firstname and lastname

usernamestring    

User's username

groups Array of object   

List of IDs of assigned groups

object  

Application groups

idstring    

Unique Group ID

namestring    

Group's name

authobject (ApplicationAuth)  

Authentication settings related to the application

authEnabledboolean    
authUsernamestring    Min length1
authPasswordstring    Min length1
authDomainstring    Pattern^(?!:\/\/)([a-zA-Z0-9-_]+\.)*[a-zA-Z0-9][a-zA-Z0-9-_]*\.[a-zA-Z0-9]{2,11}?$Exampledomain.com

aliasobject (ApplicationAlias)  

URL alias settings to access the application via a user-friendly URL under your own domain

aliasEnabledboolean    
cnamestring    Min length1
sslCertificatestring    Min length1

displayIconAtLoginboolean    

Determines if the application icon is displayed during user login

fqdnstring    

Fully qualified domain name (FQDN) associated with the application

Min length1
hostobject (ApplicationHost)  

Application host settings

valuestring    Min length1
sourcestring    Min length1

portobject (ApplicationPort)  

Application port settings

valueOneOfintegerintegerMinimum1Maximum65353
stringstringMin length1

sourcestring    Min length1

updatedAtstring    

Application update date

attributesobject (SshAttributes)  

SSH Application attributes

maxConnectionsinteger    

objectobjectidstring    

Unique application ID

namestring    

Application name

typestring    

Application type

Valid values[
  "http",
  "https",
  "rdp",
  "ssh",
  "vnc"
]
enabledboolean    

Application enabling status

policyobject  

Application related Policy data

idstring    

Policy Id

namestring    

Policy name

createdAtstring    

Application create date

networkobject  

Application related Network data

idstring    

Network Id

namestring    

Network name

dnsstring    

DNS of the network

subnetstring    

Subnet of the network

iconobject  

Application icon

namestring    

Icon name

urlstring    

Icon URL

users Array of object   

List of IDs of assigned users

object  

Application users

idstring    

Unique User ID

fullNamestring    

User's firstname and lastname

usernamestring    

User's username

groups Array of object   

List of IDs of assigned groups

object  

Application groups

idstring    

Unique Group ID

namestring    

Group's name

authobject (ApplicationAuth)  

Authentication settings related to the application

authEnabledboolean    
authUsernamestring    Min length1
authPasswordstring    Min length1
authDomainstring    Pattern^(?!:\/\/)([a-zA-Z0-9-_]+\.)*[a-zA-Z0-9][a-zA-Z0-9-_]*\.[a-zA-Z0-9]{2,11}?$Exampledomain.com

aliasobject (ApplicationAlias)  

URL alias settings to access the application via a user-friendly URL under your own domain

aliasEnabledboolean    
cnamestring    Min length1
sslCertificatestring    Min length1

displayIconAtLoginboolean    

Determines if the application icon is displayed during user login

fqdnstring    

Fully qualified domain name (FQDN) associated with the application

Min length1
hostobject (ApplicationHost)  

Application host settings

valuestring    Min length1
sourcestring    Min length1

portobject (ApplicationPort)  

Application port settings

valueOneOfintegerintegerMinimum1Maximum65353
stringstringMin length1

sourcestring    Min length1

updatedAtstring    

Application update date

attributesobject (VncAttributes)  

VNC Application attributes

maxConnectionsinteger    
disableClipboardboolean    

400

Bad Request

401

Not Authorized

403

Forbidden

404

Application Not Found

500

Internal Server Error
