Accounts

List account transactions

Changed on

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

get/account/{accountId}/transactions

Request

  • Base URL
    https://api.mercury.com/api/v1
  • URL
    https://api.mercury.com/api/v1/account/{accountId}/transactions
  • Auth
    • HTTP bearer
    • or HTTP basic

Path parameters

accountIdstring uuid required

The Mercury account where invoice payments will be deposited. Use the /api/v1/accounts endpoint to list your accounts and find the corresponding id. Only checking and savings accounts are supported.

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

status'pending' | 'sent' | 'cancelled' | 'failed' | 'reversed' | 'blocked'
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.

Changes

  • ab652aa5aa8eRevision changes
    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • info

      media type application/json was changed to application/json;charset=utf-8 for the response status

    • info

      removed subschema #2 from the // response property allOf list for the response status

    • info

      removed subschema #2 from the /////// response property allOf list for the response status

    • info

      removed subschema #2 from the // response property allOf list for the response status

    • info

      removed subschema #2 from the /////// response property allOf list for the response status

    • info

      removed the MerchantRefundToOriginalCharge enum value from the //////// response property for the response status

    • info

      removed the OriginalChargeToMerchantRefund enum value from the //////// response property for the response status

    • info

      removed the interestPayment enum value from the ////// response property for the response status

  • 0bdf4a496e03Revision changes
    • warning

      added the new interestPayment enum value to the ////// response property for the response status