Practice Manager API

Fixed Assets

The asset register: asset types, draft and registered assets, register, unregister and dispose, the journal lines behind each asset's cost, attachments, the audit log and reference depreciation rates.

Last updated 2026-11-19

Some fields work differently in US and NZ workspaces

Showing US sales tax and NZ GST rules.

Overview

Assets are not created by hand. When a transaction, bill or journal entry posts to a Fixed Assets account, COUNT creates a draft asset for that line. Give the draft a type and depreciation settings, then register it: depreciation for past periods posts straight away and later periods post each day. Retire an asset by disposing of it.

Every record is named by UUID, in requests and responses. A field that names another record carries that record's UUID under the same name (`fixedAssetTypeId`, `jeHeaderId`, a journal link's `transactionId` or `billId`); internal ids with no external counterpart are left out.

Key concepts

Drafts come from the ledger

Each posted line on a Fixed Assets account becomes its own draft. One asset bought across two lines (two bills, or a bill and a freight charge) is two drafts: merge them before registering. Link a journal line only for a line no asset holds yet.

Register, unregister, dispose

Registering needs a type, depreciation settings and at least one journal line. A registered asset locks its type, purchase date, cost and depreciation start date. Unregistering returns it to draft and deletes the depreciation journals COUNT posted. Disposing posts the disposal journal; it cannot be undone through the API.

Types and their accounts

A type holds three accounts: the cost account (Fixed Assets sub-type), accumulated depreciation and depreciation expense. A draft can only take a type whose cost account is the account its cost posted to.

Assign a line while you categorize it

A bill line or a transaction category change on a Fixed Assets account can name its asset with `fixedAssetAssignment`: `{ "action": "assign_existing", "fixedAssetUuid": "…" }` puts the line on an existing draft, `{ "action": "create_new", "fixedAssetTypeUuid": "…", "assetName": "…" }` starts a new draft of that type. On a bill it applies when the bill is approved. Numeric `fixedAssetId` / `fixedAssetTypeId` are refused.

Reports

The depreciation schedule, asset register and fixed asset reconciliation are on the Reports API: `POST /firm-partners/workspace/reports/depreciation-schedule`, `/asset-register` and `/fixed-asset-reconciliation`.

The fixed asset object

Attributes

iduuid

Asset UUID.

assetNumberstring

`FA-0001` and up, unique in the workspace.

namestring

Asset name.

descriptionstring

Nullable.

serialNumberstring

Nullable.

locationstring

Nullable.

statusenum

Lifecycle status. Only registered assets depreciate.

One of: draft, registered, disposed

statusLabelenum

Status for display: a registered asset with no book value left is `fully_depreciated`.

One of: draft, registered, fully_depreciated, disposed

originenum

`imported` assets came from a conversion balance or asset import, not a posted line.

One of: derived, imported

costSourceenum

`linked_journals`: the cost is the sum of the journal links. `imported`: the cost was stated by the import and linking never changes it.

One of: linked_journals, imported

fixedAssetTypeIduuid

Type UUID. Null on a draft with no type.

fixedAssetTypeobject

The type, with its three accounts and defaults.

purchaseDatedate

Date of the earliest cost line, or as set.

purchasePricestring

Cost, as a decimal string.

depreciationStartDatedate

Nullable.

depreciationMethodenum

Nullable.

One of: no_depreciation, full_depreciation, straight_line, diminishing_value

averagingMethodenum

Nullable.

One of: full_month, actual_days, half_year

depreciationFrequencyenum

Nullable.

One of: monthly, annually

calculateBasisenum

Nullable.

One of: rate, effective_life

ratestring

Annual rate in percent. Nullable.

effectiveLifestring

Years. Nullable.

insuranceValuestring

Nullable.

replacementValuestring

Nullable.

claimInvestmentBoostboolean

Whether the Investment Boost is claimed.

  • US· Sales taxAlways false.
  • NZ· GSTNew Zealand's 20% Investment Boost.
registeredAtdatetime

Nullable.

disposalDatedate

Nullable.

disposalMethodenum

Nullable.

One of: write_off, sale

