Read transaction by account

curl --request GET \
  --url https://int-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier} \
  --header 'Accept-Version: <accept-version>' \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://int-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}"

headers = {
    "Accept-Version": "<accept-version>",
    "Authorization": "Basic <encoded-value>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'Accept-Version': '<accept-version>', Authorization: 'Basic <encoded-value>'}
};

fetch('https://int-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}', 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-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept-Version: <accept-version>",
    "Authorization: Basic <encoded-value>"
  ],
]);

$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-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}"

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

	req.Header.Add("Accept-Version", "<accept-version>")
	req.Header.Add("Authorization", "Basic <encoded-value>")

	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-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}")
  .header("Accept-Version", "<accept-version>")
  .header("Authorization", "Basic <encoded-value>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://int-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}")

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

request = Net::HTTP::Get.new(url)
request["Accept-Version"] = '<accept-version>'
request["Authorization"] = 'Basic <encoded-value>'

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

{
  "transaction": {
    "amount": 61.11,
    "currency_code": "USD",
    "date": "2024-12-20",
    "description": "MX Technologies Payroll",
    "guid": "TRN-429ad9fe-a1d2-4559-8590-885b2603f0e1",
    "id": "1734681600000-178fa8095c154a55b9172f977b4c5f9a-0",
    "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/transactions/TRN-429ad9fe-a1d2-4559-8590-885b2603f0e1",
    "status": "POSTED",
    "type": "CREDIT",
    "account": {
      "account_number_display": "3331261",
      "subtype": "CHECKING",
      "type": "CHECKING",
      "guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
      "id": "1040434698",
      "name": "Test account 2",
      "nickname": "Swiss Account",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/accounts/ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1"
    },
    "member": {
      "guid": "MBR-7c6f361b-e582-15b6-60c0-358f12466b4b",
      "id": "unique_id",
      "metadata": "some metadata",
      "name": "MX Bank",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/members/MBR-7c6f361b-e582-15b6-60c0-358f12466b4b"
    },
    "user": {
      "guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
      "id": "unique_id",
      "metadata": "some metadata",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
    },
    "mx_record": {
      "created_at": "2025-05-10T18:08:00Z",
      "updated_at": "2026-02-12T22:48:21Z"
    },
    "category": {
      "guid": "CAT-b6d61a19-30a7-e852-2703-bdfb4072289e",
      "name": "Paycheck",
      "top_level_category": "Income",
      "self": "/categories/CAT-b6d61a19-30a7-e852-2703-bdfb4072289e"
    },
    "counterparties": [
      {
        "confidence_level": "Very High",
        "guid": "MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84",
        "logo_url": "https://content.mx.com/logos/merchants/MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84.png",
        "name": "MX",
        "website_url": "https://www.example.com"
      }
    ],
    "merchant": {
      "confidence_level": "Very High",
      "guid": "MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84",
      "logo_url": "https://content.mx.com/logos/merchants/MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84.png",
      "name": "MX",
      "self": "/merchants/MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84",
      "website_url": "https://www.example.com"
    },
    "repeating_transaction": {
      "frequency": "EVERY_MONTH",
      "guid": "RPT-065b8b1d-826a-45ce-8487-60ca1510e72a",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/repeating_transactions/RPT-065b8b1d-826a-45ce-8487-60ca1510e72a",
      "type": "BILL"
    }
  }
}

GET

users

{user_identifier}

members

{member_identifier}

accounts

{account_identifier}

transactions

{transaction_identifier}

Read transaction by account

curl --request GET \
  --url https://int-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier} \
  --header 'Accept-Version: <accept-version>' \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://int-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}"

headers = {
    "Accept-Version": "<accept-version>",
    "Authorization": "Basic <encoded-value>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'Accept-Version': '<accept-version>', Authorization: 'Basic <encoded-value>'}
};

fetch('https://int-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}', 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-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept-Version: <accept-version>",
    "Authorization: Basic <encoded-value>"
  ],
]);

$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-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}"

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

	req.Header.Add("Accept-Version", "<accept-version>")
	req.Header.Add("Authorization", "Basic <encoded-value>")

	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-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}")
  .header("Accept-Version", "<accept-version>")
  .header("Authorization", "Basic <encoded-value>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://int-api.mx.com/users/{user_identifier}/members/{member_identifier}/accounts/{account_identifier}/transactions/{transaction_identifier}")

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

