Skip to main content
GET
/
api
/
apps
/
v1
/
{appId}
Get an application
curl --request GET \
  --url https://app.trelica.com/api/apps/v1/{appId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "9425963fcd38ed972d209b49",
  "name": "Asana",
  "status": "New",
  "riskLevel": "High",
  "vendor": {
    "id": "f7f213984a1a225358c21c71",
    "name": "Asana, Inc."
  },
  "licenses": [
    {
      "name": "Premium",
      "licensePlanId": "PREMIUM",
      "startDate": "2024-07-22T00:00:00Z",
      "renewalDate": "2025-07-22T00:00:00Z",
      "terminatedDate": "2025-10-22T00:00:00Z",
      "lastModifiedDtm": "2024-11-27T16:00:20.895Z"
    },
    {
      "name": "Business",
      "licensePlanId": "BUSINESS",
      "startDate": "2021-06-22T00:00:00Z",
      "renewalDate": "2022-06-22T00:00:00Z",
      "lastModifiedDtm": "2023-05-15T12:28:57.137Z"
    }
  ],
  "customFields": {
    "user_area": "support",
    "user_vcc": "corp_support"
  },
  "deleted": false,
  "roles": [
    {
      "name": "IT admin",
      "members": [
        {
          "userId": "20fcf665630fc6562182578cb7f19f1e",
          "name": "Eduardo Wilson",
          "email": "eduardo.wilson@example.com"
        }
      ]
    },
    {
      "name": "App owner",
      "members": [
        {
          "userId": "0372c6f6fc51bc128389337de1146143",
          "name": "Eduardo Jung",
          "email": "eduardo.jung@example.com"
        }
      ]
    }
  ],
  "isGlobal": false,
  "mainCategory": {
    "id": "03823a9d2e817efcce22f52e",
    "name": "Project Management"
  },
  "otherCategories": [
    {
      "id": "cab66910ac7cc93acdcc0338",
      "name": "Project Management & Tracking"
    },
    {
      "id": "22d0532b27e33b61e53a6fc5",
      "name": "Team Coordination & Comms"
    },
    {
      "id": "74e38311e5ad68ef2ab9dbb2",
      "name": "Task Management"
    }
  ],
  "logoUrl": "https://app-files.trelica.com/public/4ad42e9e68cf46e3bc59cb8eab35886c",
  "links": {
    "application": "https://app.asana.com/"
  }
}

Authorizations

Authorization
string
header
required

OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as Authorization: Bearer <token>.

Path Parameters

appId
string
required

The application's SaaS Manager ID.

Response

OK

An application

id
string

The application's unique ID

name
string

The application name

description
string

A description of the application

instanceName
string

The instance name, used to distinguish multiple instances of the same application

status
enum<string>

The application's status in SaaS Manager.

Available options:
New,
InReview,
Managed,
Accepted,
Ignored,
PlanToClose,
Closed
riskLevel
string

Optional OAuth access risk level: Low, Medium or High

vendor
object

The application's vendor

licenses
object[]

The application's license plans

customFields
object

Custom field values, keyed by the field's lookup key. Each value is the field's value directly: a string (text/single-select), a number, an ISO-8601 date, or an array of strings (multi-select).

createdBy
object

The user that created the application record

createdDtm
string<date-time>

The timestamp for when the application record was created

deleted
boolean

Whether the application has been deleted

lastModifiedDtm
string<date-time>

The timestamp for when the application record was last modified

roles
object[]

The application's owner roles and their members

isGlobal
boolean

Whether the application is recognised in the global application catalog

mainCategory
object

The application's primary category

otherCategories
object[]

The application's additional categories

domains
string[]

The application's domains

logoUrl
string

A URL for the application's logo

signOnUrl
string

The application's single sign-on URL

Links to pages containing application details