v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-2684278289.5 KB
Transactions

List all transactions

Retrieve a paginated list of all transactions across all accounts. Supports advanced filtering by date ranges, status, categories, and cursor-based pagination.

get/transactions

Query parameters

statusstring[]
searchstring

Search term to look for in transaction descriptions.

startstring

Earliest createdAt date to filter for. If not provided, it defaults to the date of your first transaction. Format: YYYY-MM-DD or an ISO 8601 string. Please note that your Mercury transactions on your Dashboard might have their postedAt date displayed, as opposed to createdAt

endstring

Latest createdAt date to filter for. If it’s not provided, it defaults to current day. Format: YYYY-MM-DD or an ISO 8601 string. Please note that your Mercury transactions on your Dashboard might have their postedAt date displayed, as opposed to createdAt

postedStartstring

Earliest postedAt date to filter for. Format: YYYY-MM-DD or an ISO 8601 string

postedEndstring

Latest postedAt date to filter for. Format: YYYY-MM-DD or an ISO 8601 string

accountIdstring[]
cardIdstring[]
mercuryCategorystring

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

categoryIdstring

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

start_atstring

The ID of the resource to start the page at (inclusive). When provided, results will begin with and include the resource with this ID. Use this to retrieve a specific page when you know the exact starting point. Cannot be combined with start_after or end_before.

start_afterstring uuid

The ID of the transaction to start the page after (exclusive). When provided, results will begin with the transaction immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.

end_beforestring uuid

The ID of the transaction to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.

limitinteger

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

order'asc' | 'desc'

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

Response

Example response

{
  "page": {
    "nextPage": "00000000-0000-0000-0000-000000000000",
    "previousPage": "00000000-0000-0000-0000-000000000000"
  },
  "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"
    }
  ]
}