Overview
The Transaction Reports API allows you to retrieve detailed transaction data from your Tranzila terminal, including line-item product details, and to filter results using flexible search criteria.
Two Retrieval Approaches
| Use Case | Endpoint |
|---|---|
| Transactions without product line items | https://api.tranzila.com/v1/transactions |
| Transactions with product line items | https://report.tranzila.com/v1/transaction |
This documentation covers the report.tranzila.com endpoints, which return full product-level
detail and support advanced filtering.
Filtering Transactions
The /v1/transaction endpoint supports two optional filter arrays that can be combined:
| Array | Filters on | Field types |
|---|---|---|
ufields | User-defined fields (user_defined_1 … user_defined_25) | Always string |
dfields | Core transaction fields (amount, date, status, etc.) | string or number |
Each entry within an array is treated as an AND condition. Multiple entries across both arrays are also evaluated as AND.
String Operators (ufields and string-type dfields)
| Operator | Meaning |
|---|---|
equals | Exact match |
contains | Value appears anywhere in the field |
starts_with | Field begins with value |
ends_with | Field ends with value |
Number Operators (numeric dfields only)
| Operator | Meaning |
|---|---|
= | Equal to |
> | Greater than |
< | Less than |
>= | Greater than or equal to |
<= | Less than or equal to |
Tip: Use
/v1/terminals/settings/fields/listto discover theapi_parameter_namevalues configured for your terminal's user-defined fields before buildingufieldsfilters.
Authentication
All requests require HMAC-SHA256 message signing via four request headers. See the Authentication guide for full details and code examples.