Skip to content

Transaction-Level (TLX) Reports

Transaction-level reports — TLX for short — are transaction-level exports. Where aggregated reports give you totals, percentages, and breakdowns by dimension, TLX gives you one row per transaction. They are the right tool when you need to investigate a specific cookie, transaction, or user ID, or when you want to join Pinokio data against your own logs by a high-cardinality identifier.

Some fields are only available through TLX — transaction ID, user ID, and any custom keys you pass.

Each TLX run produces a single .csv file containing every transaction that occurred in the report’s time window and verdict from Pinokio with IVT codes for invalid transactions.

TLX reports must be configured by Pinokio. Reach out to your Pinokio account manager with:

  • the time window or cadence you want (daily, weekly, ad-hoc),
  • which fields you need beyond the default set,
  • how you want to access the files (Dashboard, API, or direct delivery).

Once a TLX report is configured, files are available three ways:

  • Reporting API — list and download via /list and /get. TLX files appear alongside other report files.
  • Direct delivery — for high volume, Pinokio can deliver TLX files directly to your data warehouse or object store. Configured with your account manager.
  • Dashboard — the Reports page has a Detailed tab where TLX runs appear. Each row has actions to download or delete.