# Get App

## GET /v1/admin/app/{id}/get

> Gets a app

```json
{"openapi":"3.1.1","info":{"title":"Pod API","version":"20.17.1"},"servers":[{"url":"http://yourpodURL.symphony.com/pod"}],"paths":{"/v1/admin/app/{id}/get":{"get":{"summary":"Gets a app","parameters":[{"schema":{"type":"string"},"name":"sessionToken","description":"Session authentication token.","in":"header","required":true},{"schema":{"type":"string"},"name":"id","description":"the id of the app to get","in":"path","required":true}],"tags":["Application"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationDetail"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Invalid session token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ApplicationDetail":{"description":"Detailed record of application.","type":"object","properties":{"applicationInfo":{"$ref":"#/components/schemas/ApplicationInfo"},"iconUrl":{"description":"Url to a icon to use for app. Must start with \"https://\".","type":"string"},"description":{"description":"Description of the application.","type":"string"},"allowOrigins":{"description":"The permitted domains to send or receive a request from.\nThe field is for the purpose of CORS which set the app specific \"ALLOW-ORIGIN-DOMAINS\" header in HTTP.\n","type":"string"},"permissions":{"description":"List of application permissions provisioned for the application.\nIn addition to the known ones, custom permissions are accepted.\nA custom permission should only contain upper case alphanumeric characters and underscore.\nIt should not be empty or only contain spaces and its length is limited to 64 characters.\n\nKnown permissions:\n  - SEND_MESSAGES\n  - GET_USER_CONNECTIONS\n  - REQUEST_USER_CONNECTIONS\n  - SET_PRESENCE\n  - GET_PRESENCE\n  - GET_BASIC_USER_INFO\n  - GET_EXTENDED_USER_INFO\n  - GET_BASIC_CONTACT_INFO\n  - GET_EXTENDED_CONTACT_INFO\n  - ACT_AS_USER\n  - MANAGE_SIGNALS\n  - MANAGE_USER_FOLLOWING\n  - TRUST_APP\n","type":"array","items":{"type":"string","maxLength":64,"minLength":1}},"cert":{"description":"The app public certificate in pem format.","type":"string"},"authenticationKeys":{"$ref":"#/components/schemas/AppAuthenticationKeys"},"notification":{"$ref":"#/components/schemas/AppNotification"},"properties":{"$ref":"#/components/schemas/AppProperties"}}},"ApplicationInfo":{"description":"Required information for creating an application.\n","type":"object","properties":{"appId":{"description":"An unique id for the application.","type":"string","maxLength":256,"minLength":1},"name":{"description":"User defined name for the application.","type":"string"},"appUrl":{"description":"The url for the app. Must start with \"https://\".","type":"string"},"domain":{"description":"Domain for app, that must match app url domain.","type":"string"},"publisher":{"description":"The publisher for this application.","type":"string"}}},"AppAuthenticationKeys":{"description":"App RSA keys information.","type":"object","properties":{"current":{"$ref":"#/components/schemas/AppAuthenticationKey"},"previous":{"$ref":"#/components/schemas/AppAuthenticationKey"}}},"AppAuthenticationKey":{"description":"App RSA key information.","type":"object","properties":{"key":{"description":"Application RSA public key.","type":"string"},"expirationDate":{"description":"RSA key expiration date. This value is set just for rotated keys.","type":"integer","format":"int64"},"action":{"description":"Action to be performed on the RSA key.\nThe following actions can be performed onto the app's active RSA key:\n  - SAVE\n  - REVOKE\nThe following actions can be performed onto the app's rotated RSA key:\n  - REVOKE\n  - EXTEND\n","type":"string"}}},"AppNotification":{"type":"object","description":"Application callback information","properties":{"url":{"type":"string","description":"callback URL"},"apiKey":{"type":"string","description":"apiKey sent into every callback request, using the X-API-KEY header"}}},"AppProperties":{"type":"array","description":"Application configuration properties that are shared with the extension application, client side. Do not store sensitive information here. Since SBE 20.14.","items":{"$ref":"#/components/schemas/AppProperty"}},"AppProperty":{"type":"object","description":"Application configuration property that is shared with the extension application, client side. Do not store sensitive information here.","properties":{"key":{"type":"string","description":"Name of an application configuration property. It cannot be null or empty and its length is limited to 1024 characters. Keys are unique."},"value":{"type":"string","description":"Value of an application configuration property. It cannot be null and its length is limited to 4096 characters. It can be empty."}}},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}}}}
```

> #### 🚧 Roles and Privileges
>
> Calling this endpoint requires the Super Administrator, Super Compliance Officer, User Provisioning or Agent role.\
> See [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions) for a list of roles and associated privileges.