Skip to main content
NEW TO MX CONNECTIVITY?See the Connectivity Overview to learn about our Connectivity products and integration options.

Integrate using the Connect Widget

Use the Connect Widget and Platform API to let end users connect to their accounts.

Integrate using the Platform API

Use the Platform API to power a non-MX UI connection experience.
With Account Aggregation, connect to end users’ financial institutions and retrieve 90 days of data for their accounts and transactions. Use this data for any number of solutions such as personal financial management or risk analysis. Data is available for accounts ranging from checking and savings to mortgages and credit cards — and everything in between. We cleanse this data to make it understandable to end users, and we automatically put it into more than 100 predefined categories. We also add enhanced information such as which merchant was involved in a transaction and whether it represents a direct deposit, bill pay, or subscription. Diagram flow of the steps to get account aggregation data

​
Aggregation

Aggregation is an important feature of the MX Platform API. Aggregating data enables people to see when, where, and how much they are spending. This helps you build solutions that can improve the financial lives of your institution’s customers. The best way to aggregate data is with the Connect Widget, MX’s ready-made UI that can be embedded in your application to aggregate users’ account data by prompting end users to connect to their financial institutions using their credentials. This is the preferred method of aggregation.

​
Background Aggregation​

MX automatically aggregates each member approximately every 24 hours. This process is called background aggregation. It ensures that end users’ data is always up to date. This is beneficial because, if a background aggregation is successful (for example, the successfully_aggregated_at field indicates a time within the last 24 hours), you can choose to skip foreground aggregation and jump right to reading account and transaction data, which can help you load things faster in your product. This background aggregation can be disabled by default for all members. Please reach out to MX to have this setting configured. Background aggregation can be disabled or enabled for individual members by setting the background_aggregation_is_disabled field when creating or updating a member (or the disable_background_agg configuration option when using the Connect Widget). Background aggregation is also disabled for members created when using the Connect Widget in verification mode. You can override this behavior by setting the disable_background_agg widget option to false. Note that this only affects newly created members. There are a few other general rules related to background aggregation:
  • The data source must allow background aggregation. Most sources do, but there are cases in which the data source does not.
  • The member must not have been aggregated in the last 20 hours.
  • The member must be in a CONNECTED, UPDATED, or CREATED state.

​
Foreground Aggregation​

If an end user is present, you can choose to manually run a foreground aggregation. End users must be present during foreground aggregations because they may run into MFA, credential update requests, terms and conditions agreements, or other situations requiring end-user input. Just keep in mind that you cannot run a new aggregation within three hours of a successful aggregation , whether foreground or background. Thus, attention must be paid to the aggregated_at and successfully_aggregated_at member fields while you’re developing your product with the Platform API.
INFOBoth foreground and background aggregation may be prevented by disabling a user. A user must be re-enabled before any aggregation can be attempted. We may suspend background aggregation on a particular member in some circumstances, such as when several consecutive aggregation attempts fail. However, you can always attempt a foreground aggregation on a suspended member.

API Reference

Learn about the full features of the Platform API.

Connect Widget

Learn about the Connect Widget.

Demo App

View the demo app on GitHub.

​
Account Sample Data

This sample response shows the data you can expect to get for financial accounts. 
{
  "accounts": [
    {
      "account_number": "5366",
      "apr": 1.0,
      "apy": 1.0,
      "available_balance": 1000.0,
      "available_credit": 1000.0,
      "balance": 1000.0,
      "cash_balance": 1000.0,
      "cash_surrender_value": 1000.0,
      "created_at": "2016-10-13T17:57:37.000Z",
      "credit_limit": 100.0,
      "currency_code": "USD",
      "day_payment_is_due": 20,
      "death_benefit": 1000,
      "guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
      "holdings_value": 1000.0,
      "id": "1040434698",
      "imported_at": "2015-10-13T17:57:37.000Z",
      "institution_code": "chase",
      "insured_name": "Frodo Baggins",
      "interest_rate": 1.0,
      "is_closed": false,
      "is_hidden": false,
      "last_payment": 100.0,
      "last_payment_at": "2015-10-13T17:57:37.000Z",
      "loan_amount": 1000.0,
      "matures_on": "2015-10-13T17:57:37.000Z",
      "member_guid": "MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0",
      "member_id": "member-9876",
      "member_is_managed_by_user": false,
      "metadata": "some metadata",
      "minimum_balance": 100.0,
      "minimum_payment": 10.0,
      "name": "Test account 2",
      "nickname": "My Checking",
      "original_balance": 10.0,
      "pay_out_amount": 10.0,
      "payment_due_at": "2015-10-13T17:57:37.000Z",
      "payoff_balance": 10.0,
      "premium_amount": 1.0,
      "routing_number": "68899990000000",
      "started_on": "2015-10-13T17:57:37.000Z",
      "subtype": "NONE",
      "total_account_value": 1.0,
      "type": "SAVINGS",
      "updated_at": "2016-10-13T18:08:00.000Z",
      "user_guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
      "user_id": "partner-2345"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total_entries": 1,
    "total_pages": 1
  }
}

​
Transaction Sample Data

This sample response shows the data you can expect to get for transactions. 
{
  "transactions": [
    {
      "account_guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
      "account_id": "account123",
      "amount": 61.11,
      "category": "Groceries",
      "category_guid": "CAT-9588eaad-90a4-bb5c-66c8-1812503d0db8",
      "check_number_string": "6812",
      "created_at": "2016-10-06T09:43:42.000Z",
      "currency_code": "USD",
      "date": "2013-09-23T00:00:00.000Z",
      "description": "Whole foods",
      "extended_transaction_type": "partner_transaction_type",
      "guid": "TRN-265abee9-889b-af6a-c69b-25157db2bdd9",
      "id": "transaction-265abee9-889b-af6a-c69b-25157db2bdd9",
      "is_bill_pay": false,
      "is_direct_deposit": false,
      "is_expense": true,
      "is_fee": false,
      "is_income": false,
      "is_international": false,
      "is_overdraft_fee": false,
      "is_payroll_advance": false,
      "is_recurring": false,
      "is_subscription": false,
      "latitude": -43.2075,
      "localized_description": "This is a localized_description",
      "localized_memo": "This is a localized_memo",
      "longitude": 139.691706,
      "member_guid": "MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0",
      "member_is_managed_by_user": false,
      "memo": "This is a memo",
      "merchant_category_code": 5411,
      "merchant_guid": "MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b",
      "merchant_location_guid": "MCL-00024e59-18b5-4d79-b879-2a7896726fea",
      "metadata": "some metadata",
      "original_description": "WHOLEFDS TSQ 102",
      "posted_at": "2016-10-07T06:00:00.000Z",
      "status": "POSTED",
      "top_level_category": "Food & Dining",
      "transacted_at": "2016-10-06T13:00:00.000Z",
      "type": "DEBIT",
      "updated_at": "2016-10-07T05:49:12.000Z",
      "user_guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
      "user_id": "partner-2345"
    },
    // •••
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total_entries": 243,
    "total_pages": 25
  }
}

Extended Transaction History

Gather end users’ tax statements or credit card rewards, such as miles or points, by connecting to their accounts with our Account Aggregation product. For additional transaction history, continue with our Extended Transaction History product.

Statements

With our Statements product, connect to an end user’s financial account to retrieve PDF financial statements to gather more information for decisioning.