Access Logs
Retrieve the complete access history for a policy.Endpoint
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
policyId | string | ✅ | Policy identifier |
Response
Success (200)
Log Entry Fields
| Field | Type | Description |
|---|---|---|
timestamp | string | ISO 8601 timestamp |
txHash | string | On-chain transaction hash |
success | boolean | Whether access was granted |
blockNumber | number | Block containing transaction |
error | string | Error message (if failed) |
Example Usage
Access Control
Only the sender or recipient of a policy can view its access logs.Rate Limits
| Limit | Value |
|---|---|
| Requests | 30 per minute |
On-Chain Storage
Logs are stored on-chain via thelogAttempt function. The API queries both:
- Blockchain events:
VerificationAttemptevents - Database: Cached logs for performance
Data Retention
| Plan | Retention |
|---|---|
| Free | 30 days |
| Pro | 90 days |
| Enterprise | Unlimited |

