Read account numbers by account_guid

curl --request GET \
  --url https://int-data.moneydesktop.com/accounts/{account_guid}/account_number \
  --header 'MD-SESSION-TOKEN: <api-key>'

import requests

url = "https://int-data.moneydesktop.com/accounts/{account_guid}/account_number"

headers = {"MD-SESSION-TOKEN": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'MD-SESSION-TOKEN': '<api-key>'}};

fetch('https://int-data.moneydesktop.com/accounts/{account_guid}/account_number', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://int-data.moneydesktop.com/accounts/{account_guid}/account_number",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "MD-SESSION-TOKEN: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://int-data.moneydesktop.com/accounts/{account_guid}/account_number"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("MD-SESSION-TOKEN", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://int-data.moneydesktop.com/accounts/{account_guid}/account_number")
  .header("MD-SESSION-TOKEN", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://int-data.moneydesktop.com/accounts/{account_guid}/account_number")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["MD-SESSION-TOKEN"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "account_numbers": [
    {
      "account_guid": "ACT-82ac32b4-06e6-48a9-8440-17e49bb3d720",
      "account_number": 1174165092,
      "institution_number": null,
      "member_guid": "MBR-84ca0882-ad6c-4f10-817f-c8c0de7424fa",
      "passed_validation": true,
      "routing_number": 998007868,
      "transit_number": null,
      "user_guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
    }
  ]
}

GET

accounts

{account_guid}

account_number

Read account numbers by account_guid

curl --request GET \
  --url https://int-data.moneydesktop.com/accounts/{account_guid}/account_number \
  --header 'MD-SESSION-TOKEN: <api-key>'

import requests

url = "https://int-data.moneydesktop.com/accounts/{account_guid}/account_number"

headers = {"MD-SESSION-TOKEN": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'MD-SESSION-TOKEN': '<api-key>'}};

fetch('https://int-data.moneydesktop.com/accounts/{account_guid}/account_number', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://int-data.moneydesktop.com/accounts/{account_guid}/account_number",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "MD-SESSION-TOKEN: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://int-data.moneydesktop.com/accounts/{account_guid}/account_number"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("MD-SESSION-TOKEN", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://int-data.moneydesktop.com/accounts/{account_guid}/account_number")
  .header("MD-SESSION-TOKEN", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://int-data.moneydesktop.com/accounts/{account_guid}/account_number")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["MD-SESSION-TOKEN"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "account_numbers": [
    {
      "account_guid": "ACT-82ac32b4-06e6-48a9-8440-17e49bb3d720",
      "account_number": 1174165092,
      "institution_number": null,
      "member_guid": "MBR-84ca0882-ad6c-4f10-817f-c8c0de7424fa",
      "passed_validation": true,
      "routing_number": 998007868,
      "transit_number": null,
      "user_guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
    }
  ]
}

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.

Path Parameters

account_guid

string

required

The unique identifier for the account. Defined by MX.

Response

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

account_numbers

object[]

Hide child attributes

account_numbers.account_guid

string

The unique identifier for the account associated with a particular set of account and routing numbers. Defined by MX.

Example:

"ACT-82ac32b4-06e6-48a9-8440-17e49bb3d720"

account_numbers.account_number

string

The banking account number associated with a particular account.

Example:

1174165092

account_numbers.institution_number

string

The three-digit number identifying a Canadian banking institution.

Example:

null

account_numbers.member_guid

string

The unique identifier for the member associated with a particular set of account and routing numbers. Defined by MX.

Example:

"MBR-84ca0882-ad6c-4f10-817f-c8c0de7424fa"

account_numbers.passed_validation

boolean

This indicates whether the account and routing numbers passed MX's internal validity checks. If true, the account and routing or transit numbers are likely but not guaranteed to be valid. If false, either the account number, routing or transit number, or both are likely invalid.

Example:

true

account_numbers.routing_number

string

The routing number for the financial institution associated with the account.

Example:

998007868

account_numbers.transit_number

string

The five-digit number identifying the branch of a Canadian financial institution.

Example:

null

account_numbers.user_guid

string

The unique identifier for the user associated with a particular set of account and routing numbers. Defined by MX.

Example:

"USR-11141024-90b3-1bce-cac9-c06ced52ab4c"

Verification Overview

Read account numbers