v1

latestOpenAPI 3.1.0AGPL-3.0 license2026-07-1210336283.6 KB
Transactions

Bulk update transactions

Bulk update transactions for the authenticated team. If there's no change, returns it as it is.

patch/transactions/bulk

Request body

idsstring[] required

Array of transaction IDs to update.

categorySlugstring nullable

Category slug for the transactions.

status'pending' | 'archived' | 'completed' | 'posted' | 'excluded' | 'exported' | 'null' nullable

Status to set for the transactions.

frequency'weekly' | 'monthly' | 'annually' | 'irregular' | 'null' nullable

Recurring frequency to set for the transactions.

internalboolean

Whether the transactions are internal.

notestring nullable

Note to set for the transactions.

assignedIdstring nullable

Assigned user ID for the transactions.

recurringboolean

Whether the transactions are recurring.

tagIdstring nullable

Tag ID to set for the transactions.

Response

Transactions updated

Example response

{
  "meta": {
    "cursor": "eyJpZCI6IjQ1NiJ9",
    "hasNextPage": true
  },
  "data": [
    {
      "id": "b3b7c8e2-1f2a-4c3d-9e4f-5a6b7c8d9e0f",
      "name": "Office Supplies Purchase",
      "amount": 150.75,
      "taxAmount": 15.07,
      "taxRate": 10,
      "taxType": "VAT",
      "currency": "USD",
      "counterpartyName": "Spotify AB",
      "date": "2024-05-01T12:00:00.000Z",
      "category": {
        "id": "office-supplies",
        "name": "Office Supplies",
        "color": "#FF5733",
        "slug": "office-supplies",
        "taxRate": 10,
        "taxType": "VAT"
      },
      "status": "completed",
      "frequency": "monthly",
      "isFulfilled": true,
      "note": "Paid with company credit card for office renovation",
      "account": {
        "id": "a43dc3a5-6925-4d91-ac9c-4c1a34bdb388",
        "name": "Company Credit Card",
        "currency": "USD",
        "connection": {
          "id": "a43dc3a5-6925-4d91-ac9c-4c1a34bdb388",
          "name": "Chase Bank",
          "logoUrl": "https://cdn.midday.ai/logos/chase-bank.png"
        }
      },
      "tags": [
        {
          "id": "b7e2f8c1-3d4a-4e2b-9f1a-2c3d4e5f6a7b",
          "name": "invoice"
        },
        {
          "id": "c8e2f8c1-3d4a-4e2b-9f1a-2c3d4e5f6a7c",
          "name": "travel"
        }
      ],
      "attachments": [
        {
          "id": "b7e2f8c1-3d4a-4e2b-9f1a-2c3d4e5f6a7b",
          "path": [
            "e1f2d3c4-b5a6-7d8e-9f0a-1b2c3d4e5f6a",
            "transactions",
            "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
            "receipt.pdf"
          ],
          "size": 1928716,
          "type": "application/pdf",
          "filename": "receipt.pdf"
        }
      ]
    }
  ]
}