Skip to main content
GET
/
v1
/
applications
/
{uid}
Retrieve an Application
curl --request GET \
  --url https://api.siit.io/v1/applications/{uid} \
  --header 'Authorization: Bearer <token>'
{
  "uid": "<string>",
  "name": "<string>",
  "about": "<string>",
  "app_link": "<string>",
  "app_owner_uid": "<string>",
  "status": "discovered",
  "lifecycle": "evaluating",
  "renewal_date": "2023-12-25",
  "total_annual_cost": 0,
  "users_count": 123,
  "currency": "<string>",
  "source": "admin_portal",
  "discovered_at": "2023-12-25",
  "updated_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z"
}

​
Usage

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
uid
string
required

The UID of the Application

Response

Application show

​
uid
string

The UID of the Application

​
name
string

The Application name

​
about
string | null

A short description of the Application

​
app_link
string

The URL to the Application

​
app_owner_uid
string | null

Application's owner UID.

​
status
enum<string>
default:discovered

The status of the Application

Available options:
discovered,
approved,
restricted
​
lifecycle
enum<string> | null

Empty when status is not "approved"

Available options:
evaluating,
security_assessment,
active,
cost_optimization,
deprecated
​
renewal_date
string<date> | null

date formatted as ISO 8601 (e.g. "2020-12-15")

​
total_annual_cost
integer | null
default:0

Application's annual cost.

​
users_count
integer

Number of Siit users attached to the Application

​
currency
string | null
​
source
enum<string>
default:admin_portal
Available options:
admin_portal,
public_api,
okta,
jumpcloud,
google,
microsoft
​
discovered_at
string<date>

date formatted as ISO 8601 (e.g. "2020-12-15")

​
updated_at
string<date-time>

datetime formatted as ISO 8601 (e.g. "2020-12-15T03:34:13.000Z")

​
created_at
string<date-time>

datetime formatted as ISO 8601 (e.g. "2020-12-15T03:34:13.000Z")