## Search Allocations

`transactions.search_allocations(TransactionSearchAllocationsParams**kwargs)  -> TransactionSearchAllocationsResponse`

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

Searches transaction allocations by filter criteria

### Parameters

- `filter: Filter`

  Filter criteria for searching transaction allocations.

  - `invoice_id: FilterInvoiceID`

    - `any: SequenceNotStr[str]`

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

### Returns

- `class TransactionSearchAllocationsResponse: …`

  Search results for transaction allocations.

  - `data: List[Data]`

    - `id: str`

      Allocation ID.

    - `amount: str`

      Allocated amount in smallest currency unit as stringified bigint.

    - `invoice_id: str`

      The invoice this allocation is applied against.

    - `posted: datetime`

      Posted timestamp of the parent transaction in ISO 8601 format.

    - `transaction: DataTransaction`

      Reference to a transaction by encoded ID and external ID.

      - `id: str`

        Encoded transaction ID.

      - `external_id: str`

        External transaction ID.

    - `type: Literal["invoice_payin", "invoice_payout"]`

      The type of allocation.

      - `"invoice_payin"`

      - `"invoice_payout"`

    - `user: DataUser`

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

      - `id: str`

        FRAGMENT generated ID of the user

      - `external_id: str`

        External ID of the user

### Example

```python
from fragment import Fragment

client = Fragment()
response = client.transactions.search_allocations(
    filter={
        "invoice_id": {
            "any": ["inv_abc123"]
        }
    },
)
print(response.data)
```