List Operations V2
OpenAPI SpecTest this endpoint live
Open the same request directly in API Explorer.
Server URL
Retrieve finalized transaction operations for the authenticated merchant using cursor-based pagination. Only operations in a final state of SUCCESS or FAILED are returned.
Results are ordered by operation ID in descending order, not by finalization time. Omit offset for the first page. While hasMore is true, pass the returned nextOffset as offset to retrieve the next page, keeping the same filters. Stop when hasMore is false; a non-empty last page can still contain a nextOffset value.
Combine operation types, a final state, transaction IDs, points of sale, and an inclusive finalization-time window to narrow the results. Values within each list are matched with OR; different filters are combined with AND. For example, type=CAPTURE&type=REFUND&state=SUCCESS returns successful captures and refunds.
Migrating from V1: replace page with offset and use hasMore to determine whether to continue. Each entry in items now contains an operation object. Page numbers, totals, and pagination URLs are not returned. Unlike V1, the order follows operation IDs rather than finalizedAt.
Maximum number of operations to return. Values outside 1–500 are rejected with a validation error rather than silently capped.
1 <= value <= 50025Operation UUID returned in nextOffset. Omit for the first page; subsequent pages contain operations with lower IDs than this cursor.
uuid"019ad8a2-18c6-7a72-bf20-2768be84eb42"Only include the specified operation types. Repeat the parameter to select multiple types, for example type=CAPTURE&type=REFUND. Omit to include all types.
Only include operations in this final state. Omit to include both successful and failed operations. Non-final states are not accepted.
- "SUCCESS"
- "FAILED"
Only include operations belonging to these transactions. Use the transaction IDs returned by the API, not operation UUIDs. Repeat the parameter to select multiple transactions.
Include operations finalized at or before this timestamp (inclusive). Use RFC 3339 format with a timezone.
date-time"2026-11-12T00:00:00Z"Include operations finalized at or after this timestamp (inclusive). Use RFC 3339 format with a timezone.
date-time"2026-11-01T00:00:00Z"Only include operations whose transactions belong to the specified points of sale. Repeat the parameter to select multiple points of sale.
Response Body
application/json
application/json
application/json
application/json
List Transactions
Retrieve transactions for the authenticated merchant using cursor-based pagination. Use the offset cursor returned in nextOffset to continue from the previous page and combine it with sessionId and reference filters to narrow the results.
List Operations
Deprecated — use V2 Do not use this endpoint for new integrations. V1 is deprecated and will reach end of life soon. New integrations must use List Operations V2. Existing integrations should migrate to V2 as soon as possible. Retrieve a paginated list of transaction operations. Query parameters page and perPage can be used to control pagination. finalizedBefore and finalizedAfter can be sent to only get operations finalized between certain timeframes. pointOfSaleId can be used to limit the operations to a list of points of sale. The endpoint only returns operations in a finalized state of FAILED or SUCCESS.