v38

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-192793126.4 KB
Transactions

Searches transactions.

post/transactions/search

Request body

Example request

{
  "filter": {
    "account": {
      "any": [
        {
          "id": "ext_account_YWJjMTIz",
          "external_id": "acct_external_123"
        }
      ]
    },
    "tags": {
      "any": [
        {
          "key": "department",
          "value": "eng*"
        }
      ],
      "all": [
        {
          "key": "department",
          "value": "engineering"
        }
      ]
    },
    "reconciliation_status": "unreconciled"
  },
  "page_info": {
    "limit": 20
  }
}

Response

Success

Example response

{
  "data": [
    {
      "id": "txn_dHhuX2ZyYWdfMDAx",
      "external_id": "bank_txn_123",
      "account": {
        "id": "ext_account_YWJjMTIz",
        "external_id": "acct_external_123"
      },
      "posted": "2024-01-13T00:00:00Z",
      "currency": "USD",
      "amount": "-1000",
      "allocations": [
        {
          "invoice_id": "inv_abc123",
          "amount": "1000",
          "type": "invoice_payin",
          "user": {
            "id": "user_abc123",
            "external_id": "user_ext_001"
          }
        }
      ],
      "tags": [
        {
          "key": "department",
          "value": "engineering"
        }
      ],
      "unallocated_amount": "-1000",
      "created": "2024-01-13T00:00:00Z",
      "modified": "2024-01-13T00:00:00Z",
      "version": 1
    }
  ],
  "data_v2": {
    "transactions": [
      {
        "id": "txn_dHhuX2ZyYWdfMDAx",
        "external_id": "bank_txn_123",
        "account": {
          "id": "ext_account_YWJjMTIz",
          "external_id": "acct_external_123"
        },
        "posted": "2024-01-13T00:00:00Z",
        "currency": "USD",
        "amount": "-1000",
        "allocations": [
          {
            "invoice_id": "inv_abc123",
            "amount": "1000",
            "type": "invoice_payin",
            "user": {
              "id": "user_abc123",
              "external_id": "user_ext_001"
            }
          }
        ],
        "tags": [
          {
            "key": "department",
            "value": "engineering"
          }
        ],
        "unallocated_amount": "-1000",
        "created": "2024-01-13T00:00:00Z",
        "modified": "2024-01-13T00:00:00Z",
        "version": 1
      }
    ]
  }
}