---
title: "Get Top Entitlements."
slug: "get-top-entitlements-1"
updated: 2026-03-02T22:30:52Z
published: 2026-03-02T22:35:48Z
canonical: "support.appgate.com/get-top-entitlements-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.appgate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Top Entitlements.

Get/stats/top-entitlements

Get the (most used) Top Entitlements for the last 24 hours. Each Gateway keeps track of the most used 20 Entitlements and they are aggregated on the Controller. Number of Entitlements in this stats varies accordingly. Rebooting a Gateway resets the most used Entitlements for that Gateway. This API makes the Controller to query every Gateway in the system to collect the statistics. The operation may take long if one or more Gateways take long to respond.

SecurityHTTPType bearer

Query parametersrangestring

'Range string to limit the result list. Format: -. 3-10 means the items between the (including) 3rd and the 10th will be returned. Defaults to all objects.'

Example0-10
orderBystring

The field name to sort the result list. Supported fields vary from object to object. Defaults to certain field depending on the object type.

Examplename
descendingstring

Whether the sorting is applied descending or ascending. Defaults to certain field depending on the object type.

Responses200

Top Entitlements.

<select class='api-response-data' aria-label='Media type'><option value='1430b33a-0321-418e-8901-fd27ca915c55'>application/json</option>
</select>Expand Allobject  rangestring    

The range applied to the list. Format: -/. 3-5/8 means, out of 8 count (query affects the total), the items between (including) the 3rd and the 5th are returned.

Example0-30/54
orderBystring    

The field name used to sort the list.

Examplename
descendingboolean    

Whether the sorting is applied descending or ascending.

data Array of object   Example[
  {
    "accounting": 566837594.0
  },
  {
    "active_directory": 34638.0
  }
]object  

A Top Entitlement. The key is the Entitlement name and the value is the access count.

property*number    additionalProperties

401

Token error. Login again.

<select class='api-response-data' aria-label='Media type'><option value='cae688c3-a397-4174-a87d-40863e6140b2'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

403

Insufficient permissions to access this resource.

<select class='api-response-data' aria-label='Media type'><option value='62336cd5-d5ed-495d-97b0-869c532bec13'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

406

Invalid 'Accept' header.

<select class='api-response-data' aria-label='Media type'><option value='b17f4c0f-a422-49e3-aa71-e4e8dc3e3d71'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

500

Unexpected server side error.

<select class='api-response-data' aria-label='Media type'><option value='5315360f-cbd0-4a18-a76f-7c48ca3e1d98'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.