# /entitlements/report - Add-on analytics within the caller's hierarchy

**GET /entitlements/report**

The commercial overview of the add-on grants the caller can see:
lifecycle totals (active/expired/revoked/pending/suspended, perpetual,
expiring in 30/60/90 days), the per-type breakdown, the renewal
distribution and a 12-month activation trend. The per-organization and
per-tier breakdowns live on their own paginated endpoints. Scope
matches /entitlements/grants: the whole fleet for the owner
organization / a Super Admin, the caller's own organization and its
descendants otherwise. Deleted systems are excluded.



## Servers
- Backend API server (port 8080): https://api.your-domain.com/api (Backend API server (port 8080))
- Collect API server (port 8081): https://collect.your-domain.com/api (Collect API server (port 8081))


## Authentication methods
- Bearer auth


## Parameters




## Responses
### 200
Entitlement report retrieved successfully

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object)
  Fleet-wide add-on analytics (owner/Super Admin only)


### 401
Unauthorized - invalid or missing token

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 403
Forbidden - insufficient permissions

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 500
Internal server error

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)



[Powered by Bump.sh](https://bump.sh)