📘

API Reference

Search financial transactions
Get a financial transaction

Overview

Transactional data helps you understand a customer's expenditure, timing, and frequency of purchases. These details can be helpful for many different applications, such as cash flow modeling, risk analysis, etc. You can call the transactions endpoint to filter transactions.

Transactions are typically only available for the following account types:

• Depository accounts such as checking and saving funds.
• Credit type accounts, such as credit cards or student loan accounts.
• Investment accounts (if there are any).

Signage

Meld transaction amounts are positive when money moves out and negative when money moves in. Most service providers observe the same standard, however Finicity, Salt Edge, and Salt Edge Partners do the opposite, therefore their amounts are negated when normalized for consistency.

Transaction States

There are two types of transactions: pending and posted. Transactions start as pending and then move to posted once the funds have been transferred. The typical time period for a transaction to move from pending to posted is one to five business days, with generally a two week maximum on rare occasion.

As a result, when updating account transaction data, a period of two weeks (fourteen days) is recommended in order to capture transaction changes. After two weeks, it is extremely rare for any information about a transaction to change.

Historical Transactions

Initially, only 30 days of transaction history is made available following the first aggregation of a connection with TRANSACTIONS enabled as a product. Transactions older than 30 days are still supported but at an additional cost (for some providers). Meld collects historical transaction data up to 2 years old. Historical transaction data may take longer to aggregate in some cases, so in addition to the BANK_LINKING_TRANSACTIONS_AGGREGATED webhook a secondary BANK_LINKING_HISTORICAL_TRANSACTIONS_AGGREGATED webhook will be issued to indicate that transaction history older than 30 days is now available.

Sample Response

{
    "id": "W9ja24xnWMVFc1s7D3rewfw",
    "accountId": "W9kbkRme9VT2iz623efee",
    "customerId": "W9ja24edcTHBks8hz2cvvf",
    "financialAccountId": "W9ja25UmrZF25xb2E3WSQ",
    "amount": 2018.27,
    "currency": "USD",
    "description": "Payment to Chase card ending in 1234",
    "status": "POSTED",
    "category": "Fee",
    "transactionDate": "2022-02-28T11:00:00Z",
    "postedDate": "2022-02-28T11:00:00Z",
    "serviceProviderDetails": [
        // data
    ]
}

Enrichment

While providers themselves group transactions into their own categories, Meld also normalizes transaction categories between providers. Here is the list of provider category mappings to Meld categories: