Assets API

Overview

The Assets API allows you to manage customer equipment records. Assets track equipment installed at customer sites, including service history, warranty information, and maintenance requirements.

Endpoints

List Assets

Retrieve a list of assets.

GET /api/v1/assets

Query Parameters:

Parameter	Type	Description
`page`	integer	Page number
`per_page`	integer	Results per page
`customer_id`	string	Filter by customer
`product_id`	string	Filter by product type
`status`	string	Filter by status
`serial_number`	string	Search by serial number
`location_id`	string	Filter by location

Example Request:

curl -X GET "https://api.fentu.io/v1/assets?customer_id=cust-001" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response:

{
  "data": [
    {
      "id": "asset-001",
      "name": "Rooftop Machine Unit #1",
      "serial_number": "MACH-2023-001234",
      "product": {
        "id": "prod-001",
        "name": "Commercial Machine 10-Ton"
      },
      "customer": {
        "id": "cust-001",
        "name": "Acme Corporation"
      },
      "location": "Building A - Roof",
      "status": "active",
      "warranty_expiry": "2026-06-15",
      "last_service": "2024-01-15T10:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 3,
    "total_count": 52
  }
}

Get Asset

Retrieve a single asset with full details.

GET /api/v1/assets/{id}

Example Response:

{
  "data": {
    "id": "asset-001",
    "name": "Rooftop Machine Unit #1",
    "asset_tag": "A-10001",
    "serial_number": "MACH-2023-001234",
    "model_number": "RMACH-10T-2023",
    "product": {
      "id": "prod-001",
      "name": "Commercial Machine 10-Ton",
      "manufacturer": "CoolAir Inc"
    },
    "customer": {
      "id": "cust-001",
      "name": "Acme Corporation"
    },
    "object": {
      "id": "obj-001",
      "name": "Building A",
      "address": "123 Main Street"
    },
    "location": "Roof - Northwest Corner",
    "status": "active",
    "install_date": "2023-06-15",
    "warranty_start": "2023-06-15",
    "warranty_expiry": "2026-06-15",
    "warranty_type": "standard",
    "service_contract": {
      "id": "contract-001",
      "name": "Annual Maintenance"
    },
    "specifications": {
      "capacity": "10 tons",
      "voltage": "480V",
      "refrigerant": "R-410A"
    },
    "service_history": [
      {
        "work_order_id": "wo-123",
        "date": "2024-01-15T10:00:00Z",
        "type": "maintenance",
        "description": "Quarterly maintenance"
      }
    ],
    "custom_fields": {
      "floor": "Roof",
      "zone": "A1"
    },
    "notes": "Access via northwest stairwell",
    "created_at": "2023-06-15T14:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Create Asset

Create a new asset record.

POST /api/v1/assets

Request Body:

{
  "name": "New Machine Unit",
  "customer_id": "cust-001",
  "object_id": "obj-001",
  "product_id": "prod-001",
  "serial_number": "MACH-2024-005678",
  "model_number": "RMACH-5T-2024",
  "location": "Building B - Roof",
  "install_date": "2024-01-27",
  "warranty_start": "2024-01-27",
  "warranty_expiry": "2027-01-27",
  "specifications": {
    "capacity": "5 tons",
    "voltage": "208V"
  },
  "notes": "Installed during expansion project"
}

Update Asset

Update an existing asset.

PUT /api/v1/assets/{id}

Request Body:

{
  "location": "Building B - Roof (relocated)",
  "notes": "Moved during renovation",
  "warranty_expiry": "2028-01-27"
}

Delete Asset

Delete an asset (moves to trash).

DELETE /api/v1/assets/{id}

Asset Service History

Get Service History

GET /api/v1/assets/{id}/service-history

Returns all work orders and service records for the asset. Example Response:

{
  "data": [
    {
      "work_order_id": "wo-123",
      "work_order_number": "WO-2024-001",
      "date": "2024-01-15T10:00:00Z",
      "type": "maintenance",
      "status": "completed",
      "technician": "Jane Doe",
      "description": "Quarterly maintenance",
      "parts_used": [
        {
          "part": "Air Filter",
          "quantity": 2
        }
      ],
      "notes": "All readings normal"
    }
  ]
}

Asset Parts

List Asset Parts

GET /api/v1/assets/{id}/parts

Returns parts associated with the asset.

Add Part to Asset

POST /api/v1/assets/{id}/parts

Request Body:

{
  "part_id": "part-001",
  "serial_number": "COMP-12345",
  "install_date": "2024-01-27",
  "warranty_expiry": "2025-01-27"
}

Asset Statuses

Status	Description
`active`	In operation
`inactive`	Not currently in use
`under_repair`	Being serviced
`retired`	No longer in service
`pending_install`	Not yet installed

Warranty Information

Check Warranty Status

GET /api/v1/assets/{id}/warranty

Example Response:

{
  "data": {
    "asset_id": "asset-001",
    "warranty_type": "standard",
    "warranty_start": "2023-06-15",
    "warranty_expiry": "2026-06-15",
    "is_active": true,
    "days_remaining": 870,
    "coverage": {
      "parts": true,
      "labor": true,
      "extended_hours": false
    }
  }
}

Error Responses

Code	Description
`400`	Bad request
`401`	Unauthorized
`403`	Forbidden
`404`	Asset not found
`409`	Duplicate serial number
`422`	Validation error

Customers API

Customer endpoints

Work Orders API

Work order endpoints

Assets

Asset user guide

Products

Product management

Getting Started

SERVICE APPS

WORK ORDER & JOBS

CUSTOMER MANAGEMENT

SERVICE MANAGEMENT

Products & Inventory

WORKFORCE

ADMINISTRATION

API REFERENCE

Overview

Endpoints

List Assets

Get Asset

Create Asset

Update Asset

Delete Asset

Asset Service History

Get Service History

Asset Parts

List Asset Parts

Add Part to Asset

Asset Statuses

Warranty Information

Check Warranty Status

Error Responses

Customers API

Work Orders API

Assets

Products

​Overview

​Endpoints

​List Assets

​Get Asset

​Create Asset

​Update Asset

​Delete Asset

​Asset Service History

​Get Service History

​Asset Parts

​List Asset Parts

​Add Part to Asset

​Asset Statuses

​Warranty Information

​Check Warranty Status

​Error Responses

​Related Documentation

Customers API

Work Orders API

Assets

Products

Overview

Endpoints

List Assets

Get Asset

Create Asset

Update Asset

Delete Asset

Asset Service History

Get Service History

Asset Parts

List Asset Parts

Add Part to Asset

Asset Statuses

Warranty Information

Check Warranty Status

Error Responses

Related Documentation