DocsAPI Reference
Log In
Docs

MX to Meld Mappings

Note: You can always compare the raw responses from MX in the serviceProviderDetails section of a financial account.

Financial Account Base Fields

Identifiers

Balances

Owners

Transactions

Normalized Account Types and Subtypes

Financial Account Base Fields

This data comes from MX's /users/{user_guid}/accounts endpoint and is returned from Meld's /bank-linking/accounts endpoint.

Meld Field Description MX Response Field

name

The account name

name

truncatedAccount
Number

The last 4 digits of the account number

accountNumber

status

The real-time status of the account

INACTIVE if MX fields is_closed = TRUEor is_hidden = TRUE; Otherwise ACTIVE

type

The type of the account. Mapped to a Meld standardized type

type

subtype

The subtype of the account. Mapped to a Meld standardized subtype

subtype

Product: Identifiers

This data comes from MX's /users/{user_guid} /members/{member_guid} /account_numbers endpoint and is returned from Meld's /bank-linking/accounts endpoint.

Meld FieldDescriptionMX Response Field
achACH data object
   accountNumberThe account numberaccount_number
   routingNumberThe account routing number. Reference Routing numberrouting_number
eftEFT data object
   accountNumberThe account numberaccount_number
   institutionNumberThe account institution numberinstitution_number
   branchNumberThe institution branch numbertransit_number
internationalInternational data object
   ibanThe International Bank Account Number (IBAN) for the financial accountNone
   bicThe Bank Identifier Code (BIC) for the financial accountNone
bacsThe BACS data object
   accountNumberBACS account numberNone
   sortCodeBACS sort codeNone

Product: Balances

This data comes from MX's /users/{user_guid}/accounts endpoint and is returned from Meld's /bank-linking/accounts endpoint.

Meld FieldDescriptionMX Response Field
currencyThe currency of the account balancecurrency_code
currentAmountThe current amount in the accountbalance
availableAmountThe available amount in the accountavailable_balance
updatedAtThe last time balances were updatedupdated_at

Product: Owners

This data comes from MX's /users/{user_guid} /members/{member_guid} /account_owners endpoint and is returned from Meld's /bank-linking/accounts endpoint.

Meld Field Description MX Response Field

addresses

The address(es) associated with this owner

   data

The address data object

      street

The street and residence number

address

      city

The city

city

      region

The region/state

state

      postalCode

The postal or zip code

postal_code

      country

The ISO 3166-1 alpha-2 country code

country

   primary

Indicates if this is the owner's primary residence

Does not provide.
Meld will
default
toUNKNOWN

emails

The email(s) associated with this owner

   data

The email address

email

   primary

Indicates if this is the owner's primary email

Does not provide.
Meld will
default
toUNKNOWN

names

The name(s) of this owner

owner_name

phoneNumbers

The phone number(s) associated with this owner

   data

The phone number

phone

   primary

Indicates if this is the owner's primary phone number

Does not provide.
Meld will
default
toUNKNOWN

Product: Transactions

This data comes from MX's /users/{user_guid} /accounts/{account_guid}/transactions endpoint and is returned from Meld's /bank-linking/transactions endpoint.

Meld FieldDescriptionMX Response Field
amountThe amount of the transactionamount
currencyThe currency used in the transactioncurrency_code
payeeThe recipient of the transactionoriginal_description
statusThe status of the transactionstatus
transactionDateThe date and time the transaction was madetransacted_at
postedDateThe date and time the transaction was postedposted_at

Normalized Account Types and Subtypes