Create fixed asset

POST /api/v1/fixed-assets

Create a new fixed asset.

Request Body:

name: Asset name, 1-255 chars (required)
purchase_date: Purchase date in YYYY-MM-DD format (required)
original_cost: Original cost in cents, must be >= 0 (required)
description: Asset description (optional)
asset_number: Asset number, max 50 chars (optional)
serial_number: Serial number, max 100 chars (optional)
salvage_value: Salvage value in cents, must be >= 0 and < original_cost (optional, defaults to 0)
useful_life_months: Useful life in months, 1-600 (optional, defaults to 60)
depreciation_method: Depreciation method - straight_line, declining_balance, double_declining, units_of_production (optional, defaults to 'straight_line')
location: Asset location, max 255 chars (optional)
notes: Additional notes (optional)
category_id: Asset category UUID (optional)
vendor_id: Vendor UUID (optional)
in_service_date: Date asset was placed in service, YYYY-MM-DD format (optional)
total_expected_units: Total expected units for units_of_production method, must be >= 1 (optional)

Operation ID: create_fixed_asset_api_v1_fixed_assets_post · View as markdown · OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

Schema: FixedAssetCreate

name string required: Asset name
description string: Asset description
asset_number string: User-defined asset tracking number
serial_number string: Manufacturer serial number
purchase_date string · date required: Date the asset was purchased
original_cost integer required: Purchase cost in cents
salvage_value integer: Estimated salvage value in cents
useful_life_months integer: Expected useful life in months
depreciation_method DepreciationMethod DepreciationMethod: Depreciation calculation method
location string: Physical location of the asset
notes string: Additional notes
category_id string: Asset category ID
vendor_id string: Vendor the asset was purchased from
in_service_date string · date: Date the asset was placed in service (starts depreciation)
total_expected_units integer: Total expected units for units-of-production depreciation

Responses

201 Successful Response

Schema: FixedAssetResponse

name string required: Asset name
description string: Asset description
asset_number string: User-defined asset tracking number
serial_number string: Manufacturer serial number
purchase_date string · date required: Date the asset was purchased
original_cost integer required: Purchase cost in cents
salvage_value integer: Estimated salvage value in cents
useful_life_months integer: Expected useful life in months
depreciation_method DepreciationMethod DepreciationMethod: Depreciation calculation method
location string: Physical location of the asset
notes string: Additional notes
id string required: Asset ID
category_id string: Asset category ID
category_name string: Asset category name
vendor_id string: Vendor ID
in_service_date string · date: Date placed in service
total_expected_units integer: Total expected units (units-of-production method)
units_used_to_date integer: Cumulative units used to date
status AssetStatus requiredAssetStatus: Asset lifecycle status: draft, active, fully_depreciated, disposed
disposal_date string · date: Date the asset was disposed
disposal_amount integer: Sale/trade proceeds in cents
disposal_method DisposalMethod: How the asset was disposed
depreciable_amount integer required: Cost minus salvage value, in cents
accumulated_depreciation integer required: Total depreciation taken to date, in cents
book_value integer required: Current book value (cost - accumulated depreciation), in cents
monthly_depreciation_amount integer required: Monthly depreciation amount, in cents
remaining_life_months integer required: Remaining useful life in months
created_at string · date-time required: Record creation timestamp
updated_at string · date-time required: Last update timestamp

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError

5 fields

loc array · string | integer required
msg string required
type string required
input object
ctx object

Code samples

POST /api/v1/fixed-assets

bash

curl -X POST 'https://api.ondayzero.com/api/v1/fixed-assets' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "purchase_date": "2026-01-01",
  "original_cost": 0
}'

javascript

const response = await fetch('https://api.ondayzero.com/api/v1/fixed-assets', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer dz_your_token',
    'x-business-id': 'YOUR_BUSINESS_ID',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "name": "string",
  "purchase_date": "2026-01-01",
  "original_cost": 0
}),
});
const data = await response.json();

python

import httpx

headers = {
    "Authorization": "Bearer dz_your_token",
    "x-business-id": "YOUR_BUSINESS_ID",
}

payload = {
  "name": "string",
  "purchase_date": "2026-01-01",
  "original_cost": 0
}

response = httpx.post("https://api.ondayzero.com/api/v1/fixed-assets", headers=headers, json=payload)
data = response.json()