Retrieve Recent Transactions by Financial Account

Retrieve Recent Transactions by Financial Account (Legacy)

This endpoint retrieves the most recent financial activity for a specified financial account. It is designed to support legacy system integrations by providing a detailed, filterable, and paginated list of transactions including deposits, withdrawals, transfers, and card activity. Use this endpoint when compatibility with older processing flows is required or when migrating from legacy account management systems.

Endpoint

POST /api/transaction/v3/byFinancialAccount/server/old

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint to retrieve a historical snapshot of recent account activity for reconciliation, reporting, or account management in legacy-integrated systems. It supports filtering by date range, transaction type, amount range, payment card, status, and keyword search. It is especially useful for back-office tools or older partner integrations that need pagination and category-level filtering over a financial account's transaction history.

Request Body

The request body accepts one of two schema variants:

Base variant (financialaccountwithperiodandamountfilterrequest):

Field	Type	Required	Description
`financialAccountId`	string	Yes	The unique identifier of the financial account to query.
`dateFrom`	string (date-time)	Yes	Start of the date range for filtering transactions (ISO 8601).
`dateTo`	string (date-time)	Yes	End of the date range for filtering transactions (ISO 8601).
`amountFilter`	object	No	Filter transactions by minimum and/or maximum amount.
`amountFilter.minValue`	integer (int64)	No	Minimum transaction amount in smallest currency unit (e.g., cents).
`amountFilter.maxValue`	integer (int64)	No	Maximum transaction amount in smallest currency unit (e.g., cents).
`searchString`	string	No	Free-text keyword search applied against transaction data.
`filter`	object	No	Category-level boolean filters (deposit, withdraw, transfers, pos, others, transactionStatus, all).
`filter.all`	object	No	Filter item to include all transaction types.
`filter.deposit`	object	No	Filter item to include deposit transactions.
`filter.withdraw`	object	No	Filter item to include withdrawal transactions.
`filter.transfers`	object	No	Filter item to include transfer transactions.
`filter.pos`	object	No	Filter item to include point-of-sale transactions.
`filter.transactionStatus`	object	No	Filter item to filter by transaction status.
`filter.others`	object	No	Filter item to include other transaction types.
`jsonFilter`	string	No	Advanced JSON-encoded filter string for custom filtering logic.
`spendEvents`	array of strings	No	List of specific spend event types to include.
`paymentCardId`	string	No	Filter transactions associated with a specific payment card ID.
`status`	string (enum)	No	Filter by transaction status. Allowed values: `OTHER`, `PENDING`, `COMPLETED`, `FAILED`.
`paginationSettings`	object	No	Pagination control for the result set.
`paginationSettings.take`	integer (int32)	No	Number of records to return. Range: 1–10000.
`paginationSettings.skip`	integer (int32)	No	Number of records to skip for offset-based pagination. Range: 0–2147483647.

Extended variant (financialaccountwithperiodandamountfilterrequestextension) adds:

Field	Type	Required	Description
`financialAccountId`	string	No	Overrides the base `financialAccountId` field; nullable in this variant. All other base fields apply.

{
  "financialAccountId": "fa_abc123def456",
  "dateFrom": "2026-05-01T00:00:00Z",
  "dateTo": "2026-06-01T00:00:00Z",
  "amountFilter": {
    "minValue": 100,
    "maxValue": 50000
  },
  "searchString": "Amazon",
  "filter": {
    "deposit": { "displayName": "Deposits", "value": true },
    "pos": { "displayName": "POS", "value": true }
  },
  "status": "COMPLETED",
  "paginationSettings": {
    "take": 50,
    "skip": 0
  }
}

Response

200 OK