request = Net::HTTP::Get.new(url)
request["Accept-Version"] = '<accept-version>'
request["Authorization"] = 'Basic <encoded-value>'

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

{
  "transaction": {
    "amount": 61.11,
    "currency_code": "USD",
    "date": "2024-12-20",
    "description": "MX Technologies Payroll",
    "guid": "TRN-429ad9fe-a1d2-4559-8590-885b2603f0e1",
    "id": "1734681600000-178fa8095c154a55b9172f977b4c5f9a-0",
    "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/transactions/TRN-429ad9fe-a1d2-4559-8590-885b2603f0e1",
    "status": "POSTED",
    "type": "CREDIT",
    "account": {
      "account_number_display": "3331261",
      "subtype": "CHECKING",
      "type": "CHECKING",
      "guid": "ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1",
      "id": "1040434698",
      "name": "Test account 2",
      "nickname": "Swiss Account",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/accounts/ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1"
    },
    "member": {
      "guid": "MBR-7c6f361b-e582-15b6-60c0-358f12466b4b",
      "id": "unique_id",
      "metadata": "some metadata",
      "name": "MX Bank",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/members/MBR-7c6f361b-e582-15b6-60c0-358f12466b4b"
    },
    "user": {
      "guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c",
      "id": "unique_id",
      "metadata": "some metadata",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
    },
    "mx_record": {
      "created_at": "2025-05-10T18:08:00Z",
      "updated_at": "2026-02-12T22:48:21Z"
    },
    "category": {
      "guid": "CAT-b6d61a19-30a7-e852-2703-bdfb4072289e",
      "name": "Paycheck",
      "top_level_category": "Income",
      "self": "/categories/CAT-b6d61a19-30a7-e852-2703-bdfb4072289e"
    },
    "counterparties": [
      {
        "confidence_level": "Very High",
        "guid": "MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84",
        "logo_url": "https://content.mx.com/logos/merchants/MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84.png",
        "name": "MX",
        "website_url": "https://www.example.com"
      }
    ],
    "merchant": {
      "confidence_level": "Very High",
      "guid": "MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84",
      "logo_url": "https://content.mx.com/logos/merchants/MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84.png",
      "name": "MX",
      "self": "/merchants/MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84",
      "website_url": "https://www.example.com"
    },
    "repeating_transaction": {
      "frequency": "EVERY_MONTH",
      "guid": "RPT-065b8b1d-826a-45ce-8487-60ca1510e72a",
      "self": "/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/repeating_transactions/RPT-065b8b1d-826a-45ce-8487-60ca1510e72a",
      "type": "BILL"
    }
  }
}

Authorizations

Authorization

string

header

required

To authenticate with the Platform API, include your Base64-encoded client_id and api_key in the Authorization header of every request:

-H 'Authorization: Basic BASE_64_ENCODING_OF{client_id:api_key}'

Headers

Accept-Version

string

default:v20260929

required

MX Platform API version.

Example:

"v20260929"

Path Parameters

user_identifier

string

required

Use either the user id you defined or the MX-defined user guid. See Assigning Resource IDs.

member_identifier

string

required

Use either the member id you defined or the MX-defined member guid. See Assigning Resource IDs.

account_identifier

string

required

Use either the account id you defined or the MX-defined account guid. See Assigning Resource IDs.

transaction_identifier

string

required

Use either the transaction id you defined or the MX-defined transaction guid. See Assigning Resource IDs.

Query Parameters

includes

enum<string>[]

Enrich transaction responses with additional metadata. Pass one or more values as an array to selectively include data.

Accepted values: category, counterparties, merchant, repeating_transaction.

Example: ?includes[]=category&includes[]=merchant

Any other value, or a comma-separated string, returns a 400 error.

Available options:

category,

counterparties,

merchant,

repeating_transaction

Response

200 - application/json

transaction

object

Extended transaction response. The category, counterparties, merchant, and repeating_transaction objects are only present when requested via the includes[] query parameter. When included but no data exists, the value is null.

Hide child attributes

transaction.amount

number

The monetary amount of the transaction.

Example:

61.11

transaction.currency_code

string | null

The three-character ISO 4217 currency code, for example, USD.

Example:

"USD"

transaction.date

string | null

