Asset APIs

An Asset refers to a product instance that has been sold. 

List Assets

Purpose

To fetch the list of all available assets. The records fetched will be sorted by Created Time in descending order (recent ones first).

Request URL

https://fsm.zoho.com/fsm/v1/Assets

Request Method

GET

Scope

scope=ZohoFSM.modules.Assets.READ

Query Parameters

Parameter NameData TypeDescriptionPossible Values
page (optional)IntegerThe page from which you want to fetch the records. The default value is 1.Positive Integer values only
per_page (optional)IntegerThe number of records you want to fetch in a page. The default value is 200.Positive Integer values only

Sample Request

Copiedcurl --request GET 'https://fsm.zoho.com/fsm/v1/Assets' \
--header 'Authorization: Zoho-oauthtoken 1000.3xxxxxxxxx.xxxxxxxxxxxxx0e'

Sample Response

Copied{
    "data": [
        {
            "Parent_Asset": null,
            "Warranty_Expiration": "2025-07-20",
            "Owner": {
                "name": "Mary Cooper",
                "id": "1439000000161001",
                "email": "lucy.robins@zylker.com"
            },
            "Company": {
                "name": "ABC Services",
                "id": "1439000000161212"
            },
            "Description": null,
            "$currency_symbol": "$",
            "Address": null,
            "Installation_Date": "2023-07-20",
            "Product": {
                "name": "2 Ton 5 Star Split AC",
                "id": "1439000000611088"
            },
            "Name": "2 Ton 5 Star Inverter Split AC | MS-Q02YLZA",
            "Modified_By": {
                "name": "Mary Cooper",
                "id": "1439000000161001",
                "email": "lucy.robins@zylker.com"
            },
            "Purchased_Date": "2023-07-20",
            "Exchange_Rate": 1,
            "Currency": "USD",
            "$inactive": false,
            "id": "1439000000611092",
            "Status": null,
            "Modified_Time": "2023-07-20T17:57:47+05:30",
            "Created_Time": "2023-07-20T17:57:47+05:30",
            "$editable": true,
            "GIAI": "1414102440",
            "$permissions": {
                "read": true,
                "edit": true,
                "delete": true
            },
            "Contact": {
                "name": "Lucy Robins",
                "id": "1439000000504117"
            },
            "Asset_Number": "102411414",
            "Ordered_Date": "2023-07-18",
            "Price": null,
            "Created_By": {
                "name": "Mary Cooper",
                "id": "1439000000161001",
                "email": "lucy.robins@zylker.com"
            }
        },
        {
            "Parent_Asset": {
                "name": "Metal CCTV Camera (2MP Bullet Metal Camera)",
                "id": "1439000000438093"
            },
            "Warranty_Expiration": null,
            "Owner": {
                "name": "Mary Cooper",
                "id": "1439000000161001",
                "email": "lucy.robins@zylker.com"
            },
            "Company": {
                "name": "ABC Services",
                "id": "1439000000161212"
            },
            "Description": null,
            "$currency_symbol": "$",
            "Address": null,
            "Installation_Date": null,
            "Product": {
                "name": "Metal CCTV Camera",
                "id": "1439000000438082"
            },
            "Name": "Metal CCTV Camera (2MP Bullet Metal Camera) | C07NQMJ97",
            "Modified_By": {
                "name": "Mary Cooper",
                "id": "1439000000161001",
                "email": "lucy.robins@zylker.com"
            },
            "Purchased_Date": null,
            "Exchange_Rate": 1,
            "Currency": "USD",
            "$inactive": false,
            "id": "1439000000438120",
            "Status": null,
            "Modified_Time": "2023-02-27T15:53:30+05:30",
            "Created_Time": "2023-02-27T15:53:30+05:30",
            "$editable": true,
            "GIAI": null,
            "$permissions": {
                "read": true,
                "edit": true,
                "delete": true
            },
            "Contact": {
                "name": "Lucy Robins",
                "id": "1439000000161222"
            },
            "Asset_Number": null,
            "Ordered_Date": null,
            "Price": null,
            "Created_By": {
                "name": "Mary Cooper",
                "id": "1439000000161001",
                "email": "lucy.robins@zylker.com"
            }
        }
    ],
    "info": {
        "per_page": 20,
        "count": 2,
        "page": 1,
        "more_records": false
    }
}