Full transaction history of an account - every terminal intent incl. `DEAD` - with per-transaction latency breakdown in ms.
GET/v1/usage
The account's transaction history, one row per transaction hash. It holds every terminal intent,
including DEAD ones (with deadReason). billed says whether the transaction was billed; the
billing members are null when it was not.
Rows are keyed by transaction hash. A DEAD intent that was replaced by a cancel or a re-sign shares
its (sender, senderNonce) slot with the replacement that executed, and only the executed one is
billed. The replaced transaction stays in the history with status: dead and billed: false.
includeInFlight=true puts the account's non-terminal intents first (flagged inFlight), plus the
REJECTED submissions of the last 30 days (state: REJECTED, rejectCode, never a signature).
Order: executedBlockTsMs descending (the terminal timestamp for rows without a block), then txHash.
Request
Responses
- 200
- 400
- 401
- 403
Page of usage rows.
Response Headers
<url>; rel="next" when another page exists.
MALFORMED_REQUEST, VARIANTS_NOT_SUPPORTED, RELAYER_SIGNATURE_PRESENT, CHAIN_ID_MISMATCH, TX_VERSION_UNSUPPORTED, TX_OPTIONS_UNSUPPORTED, LEASE_MISSING, CURSOR_INVALID.
Response Headers
Request id, also the instance of a problem document and the log correlation id.
UNAUTHENTICATED, TOKEN_INVALID (details.expectedShard = 1 when the native-auth block hash is not a shard-1 block), TOKEN_EXPIRED, CHALLENGE_INVALID, API_KEY_INVALID, STREAM_TICKET_INVALID, ASSIGN_PROOF_REQUIRED, ASSIGN_PROOF_INVALID.
FORBIDDEN, ORIGIN_NOT_ALLOWED, API_KEY_SCOPE, ACCOUNT_SUSPENDED, LEASE_INVALID, RECEIVER_NOT_ALLOWED, SENDER_NOT_AUTHORIZED, DEPLOY_NOT_ALLOWED, FREE_FLOW_BARRED.