Update managed transaction
curl --request PUT \
--url https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid} \
--header 'Accept-Version: <accept-version>' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"transaction": {
"amount": "61.11",
"category": "Groceries",
"check_number_string": "6812",
"currency_code": "USD",
"description": "Whole foods",
"id": "transaction-265abee9-889b-af6a-c69b-25157db2bdd9",
"is_international": false,
"latitude": -43.2075,
"localized_description": "This is a localized_description",
"localized_memo": "This is a localized_memo",
"longitude": 139.691706,
"memo": "This is a memo",
"merchant_category_code": 5411,
"merchant_guid": "MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b",
"merchant_location_guid": "MCL-00024e59-18b5-4d79-b879-2a7896726fea",
"metadata": "some metadata",
"posted_at": "2016-10-07T06:00:00.000Z",
"status": "POSTED",
"transacted_at": "2016-10-06T13:00:00.000Z",
"type": "DEBIT"
}
}
'import requests
url = "https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}"
payload = { "transaction": {
"amount": "61.11",
"category": "Groceries",
"check_number_string": "6812",
"currency_code": "USD",
"description": "Whole foods",
"id": "transaction-265abee9-889b-af6a-c69b-25157db2bdd9",
"is_international": False,
"latitude": -43.2075,
"localized_description": "This is a localized_description",
"localized_memo": "This is a localized_memo",
"longitude": 139.691706,
"memo": "This is a memo",
"merchant_category_code": 5411,
"merchant_guid": "MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b",
"merchant_location_guid": "MCL-00024e59-18b5-4d79-b879-2a7896726fea",
"metadata": "some metadata",
"posted_at": "2016-10-07T06:00:00.000Z",
"status": "POSTED",
"transacted_at": "2016-10-06T13:00:00.000Z",
"type": "DEBIT"
} }
headers = {
"Accept-Version": "<accept-version>",
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'Accept-Version': '<accept-version>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
transaction: {
amount: '61.11',
category: 'Groceries',
check_number_string: '6812',
currency_code: 'USD',
description: 'Whole foods',
id: 'transaction-265abee9-889b-af6a-c69b-25157db2bdd9',
is_international: false,
latitude: -43.2075,
localized_description: 'This is a localized_description',
localized_memo: 'This is a localized_memo',
longitude: 139.691706,
memo: 'This is a memo',
merchant_category_code: 5411,
merchant_guid: 'MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b',
merchant_location_guid: 'MCL-00024e59-18b5-4d79-b879-2a7896726fea',
metadata: 'some metadata',
posted_at: '2016-10-07T06:00:00.000Z',
status: 'POSTED',
transacted_at: '2016-10-06T13:00:00.000Z',
type: 'DEBIT'
}
})
};
fetch('https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}', 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_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'transaction' => [
'amount' => '61.11',
'category' => 'Groceries',
'check_number_string' => '6812',
'currency_code' => 'USD',
'description' => 'Whole foods',
'id' => 'transaction-265abee9-889b-af6a-c69b-25157db2bdd9',
'is_international' => false,
'latitude' => -43.2075,
'localized_description' => 'This is a localized_description',
'localized_memo' => 'This is a localized_memo',
'longitude' => 139.691706,
'memo' => 'This is a memo',
'merchant_category_code' => 5411,
'merchant_guid' => 'MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b',
'merchant_location_guid' => 'MCL-00024e59-18b5-4d79-b879-2a7896726fea',
'metadata' => 'some metadata',
'posted_at' => '2016-10-07T06:00:00.000Z',
'status' => 'POSTED',
'transacted_at' => '2016-10-06T13:00:00.000Z',
'type' => 'DEBIT'
]
]),
CURLOPT_HTTPHEADER => [
"Accept-Version: <accept-version>",
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}"
payload := strings.NewReader("{\n \"transaction\": {\n \"amount\": \"61.11\",\n \"category\": \"Groceries\",\n \"check_number_string\": \"6812\",\n \"currency_code\": \"USD\",\n \"description\": \"Whole foods\",\n \"id\": \"transaction-265abee9-889b-af6a-c69b-25157db2bdd9\",\n \"is_international\": false,\n \"latitude\": -43.2075,\n \"localized_description\": \"This is a localized_description\",\n \"localized_memo\": \"This is a localized_memo\",\n \"longitude\": 139.691706,\n \"memo\": \"This is a memo\",\n \"merchant_category_code\": 5411,\n \"merchant_guid\": \"MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b\",\n \"merchant_location_guid\": \"MCL-00024e59-18b5-4d79-b879-2a7896726fea\",\n \"metadata\": \"some metadata\",\n \"posted_at\": \"2016-10-07T06:00:00.000Z\",\n \"status\": \"POSTED\",\n \"transacted_at\": \"2016-10-06T13:00:00.000Z\",\n \"type\": \"DEBIT\"\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Accept-Version", "<accept-version>")
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}")
.header("Accept-Version", "<accept-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"transaction\": {\n \"amount\": \"61.11\",\n \"category\": \"Groceries\",\n \"check_number_string\": \"6812\",\n \"currency_code\": \"USD\",\n \"description\": \"Whole foods\",\n \"id\": \"transaction-265abee9-889b-af6a-c69b-25157db2bdd9\",\n \"is_international\": false,\n \"latitude\": -43.2075,\n \"localized_description\": \"This is a localized_description\",\n \"localized_memo\": \"This is a localized_memo\",\n \"longitude\": 139.691706,\n \"memo\": \"This is a memo\",\n \"merchant_category_code\": 5411,\n \"merchant_guid\": \"MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b\",\n \"merchant_location_guid\": \"MCL-00024e59-18b5-4d79-b879-2a7896726fea\",\n \"metadata\": \"some metadata\",\n \"posted_at\": \"2016-10-07T06:00:00.000Z\",\n \"status\": \"POSTED\",\n \"transacted_at\": \"2016-10-06T13:00:00.000Z\",\n \"type\": \"DEBIT\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Accept-Version"] = '<accept-version>'
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transaction\": {\n \"amount\": \"61.11\",\n \"category\": \"Groceries\",\n \"check_number_string\": \"6812\",\n \"currency_code\": \"USD\",\n \"description\": \"Whole foods\",\n \"id\": \"transaction-265abee9-889b-af6a-c69b-25157db2bdd9\",\n \"is_international\": false,\n \"latitude\": -43.2075,\n \"localized_description\": \"This is a localized_description\",\n \"localized_memo\": \"This is a localized_memo\",\n \"longitude\": 139.691706,\n \"memo\": \"This is a memo\",\n \"merchant_category_code\": 5411,\n \"merchant_guid\": \"MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b\",\n \"merchant_location_guid\": \"MCL-00024e59-18b5-4d79-b879-2a7896726fea\",\n \"metadata\": \"some metadata\",\n \"posted_at\": \"2016-10-07T06:00:00.000Z\",\n \"status\": \"POSTED\",\n \"transacted_at\": \"2016-10-06T13:00:00.000Z\",\n \"type\": \"DEBIT\"\n }\n}"
response = http.request(request)
puts response.read_bodyManaged Data [Sunset]
Update managed transaction
deprecated
Sunset. This endpoint was sunset on 2026-09-29 and no longer returns data — it responds with 410 Gone on all API versions. There is no direct replacement; to send data held at your institution to MX, use MDX Real Time. See Deprecations for details.
PUT
/
users
/
{user_guid}
/
managed_members
/
{member_guid}
/
accounts
/
{account_guid}
/
transactions
/
{transaction_guid}
Update managed transaction
curl --request PUT \
--url https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid} \
--header 'Accept-Version: <accept-version>' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"transaction": {
"amount": "61.11",
"category": "Groceries",
"check_number_string": "6812",
"currency_code": "USD",
"description": "Whole foods",
"id": "transaction-265abee9-889b-af6a-c69b-25157db2bdd9",
"is_international": false,
"latitude": -43.2075,
"localized_description": "This is a localized_description",
"localized_memo": "This is a localized_memo",
"longitude": 139.691706,
"memo": "This is a memo",
"merchant_category_code": 5411,
"merchant_guid": "MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b",
"merchant_location_guid": "MCL-00024e59-18b5-4d79-b879-2a7896726fea",
"metadata": "some metadata",
"posted_at": "2016-10-07T06:00:00.000Z",
"status": "POSTED",
"transacted_at": "2016-10-06T13:00:00.000Z",
"type": "DEBIT"
}
}
'import requests
url = "https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}"
payload = { "transaction": {
"amount": "61.11",
"category": "Groceries",
"check_number_string": "6812",
"currency_code": "USD",
"description": "Whole foods",
"id": "transaction-265abee9-889b-af6a-c69b-25157db2bdd9",
"is_international": False,
"latitude": -43.2075,
"localized_description": "This is a localized_description",
"localized_memo": "This is a localized_memo",
"longitude": 139.691706,
"memo": "This is a memo",
"merchant_category_code": 5411,
"merchant_guid": "MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b",
"merchant_location_guid": "MCL-00024e59-18b5-4d79-b879-2a7896726fea",
"metadata": "some metadata",
"posted_at": "2016-10-07T06:00:00.000Z",
"status": "POSTED",
"transacted_at": "2016-10-06T13:00:00.000Z",
"type": "DEBIT"
} }
headers = {
"Accept-Version": "<accept-version>",
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'Accept-Version': '<accept-version>',
Authorization: 'Basic <encoded-value>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
transaction: {
amount: '61.11',
category: 'Groceries',
check_number_string: '6812',
currency_code: 'USD',
description: 'Whole foods',
id: 'transaction-265abee9-889b-af6a-c69b-25157db2bdd9',
is_international: false,
latitude: -43.2075,
localized_description: 'This is a localized_description',
localized_memo: 'This is a localized_memo',
longitude: 139.691706,
memo: 'This is a memo',
merchant_category_code: 5411,
merchant_guid: 'MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b',
merchant_location_guid: 'MCL-00024e59-18b5-4d79-b879-2a7896726fea',
metadata: 'some metadata',
posted_at: '2016-10-07T06:00:00.000Z',
status: 'POSTED',
transacted_at: '2016-10-06T13:00:00.000Z',
type: 'DEBIT'
}
})
};
fetch('https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}', 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_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'transaction' => [
'amount' => '61.11',
'category' => 'Groceries',
'check_number_string' => '6812',
'currency_code' => 'USD',
'description' => 'Whole foods',
'id' => 'transaction-265abee9-889b-af6a-c69b-25157db2bdd9',
'is_international' => false,
'latitude' => -43.2075,
'localized_description' => 'This is a localized_description',
'localized_memo' => 'This is a localized_memo',
'longitude' => 139.691706,
'memo' => 'This is a memo',
'merchant_category_code' => 5411,
'merchant_guid' => 'MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b',
'merchant_location_guid' => 'MCL-00024e59-18b5-4d79-b879-2a7896726fea',
'metadata' => 'some metadata',
'posted_at' => '2016-10-07T06:00:00.000Z',
'status' => 'POSTED',
'transacted_at' => '2016-10-06T13:00:00.000Z',
'type' => 'DEBIT'
]
]),
CURLOPT_HTTPHEADER => [
"Accept-Version: <accept-version>",
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}"
payload := strings.NewReader("{\n \"transaction\": {\n \"amount\": \"61.11\",\n \"category\": \"Groceries\",\n \"check_number_string\": \"6812\",\n \"currency_code\": \"USD\",\n \"description\": \"Whole foods\",\n \"id\": \"transaction-265abee9-889b-af6a-c69b-25157db2bdd9\",\n \"is_international\": false,\n \"latitude\": -43.2075,\n \"localized_description\": \"This is a localized_description\",\n \"localized_memo\": \"This is a localized_memo\",\n \"longitude\": 139.691706,\n \"memo\": \"This is a memo\",\n \"merchant_category_code\": 5411,\n \"merchant_guid\": \"MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b\",\n \"merchant_location_guid\": \"MCL-00024e59-18b5-4d79-b879-2a7896726fea\",\n \"metadata\": \"some metadata\",\n \"posted_at\": \"2016-10-07T06:00:00.000Z\",\n \"status\": \"POSTED\",\n \"transacted_at\": \"2016-10-06T13:00:00.000Z\",\n \"type\": \"DEBIT\"\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Accept-Version", "<accept-version>")
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}")
.header("Accept-Version", "<accept-version>")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"transaction\": {\n \"amount\": \"61.11\",\n \"category\": \"Groceries\",\n \"check_number_string\": \"6812\",\n \"currency_code\": \"USD\",\n \"description\": \"Whole foods\",\n \"id\": \"transaction-265abee9-889b-af6a-c69b-25157db2bdd9\",\n \"is_international\": false,\n \"latitude\": -43.2075,\n \"localized_description\": \"This is a localized_description\",\n \"localized_memo\": \"This is a localized_memo\",\n \"longitude\": 139.691706,\n \"memo\": \"This is a memo\",\n \"merchant_category_code\": 5411,\n \"merchant_guid\": \"MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b\",\n \"merchant_location_guid\": \"MCL-00024e59-18b5-4d79-b879-2a7896726fea\",\n \"metadata\": \"some metadata\",\n \"posted_at\": \"2016-10-07T06:00:00.000Z\",\n \"status\": \"POSTED\",\n \"transacted_at\": \"2016-10-06T13:00:00.000Z\",\n \"type\": \"DEBIT\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://int-api.mx.com/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Accept-Version"] = '<accept-version>'
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transaction\": {\n \"amount\": \"61.11\",\n \"category\": \"Groceries\",\n \"check_number_string\": \"6812\",\n \"currency_code\": \"USD\",\n \"description\": \"Whole foods\",\n \"id\": \"transaction-265abee9-889b-af6a-c69b-25157db2bdd9\",\n \"is_international\": false,\n \"latitude\": -43.2075,\n \"localized_description\": \"This is a localized_description\",\n \"localized_memo\": \"This is a localized_memo\",\n \"longitude\": 139.691706,\n \"memo\": \"This is a memo\",\n \"merchant_category_code\": 5411,\n \"merchant_guid\": \"MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b\",\n \"merchant_location_guid\": \"MCL-00024e59-18b5-4d79-b879-2a7896726fea\",\n \"metadata\": \"some metadata\",\n \"posted_at\": \"2016-10-07T06:00:00.000Z\",\n \"status\": \"POSTED\",\n \"transacted_at\": \"2016-10-06T13:00:00.000Z\",\n \"type\": \"DEBIT\"\n }\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
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
MX Platform API version.
Example:
"v20250224"
Path Parameters
The unique id for an account.
The unique id for a member.
The unique id for a transaction.
The unique identifier for a user, beginning with the prefix USR-.
Body
application/json
Managed transaction object to be updated (While no single parameter is required, the request body can't be empty)
Hide child attributes
Hide child attributes
The monetary amount of the transaction.
Example:
"61.11"
The category of the transaction.
Example:
"Groceries"
The check number for the transaction.
Example:
"6812"
The three-character ISO 4217 currency code, for example, USD.
Example:
"USD"
A human-readable version of the original_description field.
Example:
"Whole foods"
The unique partner-defined identifier for the transaction.
Example:
"transaction-265abee9-889b-af6a-c69b-25157db2bdd9"
Indicates whether the transaction is international. If the data provider determines it isn't international then it will be false. It will be null if the data provider does not have this information.
Example:
false
The latitude of the location where the transaction occurred. The number is a signed decimal.
Example:
-43.2075
A human-readable description of the transaction, provided in a local language.
Example:
"This is a localized_description"
Additional descriptive information about the transaction, provided in a local language.
Example:
"This is a localized_memo"
The longitude of the location where the transaction occurred. The number is a signed decimal.
Example:
139.691706
Additional information about the transaction.
Example:
"This is a memo"
The ISO 18245 category code for the transaction.
Example:
5411
The unique identifier for the merchant. Defined by MX.
Example:
"MCH-7ed79542-884d-2b1b-dd74-501c5cc9d25b"
The unique identifier for the merchant location. Defined by MX.
Example:
"MCL-00024e59-18b5-4d79-b879-2a7896726fea"
Additional information you can store about the transaction.
Example:
"some metadata"
The date and time the transaction was posted to the account.
Example:
"2016-10-07T06:00:00.000Z"
The status of the transaction. Can be either POSTED or PENDING.
Available options:
POSTED, PENDING Example:
"POSTED"
The date and time the transaction took place.
Example:
"2016-10-06T13:00:00.000Z"
The type of transaction. Can be either CREDIT or DEBIT.
Available options:
CREDIT, DEBIT Example:
"DEBIT"
Response
410
Gone. This endpoint was sunset on 2026-09-29 and no longer returns data — it responds with 410 Gone on all API versions. See Deprecations.