---
title: "Get app"
method: GET
path: "/apps/{idApp}"
tags: ["Apps"]
---

# Get app

`GET /apps/{idApp}`

## Request

- Base URL: `https://api.toriihq.com/v1.0`
- URL: `https://api.toriihq.com/v1.0/apps/{idApp}`
- Auth: API key in header `Authorization`

Returns a specific app.<br/><br/><hr /><br/><br/>Example:<br/><br/>```GET /apps/1?fields=id,name,myCustomField&state=discovered&myCustomField=true```<br/><br/>The above example returns app with id=1. Each application object will contain the `id`, `name` and `myCustomField` fields.<br/><br/>Use `includeLicenses=true` to include aggregated license summary.<br/><br/>
<p><ul><li>Rate limit: 400 requests per minute</li></ul></p>

## Path parameters

- `idApp` integer, required

## Query parameters

- `fields` string
- `includeLicenses` boolean

## Response `200`

App

- Model31: App
  - `app` App
    - `id` integer: Unique identifier
    - `isHidden` boolean
    - `primaryOwner` PrimaryOwner
      - `firstName` string
      - `lastName` string
      - `photoUrl` string
      - `lifecycleStatus` 'active' | 'offboarding' | 'offboarded': Lifecycle status
      - `fullName` string
      - `isDeletedInIdentitySources` boolean
      - `id` integer: Unique identifier
      - `email` string: Email address
      - `status` 'active' | 'invited' | 'reporting' | 'deleted': The user status in Torii
    - `name` string
    - `state` string: Application state
    - `url` string
    - `category` string
    - `description` string
    - `tags` string
    - `licenses` LicenseSummary
      - `summary` LicenseSummaryFields
        - `totalAmount` integer: Total number of licenses
        - `activeAmount` integer: Number of active licenses
        - `inactiveAmount` integer: Number of inactive licenses
        - `unassignedAmount` integer: Number of unassigned licenses
        - `pricePerLicense` Currency: Annual cost per license (always null in summary)
          - `value` integer: Amount in smallest currency unit (e.g. cents)
          - `currency` string: ISO 4217 currency code (e.g. "USD", "EUR")
        - `annualCost` Model1: Total annual cost across all licenses in organization default currency
          - `value` integer: Amount in smallest currency unit (e.g. cents)
          - `currency` string: ISO 4217 currency code (e.g. "USD", "EUR")
        - `potentialSavings` Model2: Estimated annual savings from inactive/unassigned licenses in organization default currency
          - `value` integer: Amount in smallest currency unit (e.g. cents)
          - `currency` string: ISO 4217 currency code (e.g. "USD", "EUR")
      - `types` LicenseType[]: Per-license-type breakdown
        - `name` string: License type name (e.g. "Enterprise", "Member", "Guest")
        - `totalAmount` integer: Total number of licenses
        - `activeAmount` integer: Number of active licenses
        - `inactiveAmount` integer: Number of inactive licenses
        - `unassignedAmount` integer: Number of unassigned licenses
        - `pricePerLicense` Model3: Annual cost per license in license original currency
          - `value` integer: Amount in smallest currency unit (e.g. cents)
          - `currency` string: ISO 4217 currency code (e.g. "USD", "EUR")
        - `annualCost` Model4: Total annual cost in license original currency
          - `value` integer: Amount in smallest currency unit (e.g. cents)
          - `currency` string: ISO 4217 currency code (e.g. "USD", "EUR")
        - `potentialSavings` Model5: Estimated annual savings in license original currency
          - `value` integer: Amount in smallest currency unit (e.g. cents)
          - `currency` string: ISO 4217 currency code (e.g. "USD", "EUR")
        - `pricePerLicenseInOrgCurrency` Model6: Annual cost per license converted to organization default currency
          - `value` integer: Amount in smallest currency unit (e.g. cents)
          - `currency` string: ISO 4217 currency code (e.g. "USD", "EUR")
        - `annualCostInOrgCurrency` Model7: Total annual cost converted to organization default currency
          - `value` integer: Amount in smallest currency unit (e.g. cents)
          - `currency` string: ISO 4217 currency code (e.g. "USD", "EUR")
        - `potentialSavingsInOrgCurrency` Model8: Estimated annual savings converted to organization default currency
          - `value` integer: Amount in smallest currency unit (e.g. cents)
          - `currency` string: ISO 4217 currency code (e.g. "USD", "EUR")

---

[API](https://skmtc.dev/toriihq/apis/torii-api-documentation.md) - [All operations](https://skmtc.dev/toriihq/apis/torii-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/toriihq/apis/torii-api-documentation/revisions/15fd1512591b?raw)