Skip to main content

Nexus API

Institutions Overview

Institutions are financial service providers such as banks, credit unions, and investment firms that users connect to aggregate their financial data.

Institution Fields

Field NameData TypeDescription
codeStringA unique identifier for each institution. Defined by MX.
created_atStringDate and time the institution was created, represented in ISO 8601 format with timestamp (e.g. 2015-04-13T12:01:23-00:00).
forgot_password_urlStringThe URL of the institution for helping users recover a forgotten password.
forgot_username_urlStringThe URL of the institution for helping users recover a forgotten username.
guidStringA unique identifier for the institution. Defined by MX.
has_checking_accountsBoolean(Deprecated) If the institution has checking accounts, this field will be true. Otherwise, this field will be false.
has_credit_card_accountsBoolean(Deprecated) If the institution has credit card accounts, this field will be true. Otherwise, this field will be false.
has_investment_accountsBoolean(Deprecated) If the institution has investment accounts, this field will be true. Otherwise, this field will be false.
has_line_of_credit_accountsBoolean(Deprecated) If the institution has line of credit accounts, this field will be true. Otherwise, this field will be false.
has_loan_accountsBoolean(Deprecated) If the institution has loan accounts, this field will be true. Otherwise, this field will be false.
has_mortgage_accountsBoolean(Deprecated) If the institution has mortgage accounts, this field will be true. Otherwise, this field will be false.
has_savings_accountsBoolean(Deprecated) If the institution has savings accounts, this field will be true. Otherwise, this field will be false.
is_disabled_by_clientBooleanThis indicates whether the institution has been disabled by the client.
is_hiddenBooleanIf the institution is available for creating new member connections, this field will be false. Otherwise, this field will be true.
is_testBooleanIf the institution represents a test institution such as MX Bank, this field will be true. Otherwise, this field will be false.
iso_country_codeArrayThe ISO country codes related to the institution.
medium_logo_urlStringThe institution's logo (medium size). This may be a generic logo if MX does not have a specific logo for the institution.
nameStringThe name of the institution that is visible to the user.
popularityIntegerThe number of member connections to the institution.
small_logo_urlStringThe institution's logo (small size). This may be a generic logo if MX does not have a specific logo for the institution.
supports_account_identificationBooleanIndicates whether account identification is available for this institution.
supports_account_verificationBooleanIndicates whether account verification is available for this institution.
supports_oauthBooleanThis indicates whether the institution supports OAuth authentication.
supports_transaction_historyBooleanIndicates whether the institution allows access to up to 24 months of transaction data.
trouble_signing_in_urlStringThe URL of the institution for helping users troubleshoot any other sign-in issue.
updated_atStringDate and time the institution was updated, represented in ISO 8601 format with timestamp (e.g. 2015-04-13T12:01:23-00:00).
urlStringThe URL of the institution.

Credential Field Types

The "field_type" of the Institution Required Credential endpoint will return integers. See the table below for the name for each integer and its corresponding HTML element. See the Nexus Guide for more information

Credential TypeDefinition
0TEXT
1PASSWORD
2OPTIONS
3LOGIN
12TOKEN
13IMAGE_DATA
14IMAGE_OPTIONS