API Reference
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 /partners/reports/depreciation-schedule`, `/asset-register` and `/fixed-asset-reconciliation`.
The fixed asset object
Attributes
iduuidAsset UUID.
assetNumberstring`FA-0001` and up, unique in the workspace.
namestringAsset name.
descriptionstringNullable.
serialNumberstringNullable.
locationstringNullable.
statusenumLifecycle status. Only registered assets depreciate.
One of: draft, registered, disposed
statusLabelenumStatus 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
fixedAssetTypeIduuidType UUID. Null on a draft with no type.
fixedAssetTypeobjectThe type, with its three accounts and defaults.
purchaseDatedateDate of the earliest cost line, or as set.
purchasePricestringCost, as a decimal string.
depreciationStartDatedateNullable.
depreciationMethodenumNullable.
One of: no_depreciation, full_depreciation, straight_line, diminishing_value
averagingMethodenumNullable.
One of: full_month, actual_days, half_year
depreciationFrequencyenumNullable.
One of: monthly, annually
calculateBasisenumNullable.
One of: rate, effective_life
ratestringAnnual rate in percent. Nullable.
effectiveLifestringYears. Nullable.
insuranceValuestringNullable.
replacementValuestringNullable.
claimInvestmentBoostbooleanWhether the Investment Boost is claimed.
- US· Sales taxAlways false.
- NZ· GSTNew Zealand's 20% Investment Boost.
registeredAtdatetimeNullable.
disposalDatedateNullable.
disposalMethodenumNullable.
One of: write_off, sale
disposalPricestringSale price. Nullable.
journalLinksarrayThe journal lines that make up the cost, primary first.
iduuidJournal link UUID.
sourceTypeenumWhat posted the line.
One of: transaction, bill, manual_journal
transactionIduuidTransaction UUID, when a transaction posted the line.
billIduuidBill UUID, when a bill posted the line.
jeHeaderIduuidJournal entry UUID.
amountstringCost this line adds, before tax.
grossAmountstringLine amount including tax.
gstAmountstringTax on the line.
canUnlinkJournalEntrybooleanFalse on the primary line.
createdAtdatetimeISO 8601 creation timestamp.
updatedAtdatetimeISO 8601 last update timestamp.
{
"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.Related
Recent changes
Fixed assets
The asset register is on the Partner API and MCP. /partners/fixed-asset-types lists, gets, creates, updates and deletes asset types (each with its cost, accumulated depreciation and depreciation expense accounts and default depreciation settings). /partners/fixed-assets lists the register (status, type, search, sort, paging), gets one asset with its posted depreciation, updates and deletes drafts, merges two drafts (POST /merge-drafts) and projects depreciation (GET /{uuid}/projected-depreciation-schedule). POST /{uuid}/register, /unregister and /dispose run the lifecycle; a disposal posts its catch-up depreciation and journal together and refuses a sale missing the account its outcome needs. GET and POST /{uuid}/journal-links and DELETE /{uuid}/journal-links/{linkUuid} manage the journal lines behind an asset's cost, GET /{uuid}/audit-log returns its history, and /{uuid}/attachments lists, adds (multipart or URL) and deletes its files. GET /partners/fixed-asset-depreciation-rates returns the country's reference rates. POST /partners/reports/depreciation-schedule, /asset-register and /fixed-asset-reconciliation generate the fixed asset reports. Bill lines and transaction category changes accept `fixedAssetAssignment` with `fixedAssetUuid` / `fixedAssetTypeUuid`. These routes need the new `fixed-assets` scope (a bare `read` / `write` grant includes it; the reports need `reports:read`) plus View Fixed Assets to read and Administer Fixed Assets to change. The same routes work on client workspaces under /firm-partners/workspace. The MCP catalog adds 22 fixed asset tools and 3 report tools.
Endpoints
/partners/fixed-asset-typesLists the workspace's fixed asset types with their accounts and default depreciation settings.
/partners/fixed-asset-types/{uuid}Returns one fixed asset type.
/partners/fixed-asset-typesCreates an asset class with its three accounts and default depreciation settings.
/partners/fixed-asset-types/{uuid}Changes a type's name, accounts or defaults. Send only the fields to change.
/partners/fixed-asset-types/{uuid}Deletes a type no registered or disposed asset uses.
/partners/fixed-assetsLists the asset register, a page at a time.
/partners/fixed-assets/{uuid}Returns one asset with its type, journal links and every posted depreciation entry.
/partners/fixed-assets/{uuid}Changes an asset's details and depreciation settings. Send only the fields to change.
/partners/fixed-assets/{uuid}Deletes a draft asset. The journal lines it held stay in the ledger.
/partners/fixed-assets/merge-draftsCombines two drafts into one, such as a laptop bought across two bills.
/partners/fixed-assets/{uuid}/projected-depreciation-scheduleProjects a registered asset's depreciation period by period, including the periods already posted.
/partners/fixed-assets/{uuid}/registerRegisters a draft so it depreciates.
/partners/fixed-assets/{uuid}/unregisterReturns a registered asset to draft and deletes the depreciation journals COUNT posted for it.
/partners/fixed-assets/{uuid}/disposeWrites off or sells a registered asset and posts the disposal journal.
/partners/fixed-assets/{uuid}/journal-linksLists the journal lines that make up the asset's cost, primary line first.
/partners/fixed-assets/{uuid}/journal-linksAdds a posted fixed asset line that no asset holds yet to a draft's cost.
/partners/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.
/partners/fixed-assets/{uuid}/audit-logReturns the asset's history, newest first.
/partners/fixed-assets/{uuid}/attachmentsLists the files attached to an asset, each with a signed download link.
/partners/fixed-assets/{uuid}/attachmentsAttaches an invoice, photo or warranty, uploaded as multipart `file` or downloaded from a public URL.
/partners/fixed-assets/{uuid}/attachments/{attachmentUuid}Deletes a file from an asset. The stored file is removed.
/partners/fixed-asset-depreciation-ratesLists the reference depreciation rates for the workspace's country, such as the IRD rates in New Zealand.
