Transactions

List all transactions

Changed on

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

get/transactions

Request

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

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[]
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'

Changes

  • ab652aa5aa8eRevision changes
    • breaking

      the response's property type changed from object to no type for 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

    • breaking

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

    • warning

      deleted the query request parameter cardId

    • warning

      removed the optional 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

    • 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

      added to 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 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