disposalPricestring

Sale price. Nullable.

journalLinksarray

The journal lines that make up the cost, primary first.

iduuid

Journal link UUID.

sourceTypeenum

What posted the line.

One of: transaction, bill, manual_journal

transactionIduuid

Transaction UUID, when a transaction posted the line.

billIduuid

Bill UUID, when a bill posted the line.

jeHeaderIduuid

Journal entry UUID.

amountstring

Cost this line adds, before tax.

grossAmountstring

Line amount including tax.

gstAmountstring

Tax on the line.

canUnlinkJournalEntryboolean

False on the primary line.

createdAtdatetime

ISO 8601 creation timestamp.

updatedAtdatetime

ISO 8601 last update timestamp.

Example
{
  "id": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1a01",
  "assetNumber": "FA-0007",
  "name": "MacBook Pro 16\"",
  "description": "Design team laptop",
  "serialNumber": "C02XK1ABCD12",
  "location": "Head office",
  "status": "registered",
  "statusLabel": "registered",
  "origin": "derived",
  "costSource": "linked_journals",
  "fixedAssetTypeId": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1d01",
  "fixedAssetType": {
    "id": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1d01",
    "name": "Computer Equipment",
    "assetAccount": {
      "id": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1c01",
      "name": "Computer Equipment"
    },
    "accumulatedDepreciationAccount": {
      "id": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1c02",
      "name": "Accumulated Depreciation - Computer Equipment"
    },
    "depreciationExpenseAccount": {
      "id": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1c03",
      "name": "Depreciation"
    },
    "defaultDepreciationMethod": "diminishing_value",
    "defaultAveragingMethod": "full_month",
    "defaultDepreciationFrequency": "monthly",
    "defaultCalculateBasis": "rate",
    "defaultRate": "50.0000",
    "defaultEffectiveLife": null,
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-01-28T14:22:30.000Z"
  },
  "purchaseDate": "2026-07-14",
  "purchasePrice": "3200.0000",
  "depreciationStartDate": "2026-07-14",
  "depreciationMethod": "diminishing_value",
  "averagingMethod": "full_month",
  "depreciationFrequency": "monthly",
  "calculateBasis": "rate",
  "rate": "50.0000",
  "effectiveLife": null,
  "insuranceValue": null,
  "replacementValue": null,
  "claimInvestmentBoost": false,
  "registeredAt": "2026-07-20T02:15:00.000Z",
  "disposalDate": null,
  "disposalMethod": null,
  "disposalPrice": null,
  "journalLinks": [
    {
      "id": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1e01",
      "sourceType": "bill",
      "billId": "0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a01",
      "transactionId": null,
      "jeHeaderId": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1f01",
      "amount": "3200.0000",
      "grossAmount": "3680.0000",
      "gstAmount": "480.0000",
      "description": "MacBook Pro 16\"",
      "isPrimaryJournalLink": true,
      "canUnlinkJournalEntry": false
    }
  ],
  "createdByUser": {
    "firstName": "Ana",
    "lastName": "Reyes"
  },
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-28T14:22:30.000Z"
}

Scope and permissions

Needs the `fixed-assets` scope: `fixed-assets:read` to read, `fixed-assets:write` to change anything. A bare `read` / `write` grant includes it. The connecting user needs View Fixed Assets to read and Administer Fixed Assets to make changes. The three fixed asset reports need `reports:read` and View Fixed Assets.

No confirmation step

Delete, unregister and dispose run as soon as they are called. COUNT's hosted MCP connector asks the user to confirm on clients that support forms; the API and the standalone connector do not, so confirm with your user before calling them.

MCP equivalent

