Skip to main content
POST
/
fixed-assets
Create Fixed Asset
curl --request POST \
  --url https://api.clemta.com/fixed-assets \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "title": "Office Computer",
  "placed_in_service": 1640995200,
  "cost": 1500,
  "salvage_value": 150,
  "business_use": 100,
  "company_id": "64b8f1a2e4b0c8d9f0123456"
}
'
{
  "success": true,
  "message": "Fixed asset created successfully",
  "data": {
    "id": "64b8f1a2e4b0c8d9f0123456",
    "created_at": 1640995200,
    "updated_at": 1640995200,
    "title": "Office Computer",
    "placed_in_service": 1640995200,
    "cost": 1500,
    "salvage_value": 150,
    "business_use": 100,
    "fixed_asset_number": 1,
    "fixed_asset_number_text": "AST-1"
  }
}

​
Create Fixed Asset

This endpoint allows you to create a new fixed asset for a company in the accounting system.

​
Headers

ParameterTypeDescription
X-API-KEYstringFormation API Key (required)
Content-Typestringapplication/json

​
Request Body

{
  "title": "Office Computer",
  "placed_in_service": 1640995200,
  "cost": 1500.00,
  "salvage_value": 150.00,
  "business_use": 100.0,
  "company_id": "64b8f1a2e4b0c8d9f0123456"
}

​
Required Fields

FieldTypeDescription
titlestringTitle/name of the fixed asset
placed_in_serviceintegerTimestamp when the asset was placed in service
costnumberOriginal cost of the fixed asset
salvage_valuenumberEstimated salvage value of the asset
business_usenumberPercentage of business use (0-100)
company_idstringID of the company this fixed asset belongs to

​
Field Descriptions

  • title: A descriptive name for the asset (e.g., “Office Computer”, “Company Vehicle”, “Manufacturing Equipment”)
  • placed_in_service: Unix timestamp representing when the asset was put into use for business purposes
  • cost: The original purchase price or acquisition cost of the asset
  • salvage_value: The estimated residual value of the asset at the end of its useful life
  • business_use: Percentage representing how much the asset is used for business (100 = 100% business use)
  • company_id: The unique identifier of the company that owns this asset

​
Response

{
  "success": true,
  "message": "Fixed asset created successfully",
  "data": {
    "id": "64b8f1a2e4b0c8d9f0123456",
    "created_at": 1686787200,
    "updated_at": 1686787200,
    "title": "Office Computer",
    "placed_in_service": 1640995200,
    "cost": 1500.00,
    "salvage_value": 150.00,
    "business_use": 100.0,
    "fixed_asset_number": 1,
    "fixed_asset_number_text": "AST-1"
  }
}

​
Response Parameters

ParameterTypeDescription
successbooleanIndicates if the operation was successful
messagestringAdditional information about the operation
dataobjectResponse data for successful requests
data.idstringUnique identifier for the created asset
data.created_atintegerCreation timestamp
data.updated_atintegerLast update timestamp
data.titlestringTitle/name of the fixed asset
data.placed_in_serviceintegerTimestamp when placed in service
data.costnumberOriginal cost of the asset
data.salvage_valuenumberEstimated salvage value
data.business_usenumberPercentage of business use
data.fixed_asset_numberintegerAuto-generated asset number
data.fixed_asset_number_textstringFormatted asset number (e.g., “AST-1”)

​
Error Responses

​
Invalid Request (400)

{
  "success": false,
  "message": "Invalid request data",
  "error": {
    "code": "VALIDATION_FAILED",
    "details": "Field 'title' is required"
  }
}

​
Unauthorized (401)

{
  "success": false,
  "message": "API key is required",
  "error": {
    "code": "API_KEY_REQUIRED"
  }
}

​
Company Not Found (404)

{
  "success": false,
  "message": "Company not found",
  "error": {
    "code": "COMPANY_NOT_FOUND"
  }
}

​
Internal Server Error (500)

{
  "success": false,
  "message": "Internal server error",
  "error": {
    "code": "INTERNAL_ERROR"
  }
}

Authorizations

​
X-API-Key
string
header
required

Formation API key for authentication.

Body

application/json
​
title
string
required

Title/name of the fixed asset

Example:

"Office Computer"

​
placed_in_service
integer
required

Timestamp when the asset was placed in service

Example:

1640995200

​
cost
number
required

Original cost of the fixed asset

Example:

1500

​
salvage_value
number
required

Estimated salvage value of the asset

Example:

150

​
business_use
number
required

Percentage of business use (0-100)

Example:

100

​
company_id
string
required

Company ID

Example:

"64b8f1a2e4b0c8d9f0123456"

Response

Fixed asset created successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Fixed asset created successfully"

​
data
object
Example:
{
  "id": "64b8f1a2e4b0c8d9f0123456",
  "created_at": 1640995200,
  "updated_at": 1640995200,
  "title": "Office Computer",
  "placed_in_service": 1640995200,
  "cost": 1500,
  "salvage_value": 150,
  "business_use": 100,
  "fixed_asset_number": 1,
  "fixed_asset_number_text": "AST-1"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us