Field	Type	Description
`data`	array	List of financial activity records matching the query.
`data[].id`	string	Unique identifier for the activity record.
`data[].financialAccountId`	string	The financial account this activity belongs to.
`data[].date`	string (date-time)	Date and time the activity was recorded.
`data[].sortDate`	string (date-time)	Date used for chronological sorting of results.
`data[].balance`	object	Account balance at the time of the activity.
`data[].balance.value`	integer (int64)	Balance amount in smallest currency unit.
`data[].balance.currencyCode`	string	ISO 4217 currency code (e.g., `USD`).
`data[].status`	string (enum)	Transaction status: `OTHER`, `PENDING`, `COMPLETED`, `FAILED`.
`data[].riskHold`	boolean	Whether the transaction is under a risk hold.
`data[].settlementDate`	string (date-time)	Date the transaction was settled (read-only).
`data[].purpose`	string	Purpose or description of the activity (read-only).
`data[].statusReasonCode`	string	Machine-readable reason code for the current status.
`data[].amount`	object	Transaction amount with currency symbol.
`data[].amount.value`	integer (int64)	Amount in smallest currency unit.
`data[].amount.currencyCode`	string	ISO 4217 currency code.
`data[].amount.symbol`	string	Currency symbol (e.g., `$`).
`data[].clearAmount`	object	Cleared amount (same structure as `amount`).
`data[].pendingAmount`	object	Pending amount (value + currencyCode).
`data[].name`	string	Display name for the transaction (e.g., merchant or counterparty name).
`data[].last4`	object	Last 4 digits identifier for the associated card or account.
`data[].last4.type`	string (enum)	Type of last4 identifier: `CARD` or `ACCOUNT`.
`data[].last4.value`	string	The last 4 characters/digits.
`data[].type`	string	Transaction type label (read-only).
`data[].authorizedUser`	string	Name or identifier of the authorized user who initiated the transaction.
`data[].merchantCategory`	string	Merchant category description for card transactions.
`data[].rewardPoints`	integer (int64)	Reward points earned on this transaction (business customers only).
`data[].transactionSource`	object	Source transaction details.
`data[].transactionSource.typename`	string	Type name of the source transaction.
`data[].transactionSource.id`	string	Source transaction identifier.
`data[].transactionSource.transactionEvents`	array	Child transaction events associated with the source.
`data[].activityInfo`	object	Profile and history information for the activity.
`data[].activityInfo.fromProfile`	object	Profile of the sender (id, name, agentId).
`data[].activityInfo.toProfile`	object	Profile of the recipient (id, name, agentId).
`data[].activityInfo.historyRecords`	array	Status change history records (date, status).
`data[].financialEvent`	object	Detailed financial event data associated with this activity.
`data[].financialEvent.id`	string	Financial event identifier.
`data[].financialEvent.accountingDirection`	string (enum)	Direction of the event: `DEBIT` or `CREDIT`.
`data[].financialEvent.processingType`	string	Processing type for the event.
`data[].financialEvent.status`	string	Event-level status.
`data[].financialEvent.memo`	string	Memo or note on the event.
`data[].financialEvent.createdAt`	string (date-time)	Timestamp when the event was created.
`data[].financialEvent.settlementDate`	string (date-time)	Settlement date of the financial event.
`data[].financialEvent.merchantDetails`	object	Merchant information (name, category, categoryCode, countryCodeAlpha3, description, merchantId).
`data[].financialEvent.paymentCard`	object	Payment card details (id, bin, last4).
`data[].financialEvent.toFinancialAccount`	object	Destination account for transfers (id, name, last4, provider, externalBankAccountDetails).
`data[].financialEvent.fromFinancialAccount`	object	Source account for transfers (id, name, last4, provider, externalBankAccountDetails).
`data[].financialEvent.companyName`	string	ACH originating company name.
`data[].financialEvent.companyIdentifier`	string	ACH originating company identifier.
`data[].financialEvent.companyEntryDescription`	string	ACH company entry description.
`data[].financialEvent.transfer`	object	EFT/ACH transfer details (id, fundsAvailableDate, descriptor).
`data[].financialEvent.responseCode`	string	Authorization response code.
`data[].financialEvent.avsResponseCode`	string	Address Verification Service response code.
`data[].financialEvent.cvvResponseCode`	string	CVV verification response code.
`data[].financialEvent.postalCodeResponseCode`	string	Postal code verification response code.
`filter`	object	The active filter object applied to the query (echoed back).
`paginationResponse`	object	Pagination metadata for the result set.
`paginationResponse.totalItems`	integer (int32)	Total number of matching records across all pages.

