List account transactions

{
  "total": 1,
  "transactions": [
    {
      "accountId": "string",
      "amount": 1.1,
      "attachments": [
        {
          "attachmentType": "checkImage",
          "fileName": "string",
          "url": "string"
        }
      ],
      "compliantWithReceiptPolicy": true,
      "counterpartyId": "string",
      "counterpartyName": "string",
      "createdAt": {},
      "dashboardLink": "string",
      "estimatedDeliveryDate": {},
      "glAllocations": [
        {
          "amount": 1.1,
          "glCodeName": "string",
          "description": "string"
        }
      ],
      "hasGeneratedReceipt": true,
      "id": "string",
      "kind": "externalTransfer",
      "relatedTransactions": [
        {
          "accountId": "string",
          "amount": 1.1,
          "id": "string",
          "relationKind": "ProvisionalCreditReversalToMerchantRefund"
        }
      ],
      "status": "pending",
      "bankDescription": "string",
      "categoryData": {
        "id": "string",
        "name": "string",
        "visibleForCardSpend": true,
        "visibleForOther": true,
        "visibleForReimbursements": true
      },
      "checkNumber": "string",
      "counterpartyNickname": "string",
      "creditAccountPeriodId": "string",
      "currencyExchangeInfo": {
        "convertedFromAmount": 1.1,
        "convertedFromCurrency": "USD",
        "convertedToAmount": 1.1,
        "convertedToCurrency": "USD",
        "exchangeRate": 1.1,
        "feeAmount": 1.1,
        "feePercentage": 1.1,
        "feeTransactionId": "string"
      },
      "details": {
        "address": {
          "address1": "string",
          "city": "string",
          "postalCode": "string",
          "address2": "string",
          "state": "AL"
        },
        "creditCardInfo": {
          "id": "string",
          "paymentMethod": "string",
          "email": "string"
        },
        "debitCardInfo": {
          "id": "string"
        },
        "domesticWireRoutingInfo": {
          "accountNumber": "string",
          "routingNumber": "string",
          "address": {
            "address1": "string",
            "city": "string",
            "country": "US",
            "postalCode": "string",
            "region": "CA",
            "address2": "string"
          },
          "bankName": "string"
        },
        "electronicRoutingInfo": {
          "accountNumber": "string",
          "electronicAccountType": "businessChecking",
          "routingNumber": "string",
          "address": {
            "address1": "string",
            "city": "string",
            "country": "US",
            "postalCode": "string",
            "region": "CA",
            "address2": "string"
          },
          "bankName": "string"
        },
        "internationalWireRoutingInfo": {
          "countrySpecific": {
            "australia": {
              "bsbCode": "string"
            },
            "brazil": {
              "legalId": "string"
            },
            "canada": {
              "bankCode": "string",
              "transitNumber": "string"
            },
            "chile": {
              "legalId": "string"
            },
            "colombia": {
              "legalId": "string"
            },
            "dominicanRepublic": {
              "accountType": "checking",
              "legalId": "string"
            },
            "honduras": {
              "accountType": "checking",
              "legalId": "string"
            },
            "india": {
              "ifscCode": "string"
            },
            "kazakhstan": {
              "legalId": "string"
            },
            "pakistan": {
              "legalId": "string",
              "legalIdType": "CNIC"
            },
            "paraguay": {
              "legalId": "string"
            },
            "philippines": {
              "routingNumber": "string"
            },
            "russia": {
              "inn": "string"
            },
            "southAfrica": {
              "branchCode": "string"
            }
          },
          "iban": "string",
          "swiftCode": "string",
          "address": {
            "address1": "string",
            "city": "string",
            "country": "US",
            "postalCode": "string",
            "region": "CA",
            "address2": "string"
          },
          "bankDetails": {
            "bankCityState": "string",
            "bankCountry": "US",
            "bankName": "string"
          },
          "correspondentInfo": {
            "bankName": "string",
            "routingNumber": "string",
            "swiftCode": "string"
          },
          "emailAddress": "string",
          "phoneNumber": "string"
        }
      },
      "externalMemo": "string",
      "failedAt": {},
      "feeId": "string",
      "generalLedgerCodeName": "string",
      "merchant": {
        "amount": 1,
        "category": "Other",
        "categoryCode": "string",
        "currency": "USD",
        "id": "string"
      },
      "mercuryCategory": "Other",
      "note": "string",
      "postedAt": {},
      "reasonForFailure": "string",
      "requestId": "string",
      "trackingNumber": "string"
    }
  ]
}

Retrieve a paginated list of transactions for a specific account. Supports filtering by date range, status, and search terms.

Authentication

AuthorizationBearer

Bearer token authentication for Mercury API.

Use your API token in the Authorization header: Authorization: Bearer TOKEN

Example: Authorization: Bearer secret-token:mercury_production_wma_24SCp4G81X3yHL4Wq8FgzuaP9ye3VKf2mgTDctXyRg5HY_yrucrem

Your Mercury API token should include the ‘secret-token:’ prefix. Tokens can be generated from your Mercury dashboard settings.

Path parameters

accountIdstringRequiredformat: "uuid"

Query parameters

limitlongOptional1-1000Defaults to 1000

startstringOptional

endstringOptional

searchstringOptional

statusenumOptional

offsetlongOptional>=0

orderenumOptionalDefaults to desc

Sort order. Can be 'asc' or 'desc'. Defaults to 'desc'

Allowed values:

requestIdstringOptionalformat: "uuid"

mercuryCategorystringOptional

categoryIdstringOptionalformat: "uuid"

Response

totalinteger-9223372036854776000-9223372036854776000

transactionslist of objects

Errors

400

Bad Request Error

404

Not Found Error