Accounts

List account transactions

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

get/account/{accountId}/transactions

Path parameters

accountIdstring uuid required

ID for a Mercury account.

Query parameters

limitinteger

Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000

startstring

Earliest date to filter transactions. If not provided, defaults to 30 days before the current date. Format: YYYY-MM-DD or ISO 8601 string

endstring

Latest date to filter transactions. If not provided, defaults to the current date. Format: YYYY-MM-DD or ISO 8601 string

searchstring

Search term to filter transactions by description or counterparty name

offsetinteger

Number of results to skip for pagination

order'asc' | 'desc'

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

requestIdstring uuid

ID returned from /account/:id/request-send-money

mercuryCategorystring

Name of mercuryCategory you want to filter on. Merchant Type in the UI.

categoryIdstring uuid

UUID of a custom category. Can be returned from /categories endpoint.

Response

totalinteger required

Example response

{
  "transactions": [
    {
      "createdAt": "2016-07-22T00:00:00Z",
      "estimatedDeliveryDate": "2016-07-22T00:00:00Z",
      "failedAt": "2016-07-22T00:00:00Z",
      "postedAt": "2016-07-22T00:00:00Z"
    }
  ]
}

Changes

Changed in 4 of the 45 revisions of this API.35

Jul 22, 20260bdf4a496e031See the full diff
- ●
  added the new interestPayment enum value to the ////// response property for the response status
  response-property-enum-value-added
Jun 10, 2026621b18bfbb912See the full diff
- ●
  added the new MerchantRefundToOriginalCharge enum value to the //////// response property for the response status
  response-property-enum-value-added
- ●
  added the new OriginalChargeToMerchantRefund enum value to the //////// response property for the response status
  response-property-enum-value-added
May 28, 20262108b9d605242See the full diff
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
Apr 23, 20263e266f593eb13See the full diff
- ○
  added the required property /////// to the response with the status
  response-required-property-added
- ○
  added the required property /////// to the response with the status
  response-required-property-added
- ○
  added the required property /////// to the response with the status
  response-required-property-added

Full history