---
title: "Changes to Search transactions for a merchant with filtering and sorting"
method: POST
path: "/api/v1/merchants/{id}/transactions"
---

# Changes to Search transactions for a merchant with filtering and sorting

`POST /api/v1/merchants/{id}/transactions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 8 revisions.

- **2026-06-16** `b372e7d5563d` — 3 breaking, 9 warning, 31 info
- **2025-11-03** `6637b341d86d` — 1 info
- **2025-11-02** `919eb7a392aa` — 1 breaking

## Changes

- **2026-06-16** `b372e7d5563d` — 3 breaking, 9 warning, 31 info
  - the `search/currency/eq` request property's minLength was increased from `0` to `3`
  - the `error/code` response's property type changed from `string` to no type for status `400`
  - the `totals/items/total_amount` response's property type changed from `string` to `number` for status `200`
  - the `search/currency/eq` request property's maxLength was set to `3`
  - changed the pattern of the request property `search/currency/eq` from `^[A-Z]{3}$` to `^[A-Za-z]{3}$`
  - removed the optional property `error/errors` from the response with the `400` status
  - added the new `converted` enum value to the `data/items/status` response property for the response status `200`
  - added the new `converted_amount` enum value to the `search_metadata/sort_applied/items/field` response property for the response status `200`
  - added the new `fee_paid` enum value to the `data/items/status` response property for the response status `200`
  - added the new `received` enum value to the `data/items/status` response property for the response status `200`
  - added the new `reversal` enum value to the `data/items/transaction_type` response property for the response status `200`
  - added the new `unknown` enum value to the `data/items/status` response property for the response status `200`
  - added the new optional request property `include_all_statuses`
  - added the new optional request property `search/id`
  - added the new optional request property `search/payout_batch_id`
  - added the new optional request property `search/status/in`
  - added the new optional request property `search/transaction_type/in`
  - the request property `search/status/eq` became optional
  - the request property `search/transaction_type/eq` became optional
  - added the new `converted_amount` enum value to the request property `sort/items/field`
  - added the new `fully_refunded` enum value to the request property `search/status/eq`
  - added the new `partially_refunded` enum value to the request property `search/status/eq`
  - added the new `refunding` enum value to the request property `search/status/eq`
  - added the new `refunding_failed` enum value to the request property `search/status/eq`
  - added the new `refunding_stuck` enum value to the request property `search/status/eq`
  - added the optional property `data/items/fees` to the response with the `200` status
  - added the optional property `data/items/problems` to the response with the `200` status
  - added the optional property `data/items/refunds` to the response with the `200` status
  - added the optional property `data/items/reversals` to the response with the `200` status
  - added the optional property `data/items/target_status` to the response with the `200` status
  - added the optional property `error/metadata` to the response with the `400` status
  - added `subschema #1, subschema #2` to the `error/code` response property `allOf` list for the response status `400`
  - removed the `processing` enum value from the `data/items/status` response property for the response status `200`
  - the `data/items/currency/code` response's property pattern `^[A-Za-z]{3}$` was added for the status `200`
  - the `totals/items/currency` response's property pattern was changed from `^[A-Z]{3}$` to `^[A-Za-z]{3}$` for the status `200`
  - added the required property `data/items/can_refund` to the response with the `200` status
  - added the required property `data/items/converted_amount` to the response with the `200` status
  - added the required property `data/items/exchange_rate` to the response with the `200` status
  - added the required property `data/items/payout_at` to the response with the `200` status
  - added the required property `data/items/payout_batch_id` to the response with the `200` status
  - …3 more
- **2025-11-03** `6637b341d86d` — 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/merchants/:id/transactions/post.md) · [API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) · [Page](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/merchants/:id/transactions/post)