COUNT_list_fixed_asset_types, COUNT_get_fixed_asset_type, COUNT_create_fixed_asset_type, COUNT_update_fixed_asset_type, COUNT_delete_fixed_asset_type, COUNT_list_fixed_assets, COUNT_get_fixed_asset, COUNT_update_fixed_asset, COUNT_delete_fixed_asset, COUNT_merge_fixed_asset_drafts, COUNT_get_fixed_asset_projected_depreciation, COUNT_register_fixed_asset, COUNT_unregister_fixed_asset, COUNT_dispose_fixed_asset, COUNT_list_fixed_asset_journal_links, COUNT_link_fixed_asset_journal_line, COUNT_unlink_fixed_asset_journal_line, COUNT_get_fixed_asset_audit_log, COUNT_list_fixed_asset_attachments, COUNT_add_fixed_asset_attachment (URL only), COUNT_delete_fixed_asset_attachment and COUNT_list_fixed_asset_depreciation_rates.

Endpoints

GET
List fixed asset types/firm-partners/workspace/fixed-asset-types

Lists the workspace's fixed asset types with their accounts and default depreciation settings.

GET
Get a fixed asset type/firm-partners/workspace/fixed-asset-types/{uuid}

Returns one fixed asset type.

POST
Create a fixed asset type/firm-partners/workspace/fixed-asset-types

Creates an asset class with its three accounts and default depreciation settings.

PATCH
Update a fixed asset type/firm-partners/workspace/fixed-asset-types/{uuid}

Changes a type's name, accounts or defaults. Send only the fields to change.

DELETE
Delete a fixed asset type/firm-partners/workspace/fixed-asset-types/{uuid}

Deletes a type no registered or disposed asset uses.

GET
List fixed assets/firm-partners/workspace/fixed-assets

Lists the asset register, a page at a time.

GET
Get a fixed asset/firm-partners/workspace/fixed-assets/{uuid}

Returns one asset with its type, journal links and every posted depreciation entry.

PATCH
Update a fixed asset/firm-partners/workspace/fixed-assets/{uuid}

Changes an asset's details and depreciation settings. Send only the fields to change.

DELETE
Delete a fixed asset/firm-partners/workspace/fixed-assets/{uuid}

Deletes a draft asset. The journal lines it held stay in the ledger.

POST
Merge two draft assets/firm-partners/workspace/fixed-assets/merge-drafts

Combines two drafts into one, such as a laptop bought across two bills.

GET
Get projected depreciation/firm-partners/workspace/fixed-assets/{uuid}/projected-depreciation-schedule

Projects a registered asset's depreciation period by period, including the periods already posted.

POST
Register a fixed asset/firm-partners/workspace/fixed-assets/{uuid}/register

Registers a draft so it depreciates.

POST
Unregister a fixed asset/firm-partners/workspace/fixed-assets/{uuid}/unregister

Returns a registered asset to draft and deletes the depreciation journals COUNT posted for it.

POST
Dispose of a fixed asset/firm-partners/workspace/fixed-assets/{uuid}/dispose

Writes off or sells a registered asset and posts the disposal journal.

GET
List an asset's journal links/firm-partners/workspace/fixed-assets/{uuid}/journal-links

Lists the journal lines that make up the asset's cost, primary line first.

POST
Link a journal line to an asset/firm-partners/workspace/fixed-assets/{uuid}/journal-links

Adds a posted fixed asset line that no asset holds yet to a draft's cost.

DELETE
Unlink a journal line from an asset/firm-partners/workspace/fixed-assets/{uuid}/journal-links/{linkUuid}

Removes a line from a draft's cost. The line goes back to the draft it was merged from, or becomes its own draft.

GET
Get an asset's audit log/firm-partners/workspace/fixed-assets/{uuid}/audit-log

Returns the asset's history, newest first.

GET
List an asset's attachments/firm-partners/workspace/fixed-assets/{uuid}/attachments

Lists the files attached to an asset, each with a signed download link.

POST
Attach a file to an asset/firm-partners/workspace/fixed-assets/{uuid}/attachments

Attaches an invoice, photo or warranty, uploaded as multipart `file` or downloaded from a public URL.

DELETE
Delete an asset's attachment/firm-partners/workspace/fixed-assets/{uuid}/attachments/{attachmentUuid}

Deletes a file from an asset. The stored file is removed.

GET
List depreciation rates/firm-partners/workspace/fixed-asset-depreciation-rates

Lists the reference depreciation rates for the workspace's country, such as the IRD rates in New Zealand.