Skip to main content
Every action processed by Centsless — transactions, overrides, voids, tip operations, and administrative changes — produces an audit log entry with a cryptographic SHA-256 hash. Each entry’s hash incorporates the previous entry’s hash, forming a linked chain. Any attempt to modify, delete, or reorder historical records breaks the chain and is immediately detectable. Use these endpoints to query log entries and verify chain integrity before regulatory submissions.

​
Authentication

All requests require an x-api-key header with auditor or admin scope.

​
GET /admin/audit-logs — Query audit logs

Retrieve audit log entries with optional filtering by event type, user, and date range.

​
Query parameters

​
integer
Maximum number of entries to return. Defaults to 100.
​
string
Filter by event type. Examples: transaction, override, void, tip_payout
​
string
Filter entries to those associated with a specific user or employee ID.
​
string
Start of the date range in ISO 8601 datetime format. Example: 2026-01-01T00:00:00Z
​
string
End of the date range in ISO 8601 datetime format. Example: 2026-03-31T23:59:59Z

​
Code example

Each entry in the response includes the event details and a cryptographic hash that links it to its position in the chain.

​
GET /admin/verify-hash-chain — Verify hash chain integrity

Run a full integrity check across the entire transaction hash chain. The engine walks the chain from genesis and verifies that each entry’s hash correctly incorporates the previous entry’s hash.

​
Code example

​
Response

​
integer
Total number of entries in the hash chain.
​
integer
Number of entries whose hashes were successfully verified.
​
integer
Number of breaks detected in the chain. Any value above 0 indicates potential tampering.
​
array
Details of each break found, including the position in the chain and the affected entry IDs.
Run hash chain verification before submitting compliance reports to regulators. A verified result with break_count: 0 provides tamper-proof evidence that your transaction records have not been altered since they were written.