Get Access Summary
/api/stats/access/summary
Response
Total number of access attempts across all links
Number of successful access attempts
Number of failed access attempts
Number of attempts to access expired links
Number of unique origins that accessed links
Percentage of successful accesses (success / total * 100)
Percentage of expired accesses (expired / total * 100)
{
"total": 1250,
"success": 987,
"failed": 143,
"expired": 120,
"uniqueOrigins": 45,
"accessEfficiencyRatio": 78.96,
"expirationAttritionRate": 9.6
}
Get Hourly Access
Get access counts grouped by hour of day (0-23). Useful for identifying peak usage times.
Response
Returns an array of hourly access records:
Number of accesses during this hour
[
{
"hour": 0,
"count": 12
},
{
"hour": 1,
"count": 8
},
{
"hour": 2,
"count": 5
},
{
"hour": 9,
"count": 145
},
{
"hour": 14,
"count": 203
},
{
"hour": 23,
"count": 18
}
]
Get Daily Access
Get access counts grouped by date. Track daily trends and patterns over time.
Response
Returns an array of daily access records:
Date in ISO 8601 format (YYYY-MM-DD)
Number of accesses on this date
[
{
"date": "2026-02-28",
"count": 234
},
{
"date": "2026-03-01",
"count": 198
},
{
"date": "2026-03-02",
"count": 267
},
{
"date": "2026-03-03",
"count": 312
},
{
"date": "2026-03-04",
"count": 189
}
]
Get Access Failures
/api/stats/access/failures
Response
Returns an array of failure records:
Type of access failure. Possible values:
NOT_FOUND - Link does not existREVOKED - Link was revokedEXPIRED - Link has expiredVIEW_LIMIT_REACHED - Maximum views exceededPASSWORD_REQUIRED - Password needed but not providedINVALID_PASSWORD - Incorrect password providedUNEXPECTED_STATE - Link in unexpected state
Number of failures of this type
[
{
"result": "EXPIRED",
"count": 87
},
{
"result": "NOT_FOUND",
"count": 42
},
{
"result": "INVALID_PASSWORD",
"count": 23
},
{
"result": "VIEW_LIMIT_REACHED",
"count": 15
},
{
"result": "REVOKED",
"count": 8
}
]