The date on which the transaction took place. This is the field used when searching for transactions by date and is generally the same as transacted_at, but uses posted_at as a fallback.

Example:

"2024-12-20"

transaction.description

string | null

A human-readable description of the transaction.

Example:

"MX Technologies Payroll"

transaction.guid

string | null

The unique identifier for the transaction. Defined by MX.

Example:

"TRN-429ad9fe-a1d2-4559-8590-885b2603f0e1"

transaction.id

string | null

The unique partner-defined identifier for the transaction.

Example:

"1734681600000-178fa8095c154a55b9172f977b4c5f9a-0"

transaction.self

string

The API URI path to access the transaction details.

Example:

"/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/transactions/TRN-429ad9fe-a1d2-4559-8590-885b2603f0e1"

transaction.status

enum<string> | null

The status of the transaction.

All transaction data on our systems represent what we get through our data feed which depends what institutions make available for aggregation. Many institutions do not provide data for pending transactions; transactions from those accounts always have a status of POSTED.

When we do receive data for pending transactions, a single transaction may be updated from PENDING to POSTED and keep the same guid. This is done through various matching methods performed automatically by MX.

If a single transaction can't be updated, the PENDING transaction will often be deleted and replaced with a new POSTED transaction (with a new guid) when it is sent to us; this is the most common scenario when pending data is available.

In unusual circumstances, there may be separate PENDING and POSTED transactions on MX systems for up to 14 days. All PENDING transactions are deleted after 14 days as a failsafe.

Available options:

POSTED,

PENDING

Example:

"POSTED"

transaction.type

enum<string> | null

The type of transaction.

Available options:

CREDIT,

DEBIT

Example:

"CREDIT"

transaction.account

object

The base fields for an account. Returned as the account companion on related resources such as transactions, statements, and rewards, and as the foundation of full account responses.

Hide child attributes

transaction.account.account_number_display

string | null

The account number associated with the account. This will typically be a masked or partial account number.

Example:

"3331261"

transaction.account.subtype

string | null

The account's subtype, for example, PLAN_401_K, MONEY_MARKET, or HOME_EQUITY. Each subtype belongs to an account type. For a full list of account subtypes and types, see Accounts.

Example:

"CHECKING"

transaction.account.type

enum<string> | null

The type of account. Some account types may include subtypes. For a full list of account types and subtypes, see Account Types.

Available options:

ANY,

CASH,

CHECKING,

CHECKING_LINE_OF_CREDIT,

CREDIT_CARD,

LOAN,

LINE_OF_CREDIT,

SAVINGS,

INVESTMENT,

MORTGAGE,

INSURANCE,

PREPAID,

PROPERTY

Example:

"CHECKING"

transaction.account.guid

string | null

Unique identifier for the account. Defined by MX.

Example:

"ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1"

transaction.account.id

string | null

The unique partner-defined identifier for the account.

Example:

"1040434698"

transaction.account.name

string

The human-readable name for the account.

Example:

"Test account 2"

transaction.account.nickname

string

An alternate name for the account.

Example:

"Swiss Account"

transaction.account.self

string

The API URI path for the account.

Example:

"/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/accounts/ACT-06d7f44b-caae-0f6e-1384-01f52e75dcb1"

transaction.member

object

The base fields for a member, which is a user's connection to an institution. Returned as the member companion on related resources such as accounts and transactions, and as the foundation of full member responses.

Hide child attributes

transaction.member.guid

string

The unique identifier for the member. Defined by MX.

Example:

"MBR-7c6f361b-e582-15b6-60c0-358f12466b4b"

transaction.member.id

string | null

The unique partner-defined identifier for the member.

Example:

"unique_id"

transaction.member.metadata

string | null

Additional information you can store about the member.

Example:

"some metadata"

transaction.member.name

string | null

The name of the member.

Example:

"MX Bank"

transaction.member.self

string

The API URI path for the member.

Example:

"/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/members/MBR-7c6f361b-e582-15b6-60c0-358f12466b4b"

transaction.user

object

The base fields for a user. Returned as the user companion on related resources such as members, accounts, and transactions, and as the foundation of full user responses.

Hide child attributes

transaction.user.guid

string

The unique identifier for the user. Defined by MX.

Example:

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

transaction.user.id

string | null

The unique partner-defined identifier for the user.

