Connectivity Overview - MX Documentation

MX Connectivity products serve as a bridge between your application and financial institutions. They allow you to:

Connect end users to thousands of financial institutions
Retrieve financial data such as account details, transactions, and more
Enhance and standardize data
Power financial use cases including account opening, payments, and more

To understand the core resources of our platform, see MX Data Architecture.

Integration Checklist

Complete steps for integrating MX Connectivity products

Connect Accounts

Follow our integration guides to connect user accounts

Connectivity Products

MX offers several connectivity products to address different use cases.

Most connectivity products focus on retrieving specific types of data from connected accounts (such as transactions, balances, or account numbers). Microdeposits is different—it provides an alternate method for verifying account ownership by making small test deposits to an account.

Product	Description
Account Aggregation	Get account details and transactions by connecting to users’ financial accounts
Account Owner Identification	Verify account ownership information such as name and address
Balance Checks	Check available balances for connected accounts
Extended Transaction History	Get up to 24 months of transaction history
Instant Account Verification	Retrieve account and routing numbers for demand deposit accounts
Microdeposits	Verify account ownership through small test deposits
Statements	Retrieve bank and credit card statements

Aggregating & Enhancing Data

Our platform uses distributed services to aggregate, enhance, and deliver financial data to end users and institutions. The platform includes RESTful web APIs, embeddable digital money management tools, customer analytics and marketing software, and more. The following flow shows how MX aggregates and enriches data:

End users provide their login credentials for a financial account, such as their bank or retirement account (you can also send your own customers’ data to MX using one or more of our APIs).
Those credentials are supplied to the MX system.
MX brings data from those accounts into its system, through a direct data-sharing connection or a third-party data provider.
MX enhances account and transaction data:

Account types and subtypes like CHECKING or SAVINGS are assigned
Every transaction is categorized into one of more than 100 default categories
When possible, repeating transactions such as bills, subscriptions, and income are identified
Transaction descriptions are made readable. For example, DBT CRD 1357 07/22/19 XXXX1357 JCWS RESTAU LEHI UT C#5144 becomes JCW's Burgers
Dates, locations, and merchant logos are added wherever possible
If two months of transaction data exists, user budgets are automatically calculated

MX delivers this enhanced financial data through our APIs, UIs, or daily change files. Additionally, we identify when end users have financial accounts with competitors and provide analytics on product usage and money management.

Retrievable Data

The following examples show what data you can expect with our Connectivity products.

Accounts and transactions

