Retrieve warranty details of a computer

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Returns the warranty information of a computer identified by resource ID, resource name, or domain name. Includes shipping date, expiry date, and warranty status.

Request URL

https://{server-hostname}:8383/dcapi/inventory/computers/warrantyDetails

Scope

Inventory.READCopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/warrantyDetails.v1+jsonapplication/warrantyDetails.v1+jsonCopied!

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomain/dcapi/inventory/computers/warrantyDetails \
  --header 'Accept: application/warrantyDetails.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
epochShippingDatestring

Shipping date as epoch timestamp in milliseconds

epochWarrantyExpiryDatestring

Warranty expiry date as epoch timestamp in milliseconds

computerAgestring

Age of the computer in years

daysToWarrantyExpirystring

Number of days until warranty expires (negative if already expired)

warrantyExpiryDatestring

Warranty expiry date in human-readable format

shippingDatestring

Shipping date in human-readable format

- HTTP code 401

Response Body - application/json
JSON Object
Hide Sub-Attributes
error_codestring

UAC_UNAUTHORIZED - user lacks the required uem-roles or credentials are missing

error_descriptionstring

Authentication or authorization failure reason

- HTTP code 500

Response Body - application/json
JSON Object
Hide Sub-Attributes
error_codestring

INTERNAL_ERROR - unexpected exception in the service layer

error_descriptionstring

Internal server error message

Possible Response Codes

200HTTP code
401HTTP code
500HTTP code

Sample Response: HTTP 200

Warranty details of a computer

Copied!
  {
    "daysToWarrantyExpiry": "-580",
    "shippingDate": "Oct 10, 2019",
    "warrantyExpiryDate": "Oct 11, 2024",
    "epochShippingDate": "1570714200000",
    "epochWarrantyExpiryDate": "1728653399000",
    "computerAge": "6"
  }
                
Show full

Sample Response: HTTP 401

Missing credentials

Copied!
  {
    "error_description": "Unauthorized access",
    "error_code": "UAC_UNAUTHORIZED"
  }
                
Show full

Sample Response: HTTP 500

Server error

Copied!
  {
    "error_description": "Internal server error",
    "error_code": "INTERNAL_ERROR"
  }
                
Show full

Duration: 1 minute | Threshold: 60 | Lock period: 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.