Transactions represent asset movements, such as ACH payments, wire transfers, or card purchases. Track transaction statuses and events through these endpoints.

Endpoints:

New Endpoints for Account Closing Balances:

Transactions are created based on how you instruct Newline to move assets (a Transfer) or how assets are moved or spent outside your application (ATM withdrawals, debit card purchases, wire transfers, etc.). Each Transaction contains the amount, origin, and destination of assets. Newline categorizes Transactions into types to assist in their classification and representation.

Transactions fall into many categories, including debit card purchases, direct deposits, interest, and fees. This endpoint can retrieve a list of Transactions or track the status of an ongoing Transaction.

New Field for Reconciliation:

The GET /transactions endpoint now includes a new field:

statement_posted_at: Timestamp indicating when the transaction was posted to the client's Fifth Third bank statement.

This field is distinct from other date fields:

date_sent: When the transaction was initiated.
created_at: When the transaction was recorded in Newline.
settled_at: When funds were settled.

Only statement_posted_at aligns with the client’s official bank statement and should be used for reconciliation.

Transaction Events are created as a result of a Transaction. They capture the steps required to complete the Transaction. These can be used to view the progress of an in-flight Transaction or see the history of a completed Transaction.

Line Items are created for each Transaction Event. They catalog the individual credits and debits associated with the accounts involved in the Transaction.

Filtering Transactions

The GET /transactions endpoint supports filtering to narrow results based on transaction attributes.

return_status

Use the return_status query parameter to filter returned transactions by their return or reversal state.

This is useful for reconciliation, reporting, and identifying returned or failed asset movements.

Example: GET /transactions?return_status=returned