{
  "accounts": [
    {
      "account_number_display": "5366",
      "subtype": "NONE",
      "type": "SAVINGS",
      "guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
      "id": "1040434698",
      "name": "Test account 2",
      "nickname": "My Checking",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/accounts/ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
      "member": {
        "guid": "MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0",
        "id": "member-9876",
        "metadata": "some metadata",
        "name": "MX Bank",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/members/MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0"
      },
      "user": {
        "guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
        "id": "partner-2345",
        "metadata": null,
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
      },
      "mx_record": {
        "created_at": "2016-10-13T17:57:37Z",
        "updated_at": "2016-10-13T18:08:00Z"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total_entries": 1,
    "total_pages": 1
  }
}

The following transactions example includes the category and merchant objects, which are only returned when you request them with includes[]=category&includes[]=merchant.

{
  "transactions": [
    {
      "amount": 61.11,
      "currency_code": "USD",
      "date": "2013-09-23",
      "description": "Whole foods",
      "guid": "TRN-265abee9-889b-af6a-c69b-25157db2bdd9",
      "id": "transaction-265abee9-889b-af6a-c69b-25157db2bdd9",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/transactions/TRN-265abee9-889b-af6a-c69b-25157db2bdd9",
      "status": "POSTED",
      "type": "DEBIT",
      "account": {
        "account_number_display": "5366",
        "subtype": "NONE",
        "type": "SAVINGS",
        "guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
        "id": "1040434698",
        "name": "Test account 2",
        "nickname": "My Checking",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/accounts/ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1"
      },
      "member": {
        "guid": "MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0",
        "id": "member-9876",
        "metadata": "some metadata",
        "name": "MX Bank",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/members/MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0"
      },
      "user": {
        "guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
        "id": "partner-2345",
        "metadata": null,
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
      },
      "mx_record": {
        "created_at": "2016-10-06T09:43:42Z",
        "updated_at": "2016-10-07T05:49:12Z"
      },
      "category": {
        "guid": "CAT-9588eaad-90a4-bb5c-66c8-1812503d0db8",
        "name": "Groceries",
        "top_level_category": "Food & Dining",
        "self": "/categories/CAT-9588eaad-90a4-bb5c-66c8-1812503d0db8"
      },
      "merchant": {
        "confidence_level": "Very High",
        "guid": "MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b",
        "logo_url": "https://content.mx.com/logos/merchants/MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b.png",
        "name": "Whole Foods",
        "self": "/merchants/MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b",
        "website_url": "https://www.wholefoodsmarket.com"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total_entries": 243,
    "total_pages": 25
  }
}

Account and routing numbers

{
  "account_numbers": [
    {
      "guid": "ACN-8899832e-e5b4-42cd-aa25-bbf1dc889a8f",
      "ach": {
        "account_number": "10001",
        "routing_number": "091000019"
      },
      "eft": null,
      "account": {
        "account_number_display": "10001",
        "subtype": "NONE",
        "type": "CHECKING",
        "guid": "ACT-82a93692-f756-534f-9b2e-ad10a0f38462",
        "id": null,
        "name": "Test account 1",
        "nickname": "Checking",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/accounts/ACT-82a93692-f756-534f-9b2e-ad10a0f38462"
      },
      "member": {
        "guid": "MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0",
        "id": "member-9876",
        "metadata": "some metadata",
        "name": "MX Bank",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/members/MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0"
      },
      "user": {
        "guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
        "id": "partner-2345",
        "metadata": null,
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
      },
      "mx_record": {
        "created_at": "2016-10-13T18:08:00Z",
        "updated_at": "2016-10-13T18:09:00Z"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total_entries": 1,
    "total_pages": 1
  }
}

Account owners

{
  "account_owners": [
    {
      "guid": "ACO-63dc7714-6fc0-4aa2-a069-c06cdccd1af9",
      "names": [
        {
          "name": "John Smith",
          "first_name": "John",
          "last_name": "Smith"
        }
      ],
      "addresses": [
        {
          "street": "123 This Way",
          "city": "Middlesex",
          "state": "VA",
          "postal_code": "00000-0000",
          "country": "US"
        }
      ],
      "phone_numbers": [
        {
          "phone": "555-555-5555"
        }
      ],
      "emails": [
        {
          "email": "donnie@darko.co"
        }
      ],
      "account": {
        "account_number_display": "10001",
        "subtype": "NONE",
        "type": "CHECKING",
        "guid": "ACT-82a93692-f756-534f-9b2e-ad10a0f38462",
        "id": null,
        "name": "Test account 1",
        "nickname": "Checking",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/accounts/ACT-82a93692-f756-534f-9b2e-ad10a0f38462"
      },
      "member": {
        "guid": "MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0",
        "id": "member-9876",
        "metadata": "some metadata",
        "name": "MX Bank",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/members/MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0"
      },
      "user": {
        "guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
        "id": "partner-2345",
        "metadata": null,
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
      },
      "mx_record": {
        "created_at": "2016-10-13T18:08:00Z",
        "updated_at": "2016-10-13T18:09:00Z"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total_entries": 1,
    "total_pages": 1
  }
}

Extended transaction history

{
  "transactions": [
    {
      "amount": 61.11,
      "currency_code": "USD",
      "date": "2013-09-23",
      "description": "Whole foods",
      "guid": "TRN-265abee9-889b-af6a-c69b-25157db2bdd9",
      "id": "transaction-265abee9-889b-af6a-c69b-25157db2bdd9",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/transactions/TRN-265abee9-889b-af6a-c69b-25157db2bdd9",
      "status": "POSTED",
      "type": "DEBIT",
      "account": {
        "account_number_display": "5366",
        "subtype": "NONE",
        "type": "SAVINGS",
        "guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
        "id": "1040434698",
        "name": "Test account 2",
        "nickname": "My Checking",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/accounts/ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1"
      },
      "member": {
        "guid": "MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0",
        "id": "member-9876",
        "metadata": "some metadata",
        "name": "MX Bank",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/members/MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0"
      },
      "user": {
        "guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
        "id": "partner-2345",
        "metadata": null,
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
      },
      "mx_record": {
        "created_at": "2016-10-06T09:43:42Z",
        "updated_at": "2016-10-07T05:49:12Z"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 10,
    "total_entries": 243,
    "total_pages": 25
  }
}

Statements

{
  "statements": [
    {
      "content_hash": "ca53785b812d00ef821c3d94bfd6e5bbc0020504410589b7ea8552169f021981",
      "guid": "STA-737a344b-caae-0f6e-1384-01f52e75dcb1",
      "uri": "uri/to/statement",
      "account": {
        "account_number_display": "5366",
        "subtype": "NONE",
        "type": "SAVINGS",
        "guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
        "id": "1040434698",
        "name": "Test account 2",
        "nickname": "My Checking",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/accounts/ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1"
      },
      "member": {
        "guid": "MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0",
        "id": "member-9876",
        "metadata": "some metadata",
        "name": "MX Bank",
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/members/MBR-3bdc7d6b-efd4-1497-a0af-b23501cf9bd0"
      },
      "user": {
        "guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
        "id": "partner-2345",
        "metadata": null,
        "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
      },
      "mx_record": {
        "created_at": "2016-10-13T18:08:00Z",
        "updated_at": "2016-10-13T18:09:00Z"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total_entries": 1,
    "total_pages": 1
  }
}

Integration Checklist

Connect Accounts

​Connectivity Products

​Aggregating & Enhancing Data

​Retrievable Data

​Next Steps

Integration Checklist

Connect Accounts

Connectivity Products

Aggregating & Enhancing Data

Retrievable Data

Next Steps