{
  "data": [
    {
      "id": "act_9f3a12bc45d6",
      "financialAccountId": "fa_abc123def456",
      "date": "2026-05-22T14:35:00Z",
      "sortDate": "2026-05-22T14:35:00Z",
      "balance": {
        "value": 245000,
        "currencyCode": "USD"
      },
      "status": "COMPLETED",
      "riskHold": false,
      "settlementDate": "2026-05-23T00:00:00Z",
      "purpose": "PURCHASE",
      "statusReasonCode": null,
      "amount": {
        "value": 4999,
        "currencyCode": "USD",
        "symbol": "$"
      },
      "clearAmount": {
        "value": 4999,
        "currencyCode": "USD",
        "symbol": "$"
      },
      "pendingAmount": {
        "value": 0,
        "currencyCode": "USD"
      },
      "name": "Amazon",
      "last4": {
        "type": "CARD",
        "value": "1234"
      },
      "type": "SPEND",
      "authorizedUser": null,
      "merchantCategory": "Online Retail",
      "rewardPoints": 50,
      "transactionSource": {
        "typename": "CardTransaction",
        "id": "tx_7c88ef902a1b",
        "transactionEvents": []
      },
      "activityInfo": {
        "fromProfile": null,
        "toProfile": null,
        "historyRecords": [
          { "date": "2026-05-22T14:35:00Z", "status": "PENDING" },
          { "date": "2026-05-23T00:00:00Z", "status": "COMPLETED" }
        ]
      },
      "financialEvent": {
        "id": "fe_3d12ab78cd90",
        "accountingDirection": "DEBIT",
        "processingType": "CARD_AUTHORIZATION",
        "status": "COMPLETED",
        "memo": null,
        "createdAt": "2026-05-22T14:35:00Z",
        "settlementDate": "2026-05-23T00:00:00Z",
        "merchantDetails": {
          "name": "Amazon",
          "category": "Online Retail",
          "categoryCode": "5999",
          "countryCodeAlpha3": "USA",
          "description": "Online marketplace",
          "merchantId": "merch_4455667788"
        },
        "paymentCard": {
          "id": "card_xyz9876",
          "bin": "411111",
          "last4": "1234"
        },
        "responseCode": "00",
        "avsResponseCode": "Y",
        "cvvResponseCode": "M",
        "postalCodeResponseCode": "Y"
      }
    }
  ],
  "filter": {
    "deposit": { "displayName": "Deposits", "value": true },
    "pos": { "displayName": "POS", "value": true }
  },
  "paginationResponse": {
    "totalItems": 142
  }
}

Error Codes

Code	When it happens
400	Missing required fields (`financialAccountId`, `dateFrom`, `dateTo`) or invalid field values (e.g., `take` out of range, malformed date)
401	Token missing, expired, or invalid
403	Caller does not have permission to access the specified financial account
404	Financial account not found
500	Internal server error

Common Mistakes

Omitting financialAccountId, dateFrom, or dateTo — all three are required in the base request schema.
Supplying dateFrom greater than dateTo, which returns zero results or a validation error.
Setting paginationSettings.take to 0 or a value greater than 10000 — the valid range is 1–10000.
Passing amounts as decimal values (e.g., 49.99) instead of the smallest currency unit in integer form (e.g., 4999 for $49.99).
Using this endpoint for real-time or high-frequency polling — it is intended for legacy batch and reconciliation workflows; consider the current transaction endpoints for live data.

Related Endpoints

POST /api/transaction/v3/byFinancialAccount/server — Current (non-legacy) version of this endpoint for retrieving transactions by financial account
POST /api/transaction/v3/byFinancialAccount — Retrieve transactions by financial account (client-facing variant)
GET /api/financialaccount/v1/{financialAccountId} — Retrieve details for a specific financial account

Example

curl -X POST https://api.banking.netevia.dev/api/transaction/v3/byFinancialAccount/server/old \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "financialAccountId": "fa_abc123def456",
    "dateFrom": "2026-05-01T00:00:00Z",
    "dateTo": "2026-06-01T00:00:00Z",
    "amountFilter": {
      "minValue": 100,
      "maxValue": 50000
    },
    "searchString": "Amazon",
    "status": "COMPLETED",
    "paginationSettings": {
      "take": 50,
      "skip": 0
    }
  }'