Skip to main content
GET
/
v1
/
transactions
List Transactions
curl --request GET \
  --url https://sandbox-api.va.meridianpay.com/v1/transactions
{
  "data": [
    {
      "id": "txn_01JMERCRYPTOACH01",
      "type": "DEPOSIT",
      "createdAt": "2026-04-30T15:00:00Z",
      "updatedAt": "2026-04-30T15:02:00Z",
      "status": "COMPLETED",
      "statusReason": null,
      "externalId": null,
      "depositReconciliationId": null,
      "referenceNumber": "dep-20260430-1001",
      "relatedTransactionId": null,
      "debitAmount": "7250.00",
      "debitCurrency": "USD",
      "debitParty": {
        "partyType": "PAYER",
        "payer": {
          "displayName": "Northwind Realty LLC",
          "accountNumber": "****1098"
        }
      },
      "debitRail": "US.USD.ACH",
      "debitMemo": "INV-23014",
      "debitInstrument": null,
      "creditAmount": "7250.00",
      "creditCurrency": "USD",
      "creditParty": null,
      "creditRail": null,
      "creditInstrument": {
        "instrumentType": "ACCOUNT",
        "account": {
          "id": "acc_01JMERUSDCRYPTO01",
          "displayName": "US crypto funding account",
          "currency": "USD"
        }
      },
      "fees": [],
      "exchangeRate": "1",
      "tags": []
    },
    {
      "id": "txn_01JMERUSDCETH001",
      "type": "DEPOSIT",
      "createdAt": "2026-04-30T15:10:00Z",
      "updatedAt": "2026-04-30T15:12:00Z",
      "status": "COMPLETED",
      "statusReason": null,
      "externalId": null,
      "depositReconciliationId": "prop-ct-oak-7421",
      "referenceNumber": "dep-20260430-1002",
      "relatedTransactionId": null,
      "debitAmount": "15000.00",
      "debitCurrency": "USDC",
      "debitParty": {
        "partyType": "PAYER",
        "payer": {
          "displayName": "Harbor Digital Assets"
        }
      },
      "debitRail": "ETHEREUM_MAINNET",
      "debitMemo": "INV-23015",
      "debitInstrument": null,
      "creditAmount": "14999.00",
      "creditCurrency": "USD",
      "creditParty": null,
      "creditRail": null,
      "creditInstrument": {
        "instrumentType": "ACCOUNT",
        "account": {
          "id": "acc_01JMERUSDCRYPTO01",
          "displayName": "US crypto funding account",
          "currency": "USD"
        }
      },
      "fees": [
        {
          "type": "PROCESSING",
          "label": "Processing fee",
          "amount": "1.00",
          "currency": "USD"
        }
      ],
      "exchangeRate": "1",
      "tags": []
    },
    {
      "id": "txn_01JMEROAKDEP001",
      "type": "DEPOSIT",
      "createdAt": "2026-04-30T15:20:00Z",
      "updatedAt": "2026-04-30T15:22:00Z",
      "status": "COMPLETED",
      "statusReason": null,
      "externalId": null,
      "depositReconciliationId": "prop-ct-oak-7421",
      "referenceNumber": "dep-20260430-1003",
      "relatedTransactionId": "txn_01JMEROAKWDL001",
      "debitAmount": "125000.00",
      "debitCurrency": "USD",
      "debitParty": {
        "partyType": "PAYER",
        "payer": {
          "displayName": "Oak Street Escrow Services",
          "accountNumber": "****5800"
        }
      },
      "debitRail": "US.USD.FEDWIRE",
      "debitMemo": "INV-7421",
      "debitInstrument": null,
      "creditAmount": "125000.00",
      "creditCurrency": "USD",
      "creditParty": null,
      "creditRail": null,
      "creditInstrument": {
        "instrumentType": "ACCOUNT",
        "account": {
          "id": "acc_01JMEROAK7421",
          "displayName": "Oak Street Purchase Contract",
          "currency": "USD"
        }
      },
      "fees": [],
      "exchangeRate": "1",
      "tags": []
    },
    {
      "id": "txn_01JMEROAKWDL001",
      "type": "WITHDRAWAL",
      "createdAt": "2026-04-30T15:23:00Z",
      "updatedAt": "2026-04-30T15:25:00Z",
      "status": "COMPLETED",
      "statusReason": null,
      "externalId": null,
      "depositReconciliationId": "prop-ct-oak-7421",
      "referenceNumber": "wdl-20260430-2001",
      "relatedTransactionId": "txn_01JMEROAKDEP001",
      "debitAmount": "125000.00",
      "debitCurrency": "USD",
      "debitParty": null,
      "debitRail": null,
      "debitMemo": null,
      "debitInstrument": {
        "instrumentType": "ACCOUNT",
        "account": {
          "id": "acc_01JMEROAK7421",
          "displayName": "Oak Street Purchase Contract",
          "currency": "USD"
        }
      },
      "creditAmount": "7012500.00",
      "creditCurrency": "PHP",
      "creditParty": {
        "partyType": "BENEFICIARY",
        "beneficiary": {
          "beneficiaryType": "BUSINESS",
          "business": {
            "id": "uscp_01JMERBENEF001",
            "name": "PHP Settlement Account"
          }
        }
      },
      "creditRail": "PH.PHP.PESONET",
      "creditInstrument": {
        "instrumentType": "BANK_ACCOUNT",
        "bankAccount": {
          "id": "ba_01JMERPHSETTLE01",
          "displayName": "PHP Settlement Account",
          "currency": "PHP",
          "mask": "****4321"
        }
      },
      "fees": [],
      "exchangeRate": "56.10",
      "tags": []
    },
    {
      "id": "txn_01JMERMAPDEP001",
      "type": "DEPOSIT",
      "createdAt": "2026-04-30T15:30:00Z",
      "updatedAt": "2026-04-30T15:31:00Z",
      "status": "COMPLETED",
      "statusReason": null,
      "externalId": null,
      "depositReconciliationId": "prop-ct-maple-1188",
      "referenceNumber": "dep-20260430-1004",
      "relatedTransactionId": "txn_01JMERMAPWDL001",
      "debitAmount": "98000.00",
      "debitCurrency": "USD",
      "debitParty": {
        "partyType": "PAYER",
        "payer": {
          "displayName": "Maple Avenue Closing Group",
          "accountNumber": "****0056"
        }
      },
      "debitRail": "US.USD.ACH",
      "debitMemo": "INV-1188",
      "debitInstrument": null,
      "creditAmount": "98000.00",
      "creditCurrency": "USD",
      "creditParty": null,
      "creditRail": null,
      "creditInstrument": {
        "instrumentType": "ACCOUNT",
        "account": {
          "id": "acc_01JMERMAP1188",
          "displayName": "Maple Avenue Purchase Contract",
          "currency": "USD"
        }
      },
      "fees": [],
      "exchangeRate": "1",
      "tags": []
    },
    {
      "id": "txn_01JMERMAPWDL001",
      "type": "WITHDRAWAL",
      "createdAt": "2026-04-30T15:32:00Z",
      "updatedAt": "2026-04-30T15:34:00Z",
      "status": "COMPLETED",
      "statusReason": null,
      "externalId": null,
      "depositReconciliationId": "prop-ct-maple-1188",
      "referenceNumber": "wdl-20260430-2002",
      "relatedTransactionId": "txn_01JMERMAPDEP001",
      "debitAmount": "98000.00",
      "debitCurrency": "USD",
      "debitParty": null,
      "debitRail": null,
      "debitMemo": null,
      "debitInstrument": {
        "instrumentType": "ACCOUNT",
        "account": {
          "id": "acc_01JMERMAP1188",
          "displayName": "Maple Avenue Purchase Contract",
          "currency": "USD"
        }
      },
      "creditAmount": "5497800.00",
      "creditCurrency": "PHP",
      "creditParty": {
        "partyType": "BENEFICIARY",
        "beneficiary": {
          "beneficiaryType": "BUSINESS",
          "business": {
            "id": "uscp_01JMERBENEF001",
            "name": "PHP Settlement Account"
          }
        }
      },
      "creditRail": "PH.PHP.PESONET",
      "creditInstrument": {
        "instrumentType": "BANK_ACCOUNT",
        "bankAccount": {
          "id": "ba_01JMERPHSETTLE01",
          "displayName": "PHP Settlement Account",
          "currency": "PHP",
          "mask": "****4321"
        }
      },
      "fees": [],
      "exchangeRate": "56.10",
      "tags": []
    },
    {
      "id": "txn_01JMERRIVDEP001",
      "type": "DEPOSIT",
      "createdAt": "2026-04-30T15:40:00Z",
      "updatedAt": "2026-04-30T15:42:00Z",
      "status": "COMPLETED",
      "statusReason": null,
      "externalId": null,
      "depositReconciliationId": "prop-ct-river-5530",
      "referenceNumber": "dep-20260430-1005",
      "relatedTransactionId": "txn_01JMERRIVWDL001",
      "debitAmount": "157500.00",
      "debitCurrency": "USD",
      "debitParty": {
        "partyType": "PAYER",
        "payer": {
          "displayName": "River Tower Escrow Partners",
          "accountNumber": "****7701"
        }
      },
      "debitRail": "US.USD.FEDWIRE",
      "debitMemo": "INV-5530",
      "debitInstrument": null,
      "creditAmount": "157500.00",
      "creditCurrency": "USD",
      "creditParty": null,
      "creditRail": null,
      "creditInstrument": {
        "instrumentType": "ACCOUNT",
        "account": {
          "id": "acc_01JMERRIV5530",
          "displayName": "River Tower Purchase Contract",
          "currency": "USD"
        }
      },
      "fees": [],
      "exchangeRate": "1",
      "tags": []
    },
    {
      "id": "txn_01JMERRIVWDL001",
      "type": "WITHDRAWAL",
      "createdAt": "2026-04-30T15:43:00Z",
      "updatedAt": "2026-04-30T15:45:00Z",
      "status": "COMPLETED",
      "statusReason": null,
      "externalId": null,
      "depositReconciliationId": "prop-ct-river-5530",
      "referenceNumber": "wdl-20260430-2003",
      "relatedTransactionId": "txn_01JMERRIVDEP001",
      "debitAmount": "157500.00",
      "debitCurrency": "USD",
      "debitParty": null,
      "debitRail": null,
      "debitMemo": null,
      "debitInstrument": {
        "instrumentType": "ACCOUNT",
        "account": {
          "id": "acc_01JMERRIV5530",
          "displayName": "River Tower Purchase Contract",
          "currency": "USD"
        }
      },
      "creditAmount": "8835750.00",
      "creditCurrency": "PHP",
      "creditParty": {
        "partyType": "BENEFICIARY",
        "beneficiary": {
          "beneficiaryType": "BUSINESS",
          "business": {
            "id": "uscp_01JMERBENEF001",
            "name": "PHP Settlement Account"
          }
        }
      },
      "creditRail": "PH.PHP.PESONET",
      "creditInstrument": {
        "instrumentType": "BANK_ACCOUNT",
        "bankAccount": {
          "id": "ba_01JMERPHSETTLE01",
          "displayName": "PHP Settlement Account",
          "currency": "PHP",
          "mask": "****4321"
        }
      },
      "fees": [],
      "exchangeRate": "56.10",
      "tags": []
    }
  ],
  "pageIndex": 0,
  "pageSize": 25,
  "totalRecords": 8
}

Headers

​
Authorization
string

Bearer authentication header of the form Bearer {token}. Required for client-server (JWT) authentication. See Authentication.

​
X-Meridian-Program-Id
string

Identifies the program context for the request. Required for server-to-server (HMAC) authentication. See Authentication.

​
X-Meridian-User-Id
string

Identifies the Meridian user targeted by the request. Required for server-to-server (HMAC) authentication with MULTI_USER integrations; omit for SINGLE_USER. See Authentication.

​
X-Meridian-Api-Key
string

Partner API key issued by Meridian during provisioning. Required for server-to-server (HMAC) authentication. See Authentication.

​
X-Meridian-Timestamp
string

Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request. Required for server-to-server (HMAC) authentication. See Authentication.

​
X-Meridian-Signature
string

HMAC SHA-256 signature of the canonical request string, computed per request. Required for server-to-server (HMAC) authentication. See Authentication for how to construct it.

Response

The transactions for the authenticated account

Transactions associated with the authenticated Meridian account

​
data
Transaction · object[]
required

List of transactions

​
pageIndex
integer
required

Current page index

Example:

0

​
pageSize
integer
required

Number of records per page

Example:

25

​
totalRecords
integer
required

Total number of records

Example:

8