---
title: "Fixed Assets API · COUNT Partner API"
description: "The asset register: asset types, draft and registered assets, register, unregister and dispose, the journal lines behind each asset's cost, attachments, the…"
canonical: "https://developers.getcount.com/reference/fixed-assets"
source: "https://developers.getcount.com/reference/fixed-assets"
---
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

`id` uuid

Asset UUID.

`assetNumber` string

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

`name` string

Asset name.

`description` string

Nullable.

`serialNumber` string

Nullable.

`location` string

Nullable.

`status` enum

Lifecycle status. Only registered assets depreciate.

One of: `draft`, `registered`, `disposed`

`statusLabel` enum

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

One of: `draft`, `registered`, `fully_depreciated`, `disposed`

`origin` enum

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

One of: `derived`, `imported`

`costSource` enum

`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`

`fixedAssetTypeId` uuid

Type UUID. Null on a draft with no type.

`fixedAssetType` object

The type, with its three accounts and defaults.

`purchaseDate` date

Date of the earliest cost line, or as set.

`purchasePrice` string

Cost, as a decimal string.

`depreciationStartDate` date

Nullable.

`depreciationMethod` enum

Nullable.

One of: `no_depreciation`, `full_depreciation`, `straight_line`, `diminishing_value`

`averagingMethod` enum

Nullable.

One of: `full_month`, `actual_days`, `half_year`

`depreciationFrequency` enum

Nullable.

One of: `monthly`, `annually`

`calculateBasis` enum

Nullable.

One of: `rate`, `effective_life`

`rate` string

Annual rate in percent. Nullable.

`effectiveLife` string

Years. Nullable.

`insuranceValue` string

Nullable.

`replacementValue` string

Nullable.

`claimInvestmentBoost` boolean

Whether the Investment Boost is claimed.

- US· Sales tax Always false.
- NZ· GST New Zealand's 20% Investment Boost.

`registeredAt` datetime

Nullable.

`disposalDate` date

Nullable.

`disposalMethod` enum

Nullable.

One of: `write_off`, `sale`

`disposalPrice` string

Sale price. Nullable.

`journalLinks` array

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

`id` uuid

Journal link UUID.

`sourceType` enum

What posted the line.

One of: `transaction`, `bill`, `manual_journal`

`transactionId` uuid

Transaction UUID, when a transaction posted the line.

`billId` uuid

Bill UUID, when a bill posted the line.

`jeHeaderId` uuid

Journal entry UUID.

`amount` string

Cost this line adds, before tax.

`grossAmount` string

Line amount including tax.

`gstAmount` string

Tax on the line.

`canUnlinkJournalEntry` boolean

False on the primary line.

`createdAt` datetime

ISO 8601 creation timestamp.

`updatedAt` datetime

ISO 8601 last update timestamp.

Example

