/entitlements/stats - Active grants per entitlement per organization

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://api.my.nethesis.it/mcp

Standard setup for AI tools providing an mcp.json file

{
  "my.nethesis.it MCP server": {
    "url": "https://api.my.nethesis.it/mcp"
  }
}

GET /entitlements/stats

Bearer auth

Active grants aggregated per entitlement per organization. Same visibility scoping as the grants report: owner organization and Super Admins see the whole fleet, other users only their hierarchy.

Responses

200 application/json

Entitlement stats retrieved successfully
Hide response attributes Show response attributes object
- code integer
- message string
- data object
  
  Hide data attribute Show data attribute object
  
  stats array[object]
  
  Active grants aggregated per entitlement per organization
  
  Hide stats attributes Show stats attributes object
  
  Active grants aggregated per entitlement per organization
  
  entitlement string
  
  Catalog id
  
  organization_id string
  
  Logto ID of the organization
  
  organization_name string
  
  Name of the organization
  
  active_grants integer
  
  Number of active grants
401 application/json

Unauthorized - invalid or missing token
Hide response attributes Show response attributes object
- code integer
- message string
- data object | null
403 application/json

Forbidden - insufficient permissions
Hide response attributes Show response attributes object
- code integer
- message string
- data object | null
500 application/json

Internal server error
Hide response attributes Show response attributes object
- code integer
- message string
- data object | null

GET /entitlements/stats

curl \
 --request GET 'https://api.your-domain.com/api/entitlements/stats' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "code": 200,
  "message": "entitlement stats retrieved successfully",
  "data": {
    "stats": [
      {
        "entitlement": "nsec-blacklist",
        "organization_id": "akkbs6x2wo82",
        "organization_name": "ACME S.r.l.",
        "active_grants": 12
      }
    ]
  }
}

Response examples (401)

{
  "code": 401,
  "message": "invalid token",
  "data": {}
}

Response examples (403)

{
  "code": 403,
  "message": "insufficient permissions",
  "data": {}
}

Response examples (500)

{
  "code": 500,
  "message": "internal server error",
  "data": {}
}