Skip to content

Asset

All physical and virtual assets of your organization along with their financial and lifecycle details can be tracked using the Asset module.

Attributes

id (long)
Unique identifier to identify the asset

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

created_time (datetime)read only
Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

department (department)
Asset assigned to the department

department (department)
Indicates the department assigned to the asset

Example

{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}

site (site)
Site of the asset

site (site)
Site of the asset

Example

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

total_cost (double)read only
Total cost of the asset

total_cost (double)
These are numbers that can include contains decimals.

Example

23.08

last_updated_time (datetime)read only
Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

More Attributes Expand all

category (asset_category)read only

Category of the product type. For ex: IT, Non-IT

category (asset_category)
Category of the product type. For ex: IT, Non-IT

Example

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

attachments (attachment)

Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

created_by (user)read only

Indicates the user who created the asset

created_by (user)
Indicates the user who created the asset

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

purchase_order (purchase_order)read only

Details of the purchase order associated with this asset

purchase_order (purchase_order)
Details of the purchase order associated with this asset

udf_fields (udf_fields)

Holds udf fields’ values associated with the asset.

udf_fields (udf_fields)
Holds udf fields & values associated with the asset.

user (user)

Asset assigned to the user

user (user)
Asset assigned to the user

Example

{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

name (string)

Unique name to identify the asset

name (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

product (product)

Product of the asset

product (product)
Indicates the product of the asset

Example

{
  "product": {
    "name": "test-product",
    "id": "234567890123456"
  }
}

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

asset_tag (string)

Asset tag used to identify the asset

asset_tag (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

state (asset_state)

State of the asset

state (asset_state)
Indicates the state of the asset

Example

{
  "state": {
    "name": "test-state",
    "id": "234567890123456"
  }
}

state_history_comments (string)

No Description

state_history_comments (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

serial_number (string)

Serial number used to identify the asset

serial_number (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

barcode (string)

Unique barcode used to identify the asset

barcode (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

vendor (vendor)

Vendor of the asset

vendor (vendor)
Vendor of the asset

Example

{
  "vendor": {
    "name": "test-vendor",
    "id": "234567890123456"
  }
}

acquisition_date (date)

Indicates the date when the asset was acquired.

acquisition_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

warranty_expiry (date)

Indicates the date when the asset will approach the warranty expiry date.

warranty_expiry (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

expiry_date (date)

Indicates the date when the asset will expire.

expiry_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

ip_address (string)read only

No Description

ip_address (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

mac_address (string)read only

No Description

mac_address (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

location (string)

Location of the asset

location (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

region (region)read only

Region of the site

region (region)

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

operational_cost (double)read only

Operational cost of the asset

operational_cost (double)
These are numbers that can include contains decimals.

Example

23.08

current_cost (double)read only

Current value of the asset

current_cost (double)
These are numbers that can include contains decimals.

Example

23.08

asset_depreciation (depreciation_detail)read only

Depreciation details configured for the asset

asset_depreciation (depreciation_detail)
Depreciation details configured for the asset

Example

{
  "asset_depreciation": {
    "name": "test-asset_depreciation",
    "id": "234567890123456"
  }
}

product_depreciation (depreciation_detail)read only

Depreciation details configured for the asset’s product

product_depreciation (depreciation_detail)
Depreciation details configured for the asset’s product

Example

{
  "product_depreciation": {
    "name": "test-product_depreciation",
    "id": "234567890123456"
  }
}

used_by_asset (asset)

Asset associated to this asset

used_by_asset (asset)
Asset associated to this asset

Example

{
  "used_by_asset": {
    "name": "test-used_by_asset",
    "id": "234567890123456"
  }
}

device_type (device_type)

Device type of the asset

device_type (device_type)
Indicates the device type of the asset

Example

{
  "device_type": {
    "name": "test-device_type",
    "id": "234567890123456"
  }
}

is_swscan_needed (boolean)

Boolean value indicating whether this asset needs a software scan or not

is_swscan_needed (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_configured (boolean)read only

Boolean value indicating whether this asset depreciation is configured or not

is_depreciation_configured (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_calculated (boolean)read only

Boolean value indicating whether this asset depreciation is calculated or not

is_depreciation_calculated (boolean)
Boolean value which can have two possible values. The values are true and false.

discovered_serial_number (string)

Discovered serial number to identify the asset

discovered_serial_number (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

probe (probe)

Probe associated to the asset

probe (probe)
Probe associated to the asset

Example

{
  "probe": {
    "name": "test-probe",
    "id": "234567890123456"
  }
}

suggested_owner (user)

Suggested owner for the asset

suggested_owner (user)
Indicates the suggested owner for the asset

Example

{
  "suggested_owner": {
    "name": "test-suggested_owner",
    "id": "234567890123456"
  }
}

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

purchase_lot_id (long)read only

Indicates the purchase lot id of this asset

purchase_lot_id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

is_in_contract (boolean)read only

No Description

is_in_contract (boolean)
Boolean value which can have two possible values. The values are true and false.

last_audit (audit_history)read only

No Description

last_audit (audit_history)
Indicates the last audit

Example

{
  "last_audit": {
    "name": "test-last_audit",
    "id": "234567890123456"
  }
}

last_success_audit (audit_history)read only

No Description

last_success_audit (audit_history)
Indicates the last successful audit

Example

{
  "last_success_audit": {
    "name": "test-last_success_audit",
    "id": "234567890123456"
  }
}

product_type (product_type)read only

Product type of the product

product_type (product_type)
Product type of the asset product

Example

{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

credential (credential)

Credentials of the asset

credential (credential)
Indicates the credentials of the asset

Example

{
  "credential": {
    "name": "test-credential",
    "id": "234567890123456"
  }
}

is_loaned (boolean)read only

Boolean value indicating whether this asset is loaned or not  

is_loaned (boolean)
Boolean value which can have two possible values. The values are true and false.

loan (loaned_asset)read only

Indicates the loan information such as (Loan ID, Loan Period)

loan (loaned_asset)

is_loanable (boolean)

Boolean value indicating whether this asset is loanable or not

is_loanable (boolean)
Boolean value which can have two possible values. The values are true and false.

Add Asset

This operation helps you Add assets.

Mandatory Fields :- name, product, state

Url

api/v3/assets

Attributes

id (long)
Unique identifier to identify the asset

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

created_time (datetime)read only
Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

department (department)
Asset assigned to the department

department (department)
Indicates the department assigned to the asset

Example

{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}

site (site)
Site of the asset

site (site)
Site of the asset

Example

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

total_cost (double)read only
Total cost of the asset

total_cost (double)
These are numbers that can include contains decimals.

Example

23.08

last_updated_time (datetime)read only
Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

More Attributes Expand all

category (asset_category)read only

Category of the product type. For ex: IT, Non-IT

category (asset_category)
Category of the product type. For ex: IT, Non-IT

Example

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

attachments (attachment)

Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

created_by (user)read only

Indicates the user who created the asset

created_by (user)
Indicates the user who created the asset

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

purchase_order (purchase_order)read only

Details of the purchase order associated with this asset

purchase_order (purchase_order)
Details of the purchase order associated with this asset

udf_fields (udf_fields)

Holds udf fields’ values associated with the asset.

udf_fields (udf_fields)
Holds udf fields & values associated with the asset.

user (user)

Asset assigned to the user

user (user)
Asset assigned to the user

Example

{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

name (string)

Unique name to identify the asset

name (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

product (product)

Product of the asset

product (product)
Indicates the product of the asset

Example

{
  "product": {
    "name": "test-product",
    "id": "234567890123456"
  }
}

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

asset_tag (string)

Asset tag used to identify the asset

asset_tag (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

state (asset_state)

State of the asset

state (asset_state)
Indicates the state of the asset

Example

{
  "state": {
    "name": "test-state",
    "id": "234567890123456"
  }
}

state_history_comments (string)

No Description

state_history_comments (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

serial_number (string)

Serial number used to identify the asset

serial_number (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

barcode (string)

Unique barcode used to identify the asset

barcode (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

vendor (vendor)

Vendor of the asset

vendor (vendor)
Vendor of the asset

Example

{
  "vendor": {
    "name": "test-vendor",
    "id": "234567890123456"
  }
}

acquisition_date (date)

Indicates the date when the asset was acquired.

acquisition_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

warranty_expiry (date)

Indicates the date when the asset will approach the warranty expiry date.

warranty_expiry (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

expiry_date (date)

Indicates the date when the asset will expire.

expiry_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

ip_address (string)read only

No Description

ip_address (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

mac_address (string)read only

No Description

mac_address (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

location (string)

Location of the asset

location (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

region (region)read only

Region of the site

region (region)

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

operational_cost (double)read only

Operational cost of the asset

operational_cost (double)
These are numbers that can include contains decimals.

Example

23.08

current_cost (double)read only

Current value of the asset

current_cost (double)
These are numbers that can include contains decimals.

Example

23.08

asset_depreciation (depreciation_detail)read only

Depreciation details configured for the asset

asset_depreciation (depreciation_detail)
Depreciation details configured for the asset

Example

{
  "asset_depreciation": {
    "name": "test-asset_depreciation",
    "id": "234567890123456"
  }
}

product_depreciation (depreciation_detail)read only

Depreciation details configured for the asset’s product

product_depreciation (depreciation_detail)
Depreciation details configured for the asset’s product

Example

{
  "product_depreciation": {
    "name": "test-product_depreciation",
    "id": "234567890123456"
  }
}

used_by_asset (asset)

Asset associated to this asset

used_by_asset (asset)
Asset associated to this asset

Example

{
  "used_by_asset": {
    "name": "test-used_by_asset",
    "id": "234567890123456"
  }
}

device_type (device_type)

Device type of the asset

device_type (device_type)
Indicates the device type of the asset

Example

{
  "device_type": {
    "name": "test-device_type",
    "id": "234567890123456"
  }
}

is_swscan_needed (boolean)

Boolean value indicating whether this asset needs a software scan or not

is_swscan_needed (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_configured (boolean)read only

Boolean value indicating whether this asset depreciation is configured or not

is_depreciation_configured (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_calculated (boolean)read only

Boolean value indicating whether this asset depreciation is calculated or not

is_depreciation_calculated (boolean)
Boolean value which can have two possible values. The values are true and false.

discovered_serial_number (string)

Discovered serial number to identify the asset

discovered_serial_number (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

probe (probe)

Probe associated to the asset

probe (probe)
Probe associated to the asset

Example

{
  "probe": {
    "name": "test-probe",
    "id": "234567890123456"
  }
}

suggested_owner (user)

Suggested owner for the asset

suggested_owner (user)
Indicates the suggested owner for the asset

Example

{
  "suggested_owner": {
    "name": "test-suggested_owner",
    "id": "234567890123456"
  }
}

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

purchase_lot_id (long)read only

Indicates the purchase lot id of this asset

purchase_lot_id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

is_in_contract (boolean)read only

No Description

is_in_contract (boolean)
Boolean value which can have two possible values. The values are true and false.

last_audit (audit_history)read only

No Description

last_audit (audit_history)
Indicates the last audit

Example

{
  "last_audit": {
    "name": "test-last_audit",
    "id": "234567890123456"
  }
}

last_success_audit (audit_history)read only

No Description

last_success_audit (audit_history)
Indicates the last successful audit

Example

{
  "last_success_audit": {
    "name": "test-last_success_audit",
    "id": "234567890123456"
  }
}

product_type (product_type)read only

Product type of the product

product_type (product_type)
Product type of the asset product

Example

{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

credential (credential)

Credentials of the asset

credential (credential)
Indicates the credentials of the asset

Example

{
  "credential": {
    "name": "test-credential",
    "id": "234567890123456"
  }
}

is_loaned (boolean)read only

Boolean value indicating whether this asset is loaned or not  

is_loaned (boolean)
Boolean value which can have two possible values. The values are true and false.

loan (loaned_asset)read only

Indicates the loan information such as (Loan ID, Loan Period)

loan (loaned_asset)

is_loanable (boolean)

Boolean value indicating whether this asset is loanable or not

is_loanable (boolean)
Boolean value which can have two possible values. The values are true and false.

$ curl api/v3/assets
      -X POST 
      -H "Accept: application/vnd.manageengine.sdp.v3+json" 
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx" 
      -H "Content-Type: application/x-www-form-urlencoded"
      -d input_data= 
  '{
  "asset": {
    "retain_user_site": false,
    "acquisition_date": {
      "value": "1478758440000"
    },
    "vendor": {
      "name": "test-name",
      "id": "1762632440935269"
    },
    "suggested_owner": {
      "name": "Lincoln",
      "id": "1544077640540465"
    },
    "purchase_cost": 1343434.4333,
    "state": {
      "name": "In Use",
      "id": "1651471221136919"
    },
    "department": {
      "name": "Administration",
      "id": "1569272846971707"
    },
    "barcode": "test-barcode",
    "asset_tag": "test-asset_tag",
    "product": {
      "name": "test-name",
      "id": "2279871101619577"
    },
    "expiry_date": {
      "value": "1478758440000"
    },
    "used_by_asset": {
      "name": "192.0.2.1",
      "id": "2061627944496758",
      "barcode": "test-barcode"
    },
    "serial_number": "test-serial_number",
    "warranty_expiry": {
      "value": "1478758440000"
    },
    "site": {
      "name": "Custom Site",
      "id": "2248743224252246"
    },
    "name": "192.0.2.1",
    "udf_fields": {
      "udf_ref1": {
        "name": "192.0.2.1",
        "id": "2022316323942908"
      },
      "udf_boolean1": false,
      "udf_long1": "2167049216006549",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "192.0.2.1",
        "id": "1948848567669779"
      }
    },
    "location": "test-location",
    "is_loanable": false,
    "user": {
      "name": "Lincoln",
      "id": "2332056023467953"
    },
    "state_history_comments": "test-state_history_comments"
  }
}'
{
  "assets": [
    {
      "loan": {
        "start_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "id": "2202412849898869",
        "returned_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "barcode": "test-barcode",
        "due_by_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "loan_id": {
          "display_value": "CH 44",
          "value": "44"
        }
      },
      "total_cost": 1343434.4333,
      "retain_user_site": false,
      "type": {
        "name": "Asset",
        "id": "1851036130424706"
      },
      "acquisition_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "last_updated_by": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "1931243440974593",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "current_cost": 1343434.4333,
      "mac_address": "test-mac_address",
      "vendor": {
        "name": "test-name",
        "description": "test-description",
        "id": "1600345397919069"
      },
      "suggested_owner": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "1833730161964620",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "id": "1940146646346105",
      "purchase_cost": 1343434.4333,
      "state": {
        "name": "In Use",
        "description": "test-description",
        "id": "1997855208293323"
      },
      "department": {
        "name": "Administration",
        "id": "1646093724088044"
      },
      "barcode": "test-barcode",
      "product_depreciation": {
        "useful_life": "2075185421326656",
        "id": "1773555301971862",
        "depreciation_percent": 1343434.4333,
        "salvage_value": 1343434.4333
      },
      "operational_cost": 1343434.4333,
      "asset_tag": "test-asset_tag",
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "is_in_contract": false,
      "product": {
        "part_no": "test-part_no",
        "name": "test-name",
        "id": "2203626079925056",
        "manufacturer": "test-manufacturer"
      },
      "asset_depreciation": {
        "useful_life": "1968676074506315",
        "id": "2397974411710814",
        "depreciation_percent": 1343434.4333,
        "salvage_value": 1343434.4333
      },
      "expiry_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "used_by_asset": {
        "name": "192.0.2.1",
        "id": "2125499639284144",
        "barcode": "test-barcode"
      },
      "serial_number": "test-serial_number",
      "warranty_expiry": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "ip_address": "test-ip_address",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "2460346067969005",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "site": {
        "deleted": false,
        "name": "Custom Site",
        "id": "2206962023146413"
      },
      "product_type": {
        "image": "test-image",
        "name": "Workstation",
        "id": "2435207563113307"
      },
      "last_updated_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "purchase_order": "test-purchase_order",
      "name": "192.0.2.1",
      "udf_fields": {
        "udf_ref1": {
          "name": "192.0.2.1",
          "id": "2076880273265196"
        },
        "udf_boolean1": false,
        "udf_long1": "1853534370072958",
        "udf_date1": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "udf_double1": "test-udf_double1",
        "udf_char1": "test-udf_char1",
        "deptheadid": {
          "name": "192.0.2.1",
          "id": "2164213274712948"
        }
      },
      "is_depreciation_configured": false,
      "discovered_serial_number": "test-discovered_serial_number",
      "location": "test-location",
      "is_loaned": false,
      "is_loanable": false,
      "is_depreciation_calculated": false,
      "category": {
        "name": "IT",
        "description": "test-description",
        "id": "2468364707909441"
      },
      "region": {
        "name": "test-name",
        "id": "2447741868138771"
      },
      "user": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "2013687346724848",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "last_success_audit": {
        "description": "test-description",
        "id": "1575342738117535",
        "time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "status": "test-status"
      },
      "state_history_comments": "test-state_history_comments",
      "last_audit": {
        "description": "test-description",
        "id": "1776509158743722",
        "time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "status": "test-status"
      }
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "asset": {
    "loan": {
      "start_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "id": "1794378589216650",
      "returned_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "barcode": "test-barcode",
      "due_by_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "loan_id": {
        "display_value": "CH 44",
        "value": "44"
      }
    },
    "total_cost": 1343434.4333,
    "retain_user_site": false,
    "type": {
      "name": "Asset",
      "id": "1694816465765730"
    },
    "acquisition_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "last_updated_by": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "2243837130986761",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "current_cost": 1343434.4333,
    "mac_address": "test-mac_address",
    "vendor": {
      "name": "test-name",
      "description": "test-description",
      "id": "1762632440935269"
    },
    "suggested_owner": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1544077640540465",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "id": "1705443869314617",
    "purchase_cost": 1343434.4333,
    "state": {
      "name": "In Use",
      "description": "test-description",
      "id": "1651471221136919"
    },
    "department": {
      "name": "Administration",
      "id": "1569272846971707"
    },
    "barcode": "test-barcode",
    "product_depreciation": {
      "useful_life": "1884664181507407",
      "id": "1887553156383214",
      "depreciation_percent": 1343434.4333,
      "salvage_value": 1343434.4333
    },
    "operational_cost": 1343434.4333,
    "asset_tag": "test-asset_tag",
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_in_contract": false,
    "product": {
      "part_no": "test-part_no",
      "name": "test-name",
      "id": "2279871101619577",
      "manufacturer": "test-manufacturer"
    },
    "asset_depreciation": {
      "useful_life": "2372788052263184",
      "id": "2332434326383660",
      "depreciation_percent": 1343434.4333,
      "salvage_value": 1343434.4333
    },
    "expiry_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "used_by_asset": {
      "name": "192.0.2.1",
      "id": "2061627944496758",
      "barcode": "test-barcode"
    },
    "serial_number": "test-serial_number",
    "warranty_expiry": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "ip_address": "test-ip_address",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1496847786447050",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "site": {
      "deleted": false,
      "name": "Custom Site",
      "id": "2248743224252246"
    },
    "product_type": {
      "image": "test-image",
      "name": "Workstation",
      "id": "2133479715812885"
    },
    "last_updated_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "purchase_order": "test-purchase_order",
    "name": "192.0.2.1",
    "udf_fields": {
      "udf_ref1": {
        "name": "192.0.2.1",
        "id": "2022316323942908"
      },
      "udf_boolean1": false,
      "udf_long1": "2167049216006549",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "192.0.2.1",
        "id": "1948848567669779"
      }
    },
    "is_depreciation_configured": false,
    "discovered_serial_number": "test-discovered_serial_number",
    "location": "test-location",
    "is_loaned": false,
    "is_loanable": false,
    "is_depreciation_calculated": false,
    "category": {
      "name": "IT",
      "description": "test-description",
      "id": "1727197951644696"
    },
    "region": {
      "name": "test-name",
      "id": "1817558050116230"
    },
    "user": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "2332056023467953",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "last_success_audit": {
      "description": "test-description",
      "id": "1560914354969749",
      "time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "status": "test-status"
    },
    "state_history_comments": "test-state_history_comments",
    "last_audit": {
      "description": "test-description",
      "id": "1579144827714947",
      "time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "status": "test-status"
    }
  }
}

Edit Asset

This operation helps you Edit assets.

Url

api/v3/assets/{asset_id}

Attributes

id (long)
Unique identifier to identify the asset

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

created_time (datetime)read only
Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

department (department)
Asset assigned to the department

department (department)
Indicates the department assigned to the asset

Example

{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}

site (site)
Site of the asset

site (site)
Site of the asset

Example

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

total_cost (double)read only
Total cost of the asset

total_cost (double)
These are numbers that can include contains decimals.

Example

23.08

last_updated_time (datetime)read only
Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

More Attributes Expand all

category (asset_category)read only

Category of the product type. For ex: IT, Non-IT

category (asset_category)
Category of the product type. For ex: IT, Non-IT

Example

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

attachments (attachment)

Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

created_by (user)read only

Indicates the user who created the asset

created_by (user)
Indicates the user who created the asset

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

purchase_order (purchase_order)read only

Details of the purchase order associated with this asset

purchase_order (purchase_order)
Details of the purchase order associated with this asset

udf_fields (udf_fields)

Holds udf fields’ values associated with the asset.

udf_fields (udf_fields)
Holds udf fields & values associated with the asset.

user (user)

Asset assigned to the user

user (user)
Asset assigned to the user

Example

{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

name (string)

Unique name to identify the asset

name (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

product (product)

Product of the asset

product (product)
Indicates the product of the asset

Example

{
  "product": {
    "name": "test-product",
    "id": "234567890123456"
  }
}

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

asset_tag (string)

Asset tag used to identify the asset

asset_tag (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

state (asset_state)

State of the asset

state (asset_state)
Indicates the state of the asset

Example

{
  "state": {
    "name": "test-state",
    "id": "234567890123456"
  }
}

state_history_comments (string)

No Description

state_history_comments (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

serial_number (string)

Serial number used to identify the asset

serial_number (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

barcode (string)

Unique barcode used to identify the asset

barcode (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

vendor (vendor)

Vendor of the asset

vendor (vendor)
Vendor of the asset

Example

{
  "vendor": {
    "name": "test-vendor",
    "id": "234567890123456"
  }
}

acquisition_date (date)

Indicates the date when the asset was acquired.

acquisition_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

warranty_expiry (date)

Indicates the date when the asset will approach the warranty expiry date.

warranty_expiry (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

expiry_date (date)

Indicates the date when the asset will expire.

expiry_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

ip_address (string)read only

No Description

ip_address (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

mac_address (string)read only

No Description

mac_address (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

location (string)

Location of the asset

location (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

region (region)read only

Region of the site

region (region)

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

operational_cost (double)read only

Operational cost of the asset

operational_cost (double)
These are numbers that can include contains decimals.

Example

23.08

current_cost (double)read only

Current value of the asset

current_cost (double)
These are numbers that can include contains decimals.

Example

23.08

asset_depreciation (depreciation_detail)read only

Depreciation details configured for the asset

asset_depreciation (depreciation_detail)
Depreciation details configured for the asset

Example

{
  "asset_depreciation": {
    "name": "test-asset_depreciation",
    "id": "234567890123456"
  }
}

product_depreciation (depreciation_detail)read only

Depreciation details configured for the asset’s product

product_depreciation (depreciation_detail)
Depreciation details configured for the asset’s product

Example

{
  "product_depreciation": {
    "name": "test-product_depreciation",
    "id": "234567890123456"
  }
}

used_by_asset (asset)

Asset associated to this asset

used_by_asset (asset)
Asset associated to this asset

Example

{
  "used_by_asset": {
    "name": "test-used_by_asset",
    "id": "234567890123456"
  }
}

device_type (device_type)

Device type of the asset

device_type (device_type)
Indicates the device type of the asset

Example

{
  "device_type": {
    "name": "test-device_type",
    "id": "234567890123456"
  }
}

is_swscan_needed (boolean)

Boolean value indicating whether this asset needs a software scan or not

is_swscan_needed (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_configured (boolean)read only

Boolean value indicating whether this asset depreciation is configured or not

is_depreciation_configured (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_calculated (boolean)read only

Boolean value indicating whether this asset depreciation is calculated or not

is_depreciation_calculated (boolean)
Boolean value which can have two possible values. The values are true and false.

discovered_serial_number (string)

Discovered serial number to identify the asset

discovered_serial_number (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

probe (probe)

Probe associated to the asset

probe (probe)
Probe associated to the asset

Example

{
  "probe": {
    "name": "test-probe",
    "id": "234567890123456"
  }
}

suggested_owner (user)

Suggested owner for the asset

suggested_owner (user)
Indicates the suggested owner for the asset

Example

{
  "suggested_owner": {
    "name": "test-suggested_owner",
    "id": "234567890123456"
  }
}

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

purchase_lot_id (long)read only

Indicates the purchase lot id of this asset

purchase_lot_id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

is_in_contract (boolean)read only

No Description

is_in_contract (boolean)
Boolean value which can have two possible values. The values are true and false.

last_audit (audit_history)read only

No Description

last_audit (audit_history)
Indicates the last audit

Example

{
  "last_audit": {
    "name": "test-last_audit",
    "id": "234567890123456"
  }
}

last_success_audit (audit_history)read only

No Description

last_success_audit (audit_history)
Indicates the last successful audit

Example

{
  "last_success_audit": {
    "name": "test-last_success_audit",
    "id": "234567890123456"
  }
}

product_type (product_type)read only

Product type of the product

product_type (product_type)
Product type of the asset product

Example

{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

credential (credential)

Credentials of the asset

credential (credential)
Indicates the credentials of the asset

Example

{
  "credential": {
    "name": "test-credential",
    "id": "234567890123456"
  }
}

is_loaned (boolean)read only

Boolean value indicating whether this asset is loaned or not  

is_loaned (boolean)
Boolean value which can have two possible values. The values are true and false.

loan (loaned_asset)read only

Indicates the loan information such as (Loan ID, Loan Period)

loan (loaned_asset)

is_loanable (boolean)

Boolean value indicating whether this asset is loanable or not

is_loanable (boolean)
Boolean value which can have two possible values. The values are true and false.

$ curl api/v3/assets/{asset_id}
      -X PUT 
      -H "Accept: application/vnd.manageengine.sdp.v3+json" 
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx" 
      -H "Content-Type: application/x-www-form-urlencoded"
      -d input_data= 
  '{
  "asset": {
    "asset_tag": "test-asset_tag",
    "product": {
      "name": "test-name",
      "id": "1538924561770181"
    },
    "expiry_date": {
      "value": "1478758440000"
    },
    "used_by_asset": {
      "name": "192.0.2.1",
      "id": "1615161639482026",
      "barcode": "test-barcode"
    },
    "retain_user_site": false,
    "serial_number": "test-serial_number",
    "warranty_expiry": {
      "value": "1478758440000"
    },
    "acquisition_date": {
      "value": "1478758440000"
    },
    "site": {
      "name": "Custom Site",
      "id": "2008272288144379"
    },
    "vendor": {
      "name": "test-name",
      "id": "1508598106138405"
    },
    "suggested_owner": {
      "name": "Lincoln",
      "id": "2333210300238087"
    },
    "name": "192.0.2.1",
    "udf_fields": {
      "udf_ref1": {
        "name": "192.0.2.1",
        "id": "2265213289869560"
      },
      "udf_boolean1": false,
      "udf_long1": "1806793859686494",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "192.0.2.1",
        "id": "2175045251780693"
      }
    },
    "location": "test-location",
    "purchase_cost": 1343434.4333,
    "state": {
      "name": "In Use",
      "id": "1850985561780658"
    },
    "is_loanable": false,
    "department": {
      "name": "Administration",
      "id": "1596297793459486"
    },
    "barcode": "test-barcode",
    "user": {
      "name": "Lincoln",
      "id": "1498540603148390"
    },
    "state_history_comments": "test-state_history_comments"
  }
}'
{
  "assets": [
    {
      "loan": {
        "start_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "id": "1744337620909883",
        "returned_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "barcode": "test-barcode",
        "due_by_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "loan_id": {
          "display_value": "CH 44",
          "value": "44"
        }
      },
      "total_cost": 1343434.4333,
      "retain_user_site": false,
      "type": {
        "name": "Asset",
        "id": "1800817206051868"
      },
      "acquisition_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "last_updated_by": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "2121864266215477",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "current_cost": 1343434.4333,
      "mac_address": "test-mac_address",
      "vendor": {
        "name": "test-name",
        "description": "test-description",
        "id": "1545788769730604"
      },
      "suggested_owner": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "2108625337339192",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "id": "1508772825194295",
      "purchase_cost": 1343434.4333,
      "state": {
        "name": "In Use",
        "description": "test-description",
        "id": "1971363994784207"
      },
      "department": {
        "name": "Administration",
        "id": "1694429109768975"
      },
      "barcode": "test-barcode",
      "product_depreciation": {
        "useful_life": "1608242897719408",
        "id": "1904654563128935",
        "depreciation_percent": 1343434.4333,
        "salvage_value": 1343434.4333
      },
      "operational_cost": 1343434.4333,
      "asset_tag": "test-asset_tag",
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "is_in_contract": false,
      "product": {
        "part_no": "test-part_no",
        "name": "test-name",
        "id": "2202151501306814",
        "manufacturer": "test-manufacturer"
      },
      "asset_depreciation": {
        "useful_life": "2133700083283865",
        "id": "1892577029967910",
        "depreciation_percent": 1343434.4333,
        "salvage_value": 1343434.4333
      },
      "expiry_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "used_by_asset": {
        "name": "192.0.2.1",
        "id": "1527911356658909",
        "barcode": "test-barcode"
      },
      "serial_number": "test-serial_number",
      "warranty_expiry": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "ip_address": "test-ip_address",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "1490125119584500",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "site": {
        "deleted": false,
        "name": "Custom Site",
        "id": "2148562567851981"
      },
      "product_type": {
        "image": "test-image",
        "name": "Workstation",
        "id": "2139831954407142"
      },
      "last_updated_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "purchase_order": "test-purchase_order",
      "name": "192.0.2.1",
      "udf_fields": {
        "udf_ref1": {
          "name": "192.0.2.1",
          "id": "1543141107508834"
        },
        "udf_boolean1": false,
        "udf_long1": "1587620509526891",
        "udf_date1": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "udf_double1": "test-udf_double1",
        "udf_char1": "test-udf_char1",
        "deptheadid": {
          "name": "192.0.2.1",
          "id": "1825559602438955"
        }
      },
      "is_depreciation_configured": false,
      "discovered_serial_number": "test-discovered_serial_number",
      "location": "test-location",
      "is_loaned": false,
      "is_loanable": false,
      "is_depreciation_calculated": false,
      "category": {
        "name": "IT",
        "description": "test-description",
        "id": "1502149773159483"
      },
      "region": {
        "name": "test-name",
        "id": "1981250508163550"
      },
      "user": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "2424818139761592",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "last_success_audit": {
        "description": "test-description",
        "id": "2238629254612593",
        "time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "status": "test-status"
      },
      "state_history_comments": "test-state_history_comments",
      "last_audit": {
        "description": "test-description",
        "id": "1797551065842989",
        "time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "status": "test-status"
      }
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "asset": {
    "loan": {
      "start_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "id": "2436059452452004",
      "returned_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "barcode": "test-barcode",
      "due_by_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "loan_id": {
        "display_value": "CH 44",
        "value": "44"
      }
    },
    "total_cost": 1343434.4333,
    "retain_user_site": false,
    "type": {
      "name": "Asset",
      "id": "2018933285562933"
    },
    "acquisition_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "last_updated_by": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1627526992794249",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "current_cost": 1343434.4333,
    "mac_address": "test-mac_address",
    "vendor": {
      "name": "test-name",
      "description": "test-description",
      "id": "1508598106138405"
    },
    "suggested_owner": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "2333210300238087",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "id": "1811130946886149",
    "purchase_cost": 1343434.4333,
    "state": {
      "name": "In Use",
      "description": "test-description",
      "id": "1850985561780658"
    },
    "department": {
      "name": "Administration",
      "id": "1596297793459486"
    },
    "barcode": "test-barcode",
    "product_depreciation": {
      "useful_life": "1891194435952305",
      "id": "1863910267324447",
      "depreciation_percent": 1343434.4333,
      "salvage_value": 1343434.4333
    },
    "operational_cost": 1343434.4333,
    "asset_tag": "test-asset_tag",
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_in_contract": false,
    "product": {
      "part_no": "test-part_no",
      "name": "test-name",
      "id": "1538924561770181",
      "manufacturer": "test-manufacturer"
    },
    "asset_depreciation": {
      "useful_life": "1514169621635118",
      "id": "2155596492095710",
      "depreciation_percent": 1343434.4333,
      "salvage_value": 1343434.4333
    },
    "expiry_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "used_by_asset": {
      "name": "192.0.2.1",
      "id": "1615161639482026",
      "barcode": "test-barcode"
    },
    "serial_number": "test-serial_number",
    "warranty_expiry": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "ip_address": "test-ip_address",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1847855233440788",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "site": {
      "deleted": false,
      "name": "Custom Site",
      "id": "2008272288144379"
    },
    "product_type": {
      "image": "test-image",
      "name": "Workstation",
      "id": "1776127248585271"
    },
    "last_updated_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "purchase_order": "test-purchase_order",
    "name": "192.0.2.1",
    "udf_fields": {
      "udf_ref1": {
        "name": "192.0.2.1",
        "id": "2265213289869560"
      },
      "udf_boolean1": false,
      "udf_long1": "1806793859686494",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "192.0.2.1",
        "id": "2175045251780693"
      }
    },
    "is_depreciation_configured": false,
    "discovered_serial_number": "test-discovered_serial_number",
    "location": "test-location",
    "is_loaned": false,
    "is_loanable": false,
    "is_depreciation_calculated": false,
    "category": {
      "name": "IT",
      "description": "test-description",
      "id": "1699748402743342"
    },
    "region": {
      "name": "test-name",
      "id": "1521714521705120"
    },
    "user": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1498540603148390",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "last_success_audit": {
      "description": "test-description",
      "id": "2069819757171727",
      "time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "status": "test-status"
    },
    "state_history_comments": "test-state_history_comments",
    "last_audit": {
      "description": "test-description",
      "id": "1569806904581067",
      "time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "status": "test-status"
    }
  }
}

Delete Asset

This operation helps you Delete assets.

Url

api/v3/assets/{asset_id}
$ curl api/v3/assets/{asset_id}
      -X DELETE 
      -H "Accept: application/vnd.manageengine.sdp.v3+json" 
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx" 
      -H "Content-Type: application/x-www-form-urlencoded"
{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

Get Asset

This operation helps you Get assets.

Url

api/v3/assets/{asset_id}

Attributes

id (long)
Unique identifier to identify the asset

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

created_time (datetime)read only
Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

department (department)
Asset assigned to the department

department (department)
Indicates the department assigned to the asset

Example

{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}

site (site)
Site of the asset

site (site)
Site of the asset

Example

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

total_cost (double)read only
Total cost of the asset

total_cost (double)
These are numbers that can include contains decimals.

Example

23.08

last_updated_time (datetime)read only
Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

More Attributes Expand all

category (asset_category)read only

Category of the product type. For ex: IT, Non-IT

category (asset_category)
Category of the product type. For ex: IT, Non-IT

Example

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

attachments (attachment)

Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

created_by (user)read only

Indicates the user who created the asset

created_by (user)
Indicates the user who created the asset

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

purchase_order (purchase_order)read only

Details of the purchase order associated with this asset

purchase_order (purchase_order)
Details of the purchase order associated with this asset

udf_fields (udf_fields)

Holds udf fields’ values associated with the asset.

udf_fields (udf_fields)
Holds udf fields & values associated with the asset.

user (user)

Asset assigned to the user

user (user)
Asset assigned to the user

Example

{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

name (string)

Unique name to identify the asset

name (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

product (product)

Product of the asset

product (product)
Indicates the product of the asset

Example

{
  "product": {
    "name": "test-product",
    "id": "234567890123456"
  }
}

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

asset_tag (string)

Asset tag used to identify the asset

asset_tag (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

state (asset_state)

State of the asset

state (asset_state)
Indicates the state of the asset

Example

{
  "state": {
    "name": "test-state",
    "id": "234567890123456"
  }
}

state_history_comments (string)

No Description

state_history_comments (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

serial_number (string)

Serial number used to identify the asset

serial_number (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

barcode (string)

Unique barcode used to identify the asset

barcode (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

vendor (vendor)

Vendor of the asset

vendor (vendor)
Vendor of the asset

Example

{
  "vendor": {
    "name": "test-vendor",
    "id": "234567890123456"
  }
}

acquisition_date (date)

Indicates the date when the asset was acquired.

acquisition_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

warranty_expiry (date)

Indicates the date when the asset will approach the warranty expiry date.

warranty_expiry (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

expiry_date (date)

Indicates the date when the asset will expire.

expiry_date (date)
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

ip_address (string)read only

No Description

ip_address (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

mac_address (string)read only

No Description

mac_address (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

location (string)

Location of the asset

location (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

region (region)read only

Region of the site

region (region)

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

operational_cost (double)read only

Operational cost of the asset

operational_cost (double)
These are numbers that can include contains decimals.

Example

23.08

current_cost (double)read only

Current value of the asset

current_cost (double)
These are numbers that can include contains decimals.

Example

23.08

asset_depreciation (depreciation_detail)read only

Depreciation details configured for the asset

asset_depreciation (depreciation_detail)
Depreciation details configured for the asset

Example

{
  "asset_depreciation": {
    "name": "test-asset_depreciation",
    "id": "234567890123456"
  }
}

product_depreciation (depreciation_detail)read only

Depreciation details configured for the asset’s product

product_depreciation (depreciation_detail)
Depreciation details configured for the asset’s product

Example

{
  "product_depreciation": {
    "name": "test-product_depreciation",
    "id": "234567890123456"
  }
}

used_by_asset (asset)

Asset associated to this asset

used_by_asset (asset)
Asset associated to this asset

Example

{
  "used_by_asset": {
    "name": "test-used_by_asset",
    "id": "234567890123456"
  }
}

device_type (device_type)

Device type of the asset

device_type (device_type)
Indicates the device type of the asset

Example

{
  "device_type": {
    "name": "test-device_type",
    "id": "234567890123456"
  }
}

is_swscan_needed (boolean)

Boolean value indicating whether this asset needs a software scan or not

is_swscan_needed (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_configured (boolean)read only

Boolean value indicating whether this asset depreciation is configured or not

is_depreciation_configured (boolean)
Boolean value which can have two possible values. The values are true and false.

is_depreciation_calculated (boolean)read only

Boolean value indicating whether this asset depreciation is calculated or not

is_depreciation_calculated (boolean)
Boolean value which can have two possible values. The values are true and false.

discovered_serial_number (string)

Discovered serial number to identify the asset

discovered_serial_number (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

probe (probe)

Probe associated to the asset

probe (probe)
Probe associated to the asset

Example

{
  "probe": {
    "name": "test-probe",
    "id": "234567890123456"
  }
}

suggested_owner (user)

Suggested owner for the asset

suggested_owner (user)
Indicates the suggested owner for the asset

Example

{
  "suggested_owner": {
    "name": "test-suggested_owner",
    "id": "234567890123456"
  }
}

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

purchase_lot_id (long)read only

Indicates the purchase lot id of this asset

purchase_lot_id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

is_in_contract (boolean)read only

No Description

is_in_contract (boolean)
Boolean value which can have two possible values. The values are true and false.

last_audit (audit_history)read only

No Description

last_audit (audit_history)
Indicates the last audit

Example

{
  "last_audit": {
    "name": "test-last_audit",
    "id": "234567890123456"
  }
}

last_success_audit (audit_history)read only

No Description

last_success_audit (audit_history)
Indicates the last successful audit

Example

{
  "last_success_audit": {
    "name": "test-last_success_audit",
    "id": "234567890123456"
  }
}

product_type (product_type)read only

Product type of the product

product_type (product_type)
Product type of the asset product

Example

{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

credential (credential)

Credentials of the asset

credential (credential)
Indicates the credentials of the asset

Example

{
  "credential": {
    "name": "test-credential",
    "id": "234567890123456"
  }
}

business_service_connections (business_service_connection)

No Description

business_service_connections (business_service_connection)

is_loaned (boolean)read only

Boolean value indicating whether this asset is loaned or not  

is_loaned (boolean)
Boolean value which can have two possible values. The values are true and false.

loan (loaned_asset)read only

Indicates the loan information such as (Loan ID, Loan Period)

loan (loaned_asset)

is_loanable (boolean)

Boolean value indicating whether this asset is loanable or not

is_loanable (boolean)
Boolean value which can have two possible values. The values are true and false.

$ curl api/v3/assets/{asset_id}
      -X GET 
      -H "Accept: application/vnd.manageengine.sdp.v3+json" 
      -H "Authorization: Zoho-Oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx" 
      -H "Content-Type: application/x-www-form-urlencoded"
{
  "assets": [
    {
      "loan": {
        "start_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "id": "1564901002015404",
        "returned_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "barcode": "test-barcode",
        "due_by_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "loan_id": {
          "display_value": "CH 44",
          "value": "44"
        }
      },
      "total_cost": 1343434.4333,
      "retain_user_site": false,
      "type": {
        "name": "Asset",
        "id": "2257318872311513"
      },
      "acquisition_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "last_updated_by": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "2089125928670400",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "current_cost": 1343434.4333,
      "mac_address": "test-mac_address",
      "vendor": {
        "name": "test-name",
        "description": "test-description",
        "id": "2003457426462179"
      },
      "suggested_owner": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "2070944061434369",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "id": "1998127136981662",
      "purchase_cost": 1343434.4333,
      "state": {
        "name": "In Use",
        "description": "test-description",
        "id": "2087215867111455"
      },
      "department": {
        "name": "Administration",
        "id": "1849032921648865"
      },
      "barcode": "test-barcode",
      "product_depreciation": {
        "useful_life": "1656568954037517",
        "id": "2251993593459940",
        "depreciation_percent": 1343434.4333,
        "salvage_value": 1343434.4333
      },
      "operational_cost": 1343434.4333,
      "asset_tag": "test-asset_tag",
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "is_in_contract": false,
      "product": {
        "part_no": "test-part_no",
        "name": "test-name",
        "id": "1649203203549376",
        "manufacturer": "test-manufacturer"
      },
      "asset_depreciation": {
        "useful_life": "2066603933365113",
        "id": "2336410326544922",
        "depreciation_percent": 1343434.4333,
        "salvage_value": 1343434.4333
      },
      "expiry_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "used_by_asset": {
        "name": "192.0.2.1",
        "id": "1765479179677795",
        "barcode": "test-barcode"
      },
      "serial_number": "test-serial_number",
      "warranty_expiry": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "ip_address": "test-ip_address",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "1886243971885872",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "site": {
        "deleted": false,
        "name": "Custom Site",
        "id": "2079883423354944"
      },
      "product_type": {
        "image": "test-image",
        "name": "Workstation",
        "id": "2417209522785471"
      },
      "last_updated_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "purchase_order": "test-purchase_order",
      "name": "192.0.2.1",
      "udf_fields": {
        "udf_ref1": {
          "name": "192.0.2.1",
          "id": "1805303736372448"
        },
        "udf_boolean1": false,
        "udf_long1": "1746290644152718",
        "udf_date1": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "udf_double1": "test-udf_double1",
        "udf_char1": "test-udf_char1",
        "deptheadid": {
          "name": "192.0.2.1",
          "id": "2356721335361516"
        }
      },
      "is_depreciation_configured": false,
      "discovered_serial_number": "test-discovered_serial_number",
      "location": "test-location",
      "is_loaned": false,
      "is_loanable": false,
      "is_depreciation_calculated": false,
      "category": {
        "name": "IT",
        "description": "test-description",
        "id": "2071940277814697"
      },
      "region": {
        "name": "test-name",
        "id": "2425230756096240"
      },
      "user": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "1744693167157971",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "last_success_audit": {
        "description": "test-description",
        "id": "2274279934289442",
        "time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "status": "test-status"
      },
      "state_history_comments": "test-state_history_comments",
      "last_audit": {
        "description": "test-description",
        "id": "1759193799481013",
        "time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "status": "test-status"
      }
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "asset": {
    "loan": {
      "start_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "id": "1677147546200029",
      "returned_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "barcode": "test-barcode",
      "due_by_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "loan_id": {
        "display_value": "CH 44",
        "value": "44"
      }
    },
    "total_cost": 1343434.4333,
    "retain_user_site": false,
    "type": {
      "name": "Asset",
      "id": "1748369536196147"
    },
    "acquisition_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "last_updated_by": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1897736858263960",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "current_cost": 1343434.4333,
    "mac_address": "test-mac_address",
    "vendor": {
      "name": "test-name",
      "description": "test-description",
      "id": "1593228594457747"
    },
    "suggested_owner": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1860664181826023",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "id": "1611845356438347",
    "purchase_cost": 1343434.4333,
    "state": {
      "name": "In Use",
      "description": "test-description",
      "id": "1531546400475640"
    },
    "department": {
      "name": "Administration",
      "id": "2092662868546983"
    },
    "barcode": "test-barcode",
    "product_depreciation": {
      "useful_life": "2311771328903913",
      "id": "1571246457380612",
      "depreciation_percent": 1343434.4333,
      "salvage_value": 1343434.4333
    },
    "operational_cost": 1343434.4333,
    "asset_tag": "test-asset_tag",
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_in_contract": false,
    "product": {
      "part_no": "test-part_no",
      "name": "test-name",
      "id": "1835467961600352",
      "manufacturer": "test-manufacturer"
    },
    "asset_depreciation": {
      "useful_life": "2038089490551292",
      "id": "1777823972390846",
      "depreciation_percent": 1343434.4333,
      "salvage_value": 1343434.4333
    },
    "expiry_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "used_by_asset": {
      "name": "192.0.2.1",
      "id": "1514094052499177",
      "barcode": "test-barcode"
    },
    "serial_number": "test-serial_number",
    "warranty_expiry": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "ip_address": "test-ip_address",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1883293288846247",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "site": {
      "deleted": false,
      "name": "Custom Site",
      "id": "1880600746673871"
    },
    "product_type": {
      "image": "test-image",
      "name": "Workstation",
      "id": "1631018605207779"
    },
    "last_updated_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "purchase_order": "test-purchase_order",
    "name": "192.0.2.1",
    "udf_fields": {
      "udf_ref1": {
        "name": "192.0.2.1",
        "id": "2347763628337137"
      },
      "udf_boolean1": false,
      "udf_long1": "1749691798136531",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "192.0.2.1",
        "id": "1858776025388041"
      }
    },
    "is_depreciation_configured": false,
    "discovered_serial_number": "test-discovered_serial_number",
    "location": "test-location",
    "is_loaned": false,
    "is_loanable": false,
    "is_depreciation_calculated": false,
    "category": {
      "name": "IT",
      "description": "test-description",
      "id": "2244170553855784"
    },
    "region": {
      "name": "test-name",
      "id": "1806883907696726"
    },
    "user": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1711179763131227",
      "photo_url": "https://contacts.zoho.com/file?sample",
      "is_vip_user": false
    },
    "last_success_audit": {
      "description": "test-description",
      "id": "1514835742596130",
      "time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "status": "test-status"
    },
    "state_history_comments": "test-state_history_comments",
    "last_audit": {
      "description": "test-description",
      "id": "1489158482505729",
      "time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "status": "test-status"
    }
  }
}

Get List Asset

This operation helps you Get list assets.

Url

api/v3/assets

Attributes

id (long)
Unique identifier to identify the asset

id (long)
Numerical digits which are considered to have larger values.

Example

234759602834500

created_time (datetime)read only
Indicates the time when the asset was created.

created_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

site (site)
Site of the asset

site (site)
Site of the asset

Example

{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

last_updated_time (datetime)read only
Indicates the time when the asset was last updated

last_updated_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

category (asset_category)read only
Category of the product type. For ex: IT, Non-IT

category (asset_category)
Category of the product type. For ex: IT, Non-IT

Example

{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

attachments (attachment)
Attachments for this asset

attachments (attachment)
Indicates the attachments for this asset

Example

{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

More Attributes Expand all

created_by (user)read only

Indicates the user who created the asset

created_by (user)
Indicates the user who created the asset

Example

{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

name (string)

Unique name to identify the asset

name (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

product (product)

Product of the asset

product (product)
Indicates the product of the asset

Example

{
  "product": {
    "name": "test-product",
    "id": "234567890123456"
  }
}

type (asset_type)read only

Type of the product type. For ex: Asset,Component,Software,Consumable

type (asset_type)

state (asset_state)

State of the asset

state (asset_state)
Indicates the state of the asset

Example

{
  "state": {
    "name": "test-state",
    "id": "234567890123456"
  }
}

state_history_comments (string)

No Description

state_history_comments (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

barcode (string)

Unique barcode used to identify the asset

barcode (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

location (string)

Location of the asset

location (string)
A text in a plain format. No rich text or new line characters allowed.

Example

Sample Content

purchase_cost (double)

Purchase cost of the asset

purchase_cost (double)
These are numbers that can include contains decimals.

Example

23.08

last_updated_by (user)read only

Indicates the user who updated the asset

last_updated_by (user)

retain_user_site (boolean)

No Description

retain_user_site (boolean)
Boolean value which can have two possible values. The values are true and false.

product_type (product_type)read only

Product type of the product

product_type (product_type)
Product type of the asset product

Example

{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

$ curl api/v3/assets
      -X GET 
      -H "Accept: application/vnd.manageengine.sdp.v3+json" 
      -H "Authorization: Zoho-Oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx" 
      -H "Content-Type: application/x-www-form-urlencoded"
{
  "assets": [
    {
      "loan": {
        "start_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "id": "1510894167438614",
        "returned_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "barcode": "test-barcode",
        "due_by_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "loan_id": {
          "display_value": "CH 44",
          "value": "44"
        }
      },
      "retain_user_site": false,
      "type": {
        "name": "Asset",
        "id": "2221589639239391"
      },
      "last_updated_by": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "1767056521034237",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "id": "1535924695172238",
      "purchase_cost": 1343434.4333,
      "state": {
        "name": "In Use",
        "description": "test-description",
        "id": "1880749423319170"
      },
      "barcode": "test-barcode",
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "product": {
        "part_no": "test-part_no",
        "name": "test-name",
        "id": "1976861984208771",
        "manufacturer": "test-manufacturer"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "mobile": "test-mobile",
        "id": "1621855055856191",
        "photo_url": "https://contacts.zoho.com/file?sample",
        "is_vip_user": false
      },
      "site": {
        "deleted": false,
        "name": "Custom Site",
        "id": "1812928581155277"
      },
      "product_type": {
        "image": "test-image",
        "name": "Workstation",
        "id": "1754602739373275"
      },
      "last_updated_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "name": "192.0.2.1",
      "location": "test-location",
      "is_loanable": false,
      "category": {
        "name": "IT",
        "description": "test-description",
        "id": "1817089573167815"
      },
      "state_history_comments": "test-state_history_comments"
    }
  ],
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}