Skip to main content
PUT
/
accounts
/
merge
Merge duplicate accounts
curl --request PUT \
  --url https://int-data.moneydesktop.com/accounts/merge \
  --header 'Content-Type: application/vnd.mx.nexus.v1+json' \
  --header 'MD-SESSION-TOKEN: <api-key>' \
  --data '
{
  "accounts": [
    "ACT-15f3a4de-cb45-d892-4480-6d05576011a8",
    "ACT-33fe5ab2-aaff-d88e-2221-66d63fbc101a"
  ]
}
'
{
  "account": {
    "account_number": "4921710685",
    "account_number_set_by": 1,
    "account_number_set_by_name": "FEED",
    "account_subtype": null,
    "account_subtype_name": null,
    "account_subtype_set_by": null,
    "account_subtype_set_by_name": null,
    "account_type": 1,
    "account_type_name": "CHECKING",
    "account_type_set_by": 1,
    "account_type_set_by_name": "FEED",
    "apr": null,
    "apr_set_by": null,
    "apr_set_by_name": null,
    "apy": null,
    "apy_set_by": null,
    "apy_set_by_name": null,
    "available_balance": 500000,
    "available_balance_set_by": 1,
    "available_balance_set_by_name": "FEED",
    "available_credit": null,
    "available_credit_set_by": null,
    "available_credit_set_by_name": null,
    "balance": 500000,
    "balance_set_by": 1,
    "balance_set_by_name": "FEED",
    "calculated_apr": null,
    "cash_balance": null,
    "cash_balance_set_by": null,
    "cash_balance_set_by_name": null,
    "cash_surrender_value": null,
    "cash_surrender_value_set_by": null,
    "cash_surrender_value_set_by_name": null,
    "created_at": "2020-09-21T19:43:44+00:00",
    "credit_limit": null,
    "credit_limit_set_by": null,
    "credit_limit_set_by_name": null,
    "currency_code": null,
    "currency_code_set_by": null,
    "currency_code_set_by_name": null,
    "day_payment_is_due": 12,
    "day_payment_is_due_set_by": 1,
    "day_payment_is_due_set_by_name": "FEED",
    "death_benefit": null,
    "death_benefit_set_by": null,
    "death_benefit_set_by_name": null,
    "external_guid": "23445745",
    "feed_account_number": "4921710685",
    "feed_account_subtype": null,
    "feed_account_subtype_name": null,
    "feed_account_type": 1,
    "feed_account_type_name": "CHECKING",
    "feed_apr": null,
    "feed_apy": null,
    "feed_available_balance": 500000,
    "feed_balance": 500000,
    "feed_cash_balance": null,
    "feed_cash_surrender_value": null,
    "feed_credit_limit": null,
    "feed_currency_code": null,
    "feed_day_payment_is_due": 12,
    "feed_death_benefit": null,
    "feed_holdings_value": null,
    "feed_interest_rate": null,
    "feed_is_closed": null,
    "feed_last_payment": null,
    "feed_last_payment_at": null,
    "feed_loan_amount": null,
    "feed_matures_on": null,
    "feed_minimum_balance": null,
    "feed_minimum_payment": null,
    "feed_name": "Checking",
    "feed_nickname": null,
    "feed_original_balance": null,
    "feed_payment_due_at": "2021-05-12T16:01:00+00:00",
    "feed_payoff_balance": null,
    "feed_routing_number": null,
    "feed_started_on": null,
    "feed_statement_balance": null,
    "feed_total_account_value": null,
    "guid": "ACT-8e6f92c8-1491-42ce-8bf6-c309e9531530",
    "holdings_value": null,
    "holdings_value_set_by": null,
    "holdings_value_set_by_name": null,
    "institution_guid": "INS-1572a04c-912b-59bf-5841-332c7dfafaef",
    "insured_name": null,
    "interest_rate": null,
    "interest_rate_set_by": null,
    "interest_rate_set_by_name": null,
    "is_business": false,
    "is_closed": false,
    "is_closed_set_by": 3,
    "is_closed_set_by_name": "SYSTEM",
    "is_hidden": false,
    "is_manual": false,
    "last_payment": null,
    "last_payment_at": null,
    "last_payment_at_set_by": null,
    "last_payment_at_set_by_name": null,
    "last_payment_set_by": null,
    "last_payment_set_by_name": null,
    "loan_amount": null,
    "loan_amount_set_by": null,
    "loan_amount_set_by_name": null,
    "matures_on": null,
    "matures_on_set_by": null,
    "matures_on_set_by_name": null,
    "member_guid": "MBR-84ca0882-ad6c-4f10-817f-c8c0de7424fa",
    "member_is_managed_by_user": true,
    "metadata": null,
    "minimum_balance": null,
    "minimum_balance_set_by": null,
    "minimum_balance_set_by_name": null,
    "minimum_payment": null,
    "minimum_payment_set_by": null,
    "minimum_payment_set_by_name": null,
    "name": "Checking",
    "name_set_by": 1,
    "name_set_by_name": "FEED",
    "nickname": null,
    "nickname_set_by": null,
    "nickname_set_by_name": null,
    "original_balance": null,
    "original_balance_set_by": null,
    "original_balance_set_by_name": null,
    "pay_out_amount": null,
    "payment_due_at": "2021-05-12T16:01:00+00:00",
    "payment_due_at_set_by": 1,
    "payment_due_at_set_by_name": "FEED",
    "payoff_balance": null,
    "payoff_balance_set_by": null,
    "payoff_balance_set_by_name": null,
    "premium_amount": null,
    "property_type": null,
    "property_type_name": null,
    "revision": 648,
    "routing_number": null,
    "started_on": null,
    "started_on_set_by": null,
    "started_on_set_by_name": null,
    "statement_balance": null,
    "statement_balance_set_by": null,
    "statement_balance_set_by_name": null,
    "total_account_value": null,
    "total_account_value_set_by": null,
    "total_account_value_set_by_name": null,
    "updated_at": "2022-06-14T21:17:09+00:00",
    "user_guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
  }
}
This endpoint should only be used to merge accounts that have been identified by the user as being duplicates. The response from performing this action will be the details of the remaining account. Two accounts must be provided, both accounts must exist, and at least one account must be from a non-partner-managed member (i.e. member_is_managed_by_user=true).
The order of the accounts in the request does not matter. MX uses internal logic to determine which account will remain and which will be merged. However, if one of the accounts is from a partner-managed member, then it will always be the account that remains.