Example:

"unique_id"

transaction.user.metadata

string | null

Additional information you can store about the user.

Example:

"some metadata"

transaction.user.self

string

The API URI path for the user.

Example:

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

transaction.mx_record

object

Timestamps for when MX created and last updated the record. Returned as the mx_record companion on all resources persisted by MX. These describe the MX record, not the underlying resource at the institution.

Hide child attributes

transaction.mx_record.created_at

string | null

The date and time the resource was created in MX Platform, represented in ISO 8601 format with a timestamp.

Example:

"2025-05-10T18:08:00Z"

transaction.mx_record.updated_at

string | null

The date and time the resource was last updated in MX Platform, represented in ISO 8601 format with a timestamp.

For categories, this field will always be null when is_default is true.

Example:

"2026-02-12T22:48:21Z"

transaction.category

object | null

Only present when includes[]=category is specified. Null when no category is associated with the transaction.

Hide child attributes

transaction.category.guid

string

The unique identifier for the category. Defined by MX.

Example:

"CAT-b6d61a19-30a7-e852-2703-bdfb4072289e"

transaction.category.name

string

The name of the category.

Example:

"Paycheck"

transaction.category.top_level_category

string | null

The parent category assigned to this transaction's category.

Example:

"Income"

transaction.category.self

string | null

The API URI path to access the category details.

Example:

"/categories/CAT-b6d61a19-30a7-e852-2703-bdfb4072289e"

transaction.counterparties

object[] | null

Only present when includes[]=counterparties is specified. Null when no counterparties are associated with the transaction.

Hide child attributes

transaction.counterparties.confidence_level

string | null

The confidence level of the counterparty match, represented as "Very High" or "Low".

Example:

"Very High"

transaction.counterparties.guid

string | null

The unique identifier for the counterparty. Defined by MX.

Example:

"MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84"

transaction.counterparties.logo_url

string | null

The URL for a 100px X 100px logo for the counterparty.

Example:

"https://content.mx.com/logos/merchants/MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84.png"

transaction.counterparties.name

string

The name of the counterparty.

Example:

"MX"

transaction.counterparties.website_url

string | null

The URL for the counterparty's website.

Example:

"https://www.example.com"

transaction.merchant

object | null

Only present when includes[]=merchant is specified. Null when no merchant is associated with the transaction.

Hide child attributes

transaction.merchant.confidence_level

string | null

The confidence level of the merchant assignment for the transaction, represented as "Very High" or "Low".

Example:

"Very High"

transaction.merchant.guid

string

The unique identifier for the merchant. Defined by MX.

Example:

"MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84"

transaction.merchant.logo_url

string

The URL for a 100px X 100px logo for the merchant.

Example:

"https://content.mx.com/logos/merchants/MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84.png"

transaction.merchant.name

string

The name of the merchant.

Example:

"MX"

transaction.merchant.self

string | null

The API URI path to access the merchant details.

Example:

"/merchants/MCH-0c25f895-393c-42a4-9c18-95a0b26d4d84"

transaction.merchant.website_url

string

URL to the merchant's website.

Example:

"https://www.example.com"

transaction.repeating_transaction

object | null

Only present when includes[]=repeating_transaction is specified. Null when no repeating transaction is associated with the transaction.

Hide child attributes

transaction.repeating_transaction.frequency

enum<string>

The frequency at which the transaction is expected to repeat. See Supported Recurrence Types.

Available options:

EVERY_WEEK,

EVERY_OTHER_WEEK,

TWICE_A_MONTH,

EVERY_MONTH,

EVERY_OTHER_MONTH,

EVERY_QUARTER,

EVERY_OTHER_QUARTER,

EVERY_YEAR,

UNKNOWN

Example:

"EVERY_MONTH"

transaction.repeating_transaction.guid

string

The unique identifier for the repeating transaction. Defined by MX.

Example:

"RPT-065b8b1d-826a-45ce-8487-60ca1510e72a"

transaction.repeating_transaction.self

string | null

The API URI path to access the repeating transaction details.

Example:

"/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/repeating_transactions/RPT-065b8b1d-826a-45ce-8487-60ca1510e72a"

transaction.repeating_transaction.type

enum<string>

The type of the repeating transaction.

Available options:

BILL,

SUBSCRIPTION,

INCOME,

UNKNOWN