## Search Allocations

`client.transactions.searchAllocations(TransactionSearchAllocationsParamsbody, RequestOptionsoptions?): TransactionSearchAllocationsResponse`

**post** `/transactions/allocations/search`

Searches transaction allocations by filter criteria

### Parameters

- `body: TransactionSearchAllocationsParams`

  - `filter: Filter`

    Filter criteria for searching transaction allocations.

    - `invoice_id: InvoiceID`

      - `any: Array<string>`

        Match allocations where invoice_id is any of these values (OR).

### Returns

- `TransactionSearchAllocationsResponse`

  Search results for transaction allocations.

  - `data: Array<Data>`

    - `id: string`

      Allocation ID.

    - `amount: string`

      Allocated amount in smallest currency unit as stringified bigint.

    - `invoice_id: string`

      The invoice this allocation is applied against.

    - `posted: string`

      Posted timestamp of the parent transaction in ISO 8601 format.

    - `transaction: Transaction`

      Reference to a transaction by encoded ID and external ID.

      - `id: string`

        Encoded transaction ID.

      - `external_id: string`

        External transaction ID.

    - `type: "invoice_payin" | "invoice_payout"`

      The type of allocation.

      - `"invoice_payin"`

      - `"invoice_payout"`

    - `user: User`

      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

### Example

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

const client = new Fragment();

const response = await client.transactions.searchAllocations({
  filter: { invoice_id: { any: ['inv_abc123'] } },
});

console.log(response.data);
```