Retrieving Transactions and Payments
Caliza provides an endpoint to retrieve and filter transactions and payments associated with your integrator account. You can use query parameters to filter by beneficiary, currency, status, date range, and amount range, with pagination support for large result sets.
List transactions
To retrieve transactions using the Caliza API, you can use the following cURL command. Make sure to replace YOUR_TOKEN with your actual API token.
See an example request below:
curl --location 'https://api.sandbox.caliza.com/core-api/v1/transactions?beneficiaryId=69261109adcc7b2db705a123&status=SUCCEEDED&fromDate=2025-01-01&toDate=2025-12-31&page=0&size=20&sort=createdDate,desc' \
--header 'Authorization: Bearer YOUR_TOKEN'Where:
beneficiaryId: The ID of the beneficiary to filter transactions for.fromCurrency: A list of source currency codes to filter by (e.g.,USDC,USD). Pass multiple values as repeated query parameters.toCurrency: A list of destination currency codes to filter by (e.g.,USD,BRL). Pass multiple values as repeated query parameters.status: The transaction status to filter by (e.g.,CREATED,PROCESSING,SUCCEEDED,FAILED,EXPIRED,PAYMENT_SENT,PAYMENT_COMPLETED,PROCESSED_BY_INTERMEDIARY_BANK).transactionId: The ID of a specific transaction to retrieve.fromDate: The start date for the date range filter (e.g.,2025-01-01).toDate: The end date for the date range filter (e.g.,2025-12-31).minAmount: The minimum transaction amount to filter by.maxAmount: The maximum transaction amount to filter by.page: The page number to retrieve (zero-based, default0).size: The number of items per page (default20).sort: The sort criteria in the formatproperty,direction(e.g.,createdDate,desc).
All query parameters are optional. If no filters are provided, all transactions for your account are returned.
Related Articles
Updated 22 days ago