---
title: "List apps"
method: GET
path: "/apps"
tags: ["Apps"]
---

# List apps

`GET /apps`

## Request

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

Returns a list of apps used in the organization.<br/><br/><hr /><br/><br/>Filtering is available via the documented query parameters below and by [custom application fields](https://app.toriihq.com/team/settings/appDetails).<br/><br/>Example:<br/><br/>```GET /apps?fields=id,name,myCustomField&state=discovered&myCustomField=true```<br/><br/>The above example returns a list of applications that are in `discovered` state and `myCustomField` is true. Each application object will contain the `id`, `name` and `myCustomField` fields.<br/><br/>Use `includeLicenses=true` to include aggregated license summary for each app.<br/><br/>
<p><ul><li>Rate limit: 200 requests per minute</li></ul></p>

## Query parameters

- `fields` string
- `aggs` string
- `q` string
- `sort` string
- `filters` string
- `size` integer
- `cursor` string
- `includeLicenses` boolean

## Response `200`

Apps

- Model9: Apps
  - `apps` 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")
  - `aggregations` number
  - `count` integer: The number of results returned in this response
  - `total` integer: The total number of results
  - `nextCursor` string: A base64 string indicating the offset from which to start. <br>Pass the value of `nextCursor` returned from the previous call to get the next set of results

---

[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)