Find Unused Licenses

Use the licenses query with a license-activity filter to identify unused assignments and their potential annual savings.

Request

query FindUnusedLicenses($first: Int!, $after: String) {
  licenses(
    first: $first
    after: $after
    where: { state: { activity: { eq: UNUSED } } }
  ) {
    nodes {
      id
      holder {
        name
        email
        employeeId
      }
      plan {
        id
        name
        integration {
          name
        }
      }
      annualPrice {
        amount
        currency
      }
      potentialSaving {
        amount
        currency
      }
      state {
        ... on UnusedLicenseState {
          activity
          reason
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}

Interpret the result

• potentialSaving is the estimated annual saving associated with the license.
• holder identifies the employee or external user assigned to the license.
• UnusedLicenseState.reason explains why Viio classified the license as unused.
• plan.integration.name identifies the application or integration that supplied the license data.

Group savings by currency before summing them. Convert currencies with an approved finance rate if you need a single reporting currency.

Operational safeguards

Confirm the application owner and employee context before reclaiming access. Usage signals can be delayed or incomplete, and some assignments may be required for compliance, seasonal work, or planned onboarding.

Related reference

• licenses query
• LicenseFilterInput input
• License type
• LicenseActivity enum