# Search imported bank transactions

Read bank transactions with currency, date range or lookbackDays, accountId, query and credit/debit direction. Signed minor units: credits positive. Matched count and total cover all matching rows; transactions are capped at 500 and truncated is explicit. lastSyncedAt names the last complete import, not a guarantee the institution is current.

Access class: `def:read`.

## Endpoint

`POST /v1/definitions/{key}/rows/{rowId}/plaid/items/{itemId}/transactions/search`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| key | path | string | Yes |
| rowId | path | string | Yes |
| itemId | path | string | Yes |

## Request body

Content type: `application/json`.

```json
{
  "accountId": "",
  "currency": "string",
  "direction": "string",
  "from": "string",
  "includePending": true,
  "limit": 1.5,
  "lookbackDays": 1.5,
  "query": "string",
  "to": "string"
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "accounting": true,
    "connectionStatus": "string",
    "currency": "string",
    "from": "string",
    "hasNegativeBalance": true,
    "itemId": "",
    "lastSyncedAt": "2026-01-01T00:00:00Z",
    "matchedCount": 1,
    "negativeBalances": [
      {
        "availableBalanceMinor": "string",
        "currency": "string",
        "currentBalanceMinor": "string",
        "id": "",
        "mask": "string",
        "name": "string",
        "officialName": "string",
        "plaidAccountId": "",
        "subtype": "string",
        "type": "string"
      }
    ],
    "syncPending": true,
    "to": "string",
    "totalAmountMinor": 1,
    "transactions": [
      {
        "accountId": "",
        "amountMinor": "string",
        "category": "string",
        "counterparty": "string",
        "currency": "string",
        "description": "string",
        "id": "",
        "pending": "string",
        "postedOn": "string"
      }
    ],
    "truncated": true
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
