Search

client.transactions.search(, ?): TransactionSearchResponse { data }

POST/transactions/search

Searches transactions by filter criteria

ParametersExpand Collapse

body: TransactionSearchParams { filter }

filter: Filter

Filter criteria for searching transactions.

account: Account { any }

any: Array<Any>

Match transactions belonging to any of these accounts (OR).

id?: string

User-facing encoded account ID.

minLength1

external_id?: string

External account reference ID.

minLength1

ReturnsExpand Collapse

TransactionSearchResponse { data }

Search results for transactions.

data: Array<Transaction { id, account, allocations, 9 more } >

id: string

User-facing encoded transaction ID.

account: Account { id, external_id }

External account reference on transaction responses.

id: string

User-facing encoded account ID.

external_id: string

External account reference ID.

allocations: Array<Allocation>

amount: string

Allocated amount in smallest currency unit as stringified bigint.

invoice_id: string

The invoice this allocation is applied against.

type: "invoice_payin" | "invoice_payout"

The type of allocation.

Accepts one of the following:

"invoice_payin"

"invoice_payout"

user: User { id, external_id }

User reference in API responses: Fragment user id and external_id.

id: string

FRAGMENT generated ID of the user

external_id: string

External ID of the user

amount: string

Amount in smallest currency unit as stringified bigint (can be positive or negative).

created: string

Creation timestamp.

formatdate-time

currency: "ADA" | "BTC" | "DAI" | 176 more

Currency code (ISO 4217 or crypto)

Accepts one of the following:

"ADA"

"BTC"

"DAI"

"ETH"

"SOL"

"USDC"

"USDT"

"USDG"

"EURC"

"CADC"

"CADT"

"XLM"

"UNI"

"BCH"

"LTC"

"AAVE"

"LINK"

"MATIC"

"PTS"

"AED"

"AFN"

"ALL"

"AMD"

"ANG"

"AOA"

"ARS"

"AUD"

"AWG"

"AZN"

"BAM"

"BBD"

"BDT"

"BGN"

"BHD"

"BIF"

"BMD"

"BND"

"BOB"

"BRL"

"BSD"

"BTN"

"BWP"

"BYR"

"BZD"

"CAD"

"CDF"

"CHF"

"CLP"

"CNY"

"COP"

"CRC"

"CUC"

"CUP"

"CVE"

"CZK"

"DJF"

"DKK"

"DOP"

"DZD"

"EGP"

"ERN"

"ETB"

"EUR"

"FJD"

"FKP"

"GBP"

"GEL"

"GGP"

"GHS"

"GIP"

"GMD"

"GNF"

"GTQ"

"GYD"

"HKD"

"HNL"

"HRK"

"HTG"

"HUF"

"IDR"

"ILS"

"IMP"

"INR"

"IQD"

"IRR"

"ISK"

"JMD"

"JOD"

"JPY"

"KES"

"KGS"

"KHR"

"KMF"

"KPW"

"KRW"

"KWD"

"KYD"

"KZT"

"LAK"

"LBP"

"LKR"

"LRD"

"LSL"

"LYD"

"MAD"

"MDL"

"MGA"

"MKD"

"MMK"

"MNT"

"MOP"

"MUR"

"MVR"

"MWK"

"MXN"

"MYR"

"MZN"

"NAD"

"NGN"

"NIO"

"NOK"

"NPR"

"NZD"

"OMR"

"PAB"

"PEN"

"PGK"

"PHP"

"PKR"

"PLN"

"PYG"

"QAR"

"RON"

"RSD"

"RUB"

"RWF"

"SAR"

"SBD"

"SCR"

"SDG"

"SEK"

"SGD"

"SHP"

"SLL"

"SOS"

"SPL"

"SRD"

"SVC"

"SYP"

"STN"

"SZL"

"THB"

"TJS"

"TMT"

"TND"

"TOP"

"TRY"

"TTD"

"TVD"

"TWD"

"TZS"

"UAH"

"UGX"

"USD"

"UYU"

"UZS"

"VEF"

"VND"

"VUV"

"WST"

"XAF"

"XCD"

"XOF"

"XPF"

"YER"

"ZAR"

"ZMW"

"LOGICAL"

"CUSTOM"

external_id: string

External idempotency key provided by the user.

posted: string

Posted timestamp in ISO 8601 format.

formatdate-time

tags: Array<Tag>

Metadata tags associated with this transaction.

key: string

Tag key

value: string

Tag value

unallocated_amount: string

Read-only amount not yet allocated.

version: number

Current version of the transaction, used for optimistic concurrency control.

modified?: string

Last modified timestamp.

formatdate-time

Search

import Fragment from '@fragment-dev/ts-node';

const client = new Fragment();

const response = await client.transactions.search({ filter: { account: { any: [{}] } } });

console.log(response.data);

{
  "data": [
    {
      "id": "txn_dHhuX2ZyYWdfMDAx",
      "account": {
        "id": "ext_account_YWJjMTIz",
        "external_id": "acct_external_123"
      },
      "allocations": [
        {
          "amount": "1000",
          "invoice_id": "inv_abc123",
          "type": "invoice_payin",
          "user": {
            "id": "user_abc123",
            "external_id": "user-ext-001"
          }
        }
      ],
      "amount": "-1000",
      "created": "2026-02-12T00:00:00.000Z",
      "currency": "USD",
      "external_id": "bank_txn_123",
      "posted": "2026-02-12T00:00:00.000Z",
      "tags": [
        {
          "key": "region",
          "value": "us-east"
        }
      ],
      "unallocated_amount": "-1000",
      "version": 1,
      "modified": "2026-02-12T01:00:00.000Z"
    }
  ]
}

Returns Examples

{
  "data": [
    {
      "id": "txn_dHhuX2ZyYWdfMDAx",
      "account": {
        "id": "ext_account_YWJjMTIz",
        "external_id": "acct_external_123"
      },
      "allocations": [
        {
          "amount": "1000",
          "invoice_id": "inv_abc123",
          "type": "invoice_payin",
          "user": {
            "id": "user_abc123",
            "external_id": "user-ext-001"
          }
        }
      ],
      "amount": "-1000",
      "created": "2026-02-12T00:00:00.000Z",
      "currency": "USD",
      "external_id": "bank_txn_123",
      "posted": "2026-02-12T00:00:00.000Z",
      "tags": [
        {
          "key": "region",
          "value": "us-east"
        }
      ],
      "unallocated_amount": "-1000",
      "version": 1,
      "modified": "2026-02-12T01:00:00.000Z"
    }
  ]
}