Account Information10

Admin13

Agreement2

Auth4

Bank Predictions1

Banks9

Branding14

Command Palette2

Countries3

CrossBorder5

Customer Bank Accounts4

Customers3

Dashboard1

Default Rates3

Embedded8

Evidence1

Go Live2

Invoice10

Legal1

Legal Entities11

Merchant Bank Account Payment Schemes1

Merchant Bank Accounts6

Merchant Documents2

Merchant Invitations4

Merchant Rates3

Merchants16

Onboarding3

Partner Invitations4

Partners6

Payment1

Payment Links6

Payment Schemes1

Payments8

Payout6

Post-Processor Logs2

Provider Configuration4

Refund Resolution Links4

Refunds1

Seeds2

Shareholder Documents2

Shareholder Invitations7

Shopify Orders3

Transaction Updates (Token)3

Transactions14

User Invitations2

Users10

Webhook3

Webhooks5

Transactions

Search transactions for a merchant with filtering and sorting

post/api/v1/merchants/{id}/transactions

Path parameters

idstring uuid required

The unique identifier of the merchant

Example:123e4567-e89b-12d3-a456-426614174000

The unique identifier of the merchant

Request body

include_all_statusesboolean

When true, includes all transaction statuses (including in-progress states like fee_paid, converted). Useful for debugging. Default: false (only shows received, completed, failed).

Example request

{
  "search": {
    "amount": {
      "gte": 1000,
      "lte": 5000
    },
    "status": {
      "eq": "completed"
    },
    "customer_email": {
      "contains": "gmail"
    }
  },
  "pagination": {
    "page": 1,
    "limit": 25
  },
  "sort": [
    {
      "field": "created_at",
      "direction": "desc"
    }
  ]
}

Response

Success

successboolean required

Example response

{
  "data": [
    {
      "currency": {
        "code": "GBP",
        "symbol": "€",
        "name": "Euro",
        "minor_unit": 2
      },
      "payout_currency": {
        "code": "GBP",
        "symbol": "€",
        "name": "Euro",
        "minor_unit": 2
      },
      "payment_request": {
        "order_id": "ORD-2025-00123",
        "payment_token": "tok_abc123def456"
      },
      "fees": {
        "currency": {
          "code": "GBP",
          "symbol": "€",
          "name": "Euro",
          "minor_unit": 2
        },
        "items": [
          {
            "currency": {
              "code": "GBP",
              "symbol": "€",
              "name": "Euro",
              "minor_unit": 2
            }
          }
        ]
      },
      "refunds": [
        {
          "currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          },
          "payout_currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          },
          "payment_request": {
            "order_id": "ORD-2025-00123",
            "payment_token": "tok_abc123def456"
          },
          "fees": {
            "currency": {
              "code": "GBP",
              "symbol": "€",
              "name": "Euro",
              "minor_unit": 2
            },
            "items": [
              {
                "currency": {
                  "code": "GBP",
                  "symbol": "€",
                  "name": "Euro",
                  "minor_unit": 2
                }
              }
            ]
          }
        }
      ],
      "reversals": [
        {
          "currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          },
          "payout_currency": {
            "code": "GBP",
            "symbol": "€",
            "name": "Euro",
            "minor_unit": 2
          },
          "payment_request": {
            "order_id": "ORD-2025-00123",
            "payment_token": "tok_abc123def456"
          },
          "fees": {
            "currency": {
              "code": "GBP",
              "symbol": "€",
              "name": "Euro",
              "minor_unit": 2
            },
            "items": [
              {
                "currency": {
                  "code": "GBP",
                  "symbol": "€",
                  "name": "Euro",
                  "minor_unit": 2
                }
              }
            ]
          }
        }
      ]
    }
  ],
  "search_metadata": {
    "sort_applied": [
      {
        "field": "created_at",
        "direction": "desc"
      }
    ]
  },
  "totals": [
    {
      "currency": "EUR",
      "total_amount": 3034
    },
    {
      "currency": "GBP",
      "total_amount": 534
    },
    {
      "currency": "DKK",
      "total_amount": 2034
    }
  ]
}

Changes

Changed in 3 of the 8 revisions of this API.4932

Jun 16, 2026b372e7d5563d3931See the full diff
- ▲
  the // request property's minLength was increased from 0 to 3
  request-property-min-length-increased
- ▲
  the / response's property type changed from string to no type for status
  response-property-type-changed
- ▲
  the // response's property type changed from string to number for status
  response-property-type-changed
- ●
  the // request property's maxLength was set to 3
  request-property-max-length-set
- ●
  changed the pattern of the request property // from ^[A-Z]{3}$ to ^[A-Za-z]{3}$
  request-property-pattern-changed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  added the new converted enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new converted_amount enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new fee_paid enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new received enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new reversal enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown enum value to the // response property for the response status
  response-property-enum-value-added
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property /
  new-optional-request-property
- ○
  added the new optional request property /
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  added the new optional request property //
  new-optional-request-property
- ○
  the request property // became optional
  request-property-became-optional
- ○
  the request property // became optional
  request-property-became-optional
- ○
  added the new converted_amount enum value to the request property //
  request-property-enum-value-added
- ○
  added the new fully_refunded enum value to the request property //
  request-property-enum-value-added
- ○
  added the new partially_refunded enum value to the request property //
  request-property-enum-value-added
- ○
  added the new refunding enum value to the request property //
  request-property-enum-value-added
- ○
  added the new refunding_failed enum value to the request property //
  request-property-enum-value-added
- ○
  added the new refunding_stuck enum value to the request property //
  request-property-enum-value-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added subschema #1 subschema #2 to the / response property allOf list for the response status
  response-property-all-of-added
- ○
  removed the processing enum value from the // response property for the response status
  response-property-enum-value-removed
- ○
  the /// response's property pattern ^[A-Za-z]{3}$ was added for the status
  response-property-pattern-added
- ○
  the // response's property pattern was changed from ^[A-Z]{3}$ to ^[A-Za-z]{3}$ for the status
  response-property-pattern-changed
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 3, 20256637b341d86d1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 2, 2025919eb7a392aa1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 367 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history