```json
{
  "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

- [Reports API](https://developers.getcount.com/reference/reports)
- [Bills API](https://developers.getcount.com/reference/bills)
- [Transactions API](https://developers.getcount.com/reference/transactions)
- [Chart of Accounts API](https://developers.getcount.com/reference/chart-of-accounts)

## Recent changes

2026-11-19

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

[GET List fixed asset types `/partners/fixed-asset-types` Lists the workspace's fixed asset types with their accounts and default depreciation settings.](https://developers.getcount.com/reference/fixed-assets/list-fixed-asset-types) [GET Get a fixed asset type `/partners/fixed-asset-types/{uuid}` Returns one fixed asset type.](https://developers.getcount.com/reference/fixed-assets/get-fixed-asset-type) [POST Create a fixed asset type `/partners/fixed-asset-types` Creates an asset class with its three accounts and default depreciation settings.](https://developers.getcount.com/reference/fixed-assets/create-fixed-asset-type) [PATCH Update a fixed asset type `/partners/fixed-asset-types/{uuid}` Changes a type's name, accounts or defaults. Send only the fields to change.](https://developers.getcount.com/reference/fixed-assets/update-fixed-asset-type) [DELETE Delete a fixed asset type `/partners/fixed-asset-types/{uuid}` Deletes a type no registered or disposed asset uses.](https://developers.getcount.com/reference/fixed-assets/delete-fixed-asset-type) [GET List fixed assets `/partners/fixed-assets` Lists the asset register, a page at a time.](https://developers.getcount.com/reference/fixed-assets/list-fixed-assets) [GET Get a fixed asset `/partners/fixed-assets/{uuid}` Returns one asset with its type, journal links and every posted depreciation entry.](https://developers.getcount.com/reference/fixed-assets/get-fixed-asset) [PATCH Update a fixed asset `/partners/fixed-assets/{uuid}` Changes an asset's details and depreciation settings. Send only the fields to change.](https://developers.getcount.com/reference/fixed-assets/update-fixed-asset) [DELETE Delete a fixed asset `/partners/fixed-assets/{uuid}` Deletes a draft asset. The journal lines it held stay in the ledger.](https://developers.getcount.com/reference/fixed-assets/delete-fixed-asset) [POST Merge two draft assets `/partners/fixed-assets/merge-drafts` Combines two drafts into one, such as a laptop bought across two bills.](https://developers.getcount.com/reference/fixed-assets/merge-fixed-asset-drafts) [GET Get projected depreciation `/partners/fixed-assets/{uuid}/projected-depreciation-schedule` Projects a registered asset's depreciation period by period, including the periods already posted.](https://developers.getcount.com/reference/fixed-assets/get-fixed-asset-projected-depreciation-schedule) [POST Register a fixed asset `/partners/fixed-assets/{uuid}/register` Registers a draft so it depreciates.](https://developers.getcount.com/reference/fixed-assets/register-fixed-asset) [POST Unregister a fixed asset `/partners/fixed-assets/{uuid}/unregister` Returns a registered asset to draft and deletes the depreciation journals COUNT posted for it.](https://developers.getcount.com/reference/fixed-assets/unregister-fixed-asset) [POST Dispose of a fixed asset `/partners/fixed-assets/{uuid}/dispose` Writes off or sells a registered asset and posts the disposal journal.](https://developers.getcount.com/reference/fixed-assets/dispose-fixed-asset) [GET List an asset's journal links `/partners/fixed-assets/{uuid}/journal-links` Lists the journal lines that make up the asset's cost, primary line first.](https://developers.getcount.com/reference/fixed-assets/list-fixed-asset-journal-links) [POST Link a journal line to an asset `/partners/fixed-assets/{uuid}/journal-links` Adds a posted fixed asset line that no asset holds yet to a draft's cost.](https://developers.getcount.com/reference/fixed-assets/link-fixed-asset-journal-line) [DELETE Unlink a journal line from an asset `/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.](https://developers.getcount.com/reference/fixed-assets/unlink-fixed-asset-journal-line) [GET Get an asset's audit log `/partners/fixed-assets/{uuid}/audit-log` Returns the asset's history, newest first.](https://developers.getcount.com/reference/fixed-assets/get-fixed-asset-audit-log) [GET List an asset's attachments `/partners/fixed-assets/{uuid}/attachments` Lists the files attached to an asset, each with a signed download link.](https://developers.getcount.com/reference/fixed-assets/list-fixed-asset-attachments) [POST Attach a file to an asset `/partners/fixed-assets/{uuid}/attachments` Attaches an invoice, photo or warranty, uploaded as multipart `file` or downloaded from a public URL.](https://developers.getcount.com/reference/fixed-assets/add-fixed-asset-attachment) [DELETE Delete an asset's attachment `/partners/fixed-assets/{uuid}/attachments/{attachmentUuid}` Deletes a file from an asset. The stored file is removed.](https://developers.getcount.com/reference/fixed-assets/delete-fixed-asset-attachment) [GET List depreciation rates `/partners/fixed-asset-depreciation-rates` Lists the reference depreciation rates for the workspace's country, such as the IRD rates in New Zealand.](https://developers.getcount.com/reference/fixed-assets/list-fixed-asset-depreciation-rates)
