Sign in

v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-2684278289.5 KB
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

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.

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"
    }
  ]
}