---
title: "Split a transaction · Transactions · Practice Manager API · COUNT Partner API"
description: "Splits a transaction into a parent row and child rows before bill or invoice assignment. PUT /firm-partners/workspace/transactions/{uuid}/split"
canonical: "https://developers.getcount.com/practice-manager/reference/transactions/split-transaction"
source: "https://developers.getcount.com/practice-manager/reference/transactions/split-transaction"
---
[Transactions](https://developers.getcount.com/practice-manager/reference/transactions) / Split a transaction

# Split a transaction

PUT `/firm-partners/workspace/transactions/{uuid}/split`

Splits a transaction into a parent row and child rows before bill or invoice assignment.

HMAC signature only

[Chart of Accounts API](https://developers.getcount.com/practice-manager/reference/chart-of-accounts) [Bills API](https://developers.getcount.com/practice-manager/reference/bills) [Invoices API](https://developers.getcount.com/practice-manager/reference/invoices)

#### Headers

`count-workspace-id` uuid required

UUID of the client workspace to act on. It must be one of your firm's client workspaces (or the firm's own workspace) and within the API key's client workspaces.

#### Path parameters

`uuid` uuid required

The UUID of the transaction to split.

#### Request body

`forAttachment` boolean

When true, matches the COUNT bill/invoice attachment split flow.

`splitASplit` boolean

When true, further splits an existing split child row.

`withCaution` boolean

Required to split reconciled transactions.

`parent` object

Parent split row. Use categoryAccountUuid from chart of accounts.

`categoryAccountUuid` uuid

Category account UUID for the parent portion.

`amount` number

Signed amount for the parent portion.

`assignThis` boolean

When true, this row is the one to assign to the bill or invoice.

`splits` array

Child split rows.

`categoryAccountUuid` uuid required

Category account UUID for the child portion.

`amount` number required

Signed amount for the child portion.

#### Responses

`200` Transaction split. Returns parent and transactionToAssign rows with UUID ids.

`400` Bad request — transfer/deposit splits, reviewed/pending guards, or invalid amounts.

`401` Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`403` The key is inactive or its scope does not allow this request, the workspace is not managed by your firm or is outside the key's client workspaces, the workspace has no active subscription, or it is portal-only and the route needs bookkeeping. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`404` Transaction or category account not found.

`429` Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

[Previous POST Assign to bills or invoices](https://developers.getcount.com/practice-manager/reference/transactions/assign-transaction-to-bills-invoices) [Next DELETE Delete a transaction](https://developers.getcount.com/practice-manager/reference/transactions/delete-transaction)

PUT `https://api.getcount.com/firm-partners/workspace/transactions/{uuid}/split`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;

const method = 'PUT';
const signingPath = '/workspace/transactions/3fa85f64-5717-4562-b3fc-2c963f66afa6/split';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "forAttachment": true,
  "parent": {
    "categoryAccountUuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "amount": -100,
    "assignThis": true
  },
  "splits": [
    {
      "categoryAccountUuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "amount": -50
    }
  ]
};
const bodyString = JSON.stringify(body);

const bodyHash = crypto.createHash('sha256').update(bodyString).digest('hex');
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/firm-partners/workspace/transactions/3fa85f64-5717-4562-b3fc-2c963f66afa6/split`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    'Content-Type': 'application/json',
    'count-workspace-id': '5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716',
  },
  body: bodyString,
});

console.log(await response.json());
```

Response · 200

```json
{
  "parent": {
    "id": "b7c8d9e0-f1a2-3456-bcde-678901234567",
    "type": "EXPENSE",
    "description": "Office supplies from Amazon",
    "amount": -150,
    "currency": "USD",
    "postedDate": "2026-03-01",
    "authorizedDate": "2026-03-01",
    "notes": "Q1 office supplies",
    "paymentChannel": "online",
    "reviewed": false,
    "excluded": false,
    "pending": false,
    "split": false,
    "accountId": "c8d9e0f1-a2b3-4567-cdef-789012345678",
    "categoryAccountId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "vendorId": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "customerId": null,
    "billId": null,
    "invoiceId": null,
    "tags": [
      {
        "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
        "name": "Office"
      }
    ],
    "createdAt": "2026-03-13T08:30:00.000Z",
    "updatedAt": "2026-03-13T08:30:00.000Z"
  },
  "transactionToAssign": {
    "id": "b7c8d9e0-f1a2-3456-bcde-678901234567",
    "type": "EXPENSE",
    "description": "Office supplies from Amazon",
    "amount": -150,
    "currency": "USD",
    "postedDate": "2026-03-01",
    "authorizedDate": "2026-03-01",
    "notes": "Q1 office supplies",
    "paymentChannel": "online",
    "reviewed": false,
    "excluded": false,
    "pending": false,
    "split": false,
    "accountId": "c8d9e0f1-a2b3-4567-cdef-789012345678",
    "categoryAccountId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "vendorId": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "customerId": null,
    "billId": null,
    "invoiceId": null,
    "tags": [
      {
        "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
        "name": "Office"
      }
    ],
    "createdAt": "2026-03-13T08:30:00.000Z",
    "updatedAt": "2026-03-13T08:30:00.000Z"
  }
}
```
