Skip to main content
GET
Get user statements timeline

Description

Get user statements timeline Chronological list of persisted Statement rows for one user. Self-or-admin guard: callers may request their own timeline; admins may request any user in the tenant. Ledger-fallback rows are NOT included — the timeline would need to enumerate every window the tenant has activity in (unbounded) to synthesize them. Use /statements/users/{id}/{start}/{end} for a specific window fallback. Authorization:
  • Required role: user or higher

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

tenantUserId
string<uuid>
required

Query Parameters

yearFilter
enum<string>
default:all
Available options:
all,
this-year,
last-12

Response

Timeline fetched.

Every statements response wraps the payload in { status, message, data }. data carries the per-endpoint payload PLUS the per-tenant feature flag.

status
enum<string>
Available options:
success,
error
message
string
data
object