Authorizations

MD-SESSION-TOKEN
string
header
required

MX Session Token

  • Request an API token using the read API token endpoint in the MX SSO API.
  • Exchange an API token for a session token.
    • A session token is obtained by sending a POST request to /sessions
    • The session token will be used in each request made for the user. It should be passed in an MD-SESSION-TOKEN HTTP header as shown below.
    • This session token is valid for 30 minutes from the time it was created. The 30 minute expiration counter is refreshed with each call.
    • If you send a request with an expired session token you'll receive an error code of 4011.
curl -i https://int-data.moneydesktop.com/accounts \
-H 'MD-SESSION-TOKEN: CWforZl1Vn2vC_v6H4rnQRT1DoWpDouJAV-_5TBmiQRAtA8rsOG_BoajTiOSsL0A3bd-bmHXlA-eQzc9ywItKg' \
-H 'Content-Type: application/vnd.mx.nexus.v1+json' \
-H 'Accept: application/vnd.mx.nexus.v1+json'

In documentation code examples, replace <API_KEY_VALUE> with the session token.

Body

application/vnd.mx.nexus.v1+json
accounts
string[]

An array containing the two account guids to be merged.

Example:
[
"ACT-15f3a4de-cb45-d892-4480-6d05576011a8",
"ACT-33fe5ab2-aaff-d88e-2221-66d63fbc101a"
]

Response

200 - application/vnd.mx.nexus.v1+json

OK

account
object