View Asset by External ID

Overview
Retrieve an Asset's information of the client using externalID of the asset

URL Format
https://{domain}.mobiwork.com/api/rest/{clientId}/{versionNumber}/asset/{assetId}/view.html?token=XXXXXXXX&userId={userId}&externalId={externalId}

Arguments

clientId required	MobiWork assigned unique ID of the company
versionNumber required	Version number of MobiWork API SDK release. Current version is: 10.0.78
token required	Part of URL as a request parameter and is required in every call to verify access to API calls
externalId required	Specified in URL as a parameter, is the ExternalID of the asset to be retrieved
userId optional	If provided, this User ID will be taken as a logged in user

Return
Returns an Asset Object if valid arguments are provided. Returns an error if not a valid request

Request Body XSD
None

Response Body XSD

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
  <xs:element name="response">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="asset"/>
      </xs:sequence>
      <xs:attribute name="statusCode" use="required" type="xs:integer"/>
      <xs:attribute name="version" use="required" type="xs:NMTOKEN"/>
    </xs:complexType>
  </xs:element>
  <xs:element name="asset">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="mobiworkAssetId"/>
        <xs:element ref="externalId"/>
        <xs:element ref="name"/>
        <xs:element ref="description"/>
        <xs:element ref="modelNumber"/>
        <xs:element ref="serialNumber"/>
        <xs:element ref="manufacturer"/>
        <xs:element ref="tag"/>
        <xs:element ref="beacon"/>
        <xs:element ref="rfid"/>
        <xs:element ref="barcode"/>
        <xs:element ref="sku"/>
        <xs:element ref="categoryId"/>
        <xs:element ref="category"/>
        <xs:element ref="subCategoryId"/>
        <xs:element ref="subCategory"/>
        <xs:element ref="customFields"/>
        <xs:element ref="location"/>
        <xs:element ref="status"/>
        <xs:element ref="enabled"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="mobiworkAssetId" type="xs:integer"/>
  <xs:element name="externalId" type="xs:NCName"/>
  <xs:element name="description" type="xs:string"/>
  <xs:element name="modelNumber" type="xs:integer"/>
  <xs:element name="serialNumber" type="xs:NMTOKEN"/>
  <xs:element name="manufacturer" type="xs:NCName"/>
  <xs:element name="tag" type="xs:string"/>
  <xs:element name="beacon" type="xs:NCName"/>
  <xs:element name="rfid" type="xs:NCName"/>
  <xs:element name="barcode">
    <xs:complexType/>
  </xs:element>
  <xs:element name="sku" type="xs:string"/>
  <xs:element name="categoryId" type="xs:integer"/>
  <xs:element name="category" type="xs:NCName"/>
  <xs:element name="subCategoryId" type="xs:integer"/>
  <xs:element name="subCategory" type="xs:NCName"/>
  <xs:element name="customFields">
    <xs:complexType/>
  </xs:element>
  <xs:element name="location">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="addressId"/>
        <xs:element ref="address1"/>
        <xs:element ref="address2"/>
        <xs:element ref="city"/>
        <xs:element ref="state"/>
        <xs:element ref="zipCode"/>
        <xs:element ref="countryId"/>
        <xs:element ref="latitude"/>
        <xs:element ref="longitude"/>
        <xs:element ref="name"/>
        <xs:element ref="baseDistance"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="addressId" type="xs:integer"/>
  <xs:element name="address1" type="xs:string"/>
  <xs:element name="address2" type="xs:string"/>
  <xs:element name="city" type="xs:string"/>
  <xs:element name="state" type="xs:NCName"/>
  <xs:element name="zipCode">
    <xs:complexType/>
  </xs:element>
  <xs:element name="countryId" type="xs:integer"/>
  <xs:element name="latitude" type="xs:decimal"/>
  <xs:element name="longitude" type="xs:decimal"/>
  <xs:element name="baseDistance" type="xs:integer"/>
  <xs:element name="status" type="xs:NCName"/>
  <xs:element name="enabled" type="xs:boolean"/>
  <xs:element name="name" type="xs:string"/>
</xs:schema>

Curl Example

HTTP Method:	GET
Request:	curl -k -X GET "https://www.mobiwork.com/api/rest/12014/10.0.78/asset/54782/view.html?token=COJL8X2FKSLMMRTYCH2B&externalId=ext555"
Response:	<?xml encoding="UTF-8" ?> <response version="10.0.78" statusCode="1"> <asset> <mobiworkAssetId>54782</mobiworkAssetId> <externalId>ext555</externalId> <name>05D744969-Full Electric Bed</name> <description>Full Electric Bed Frame-Retro</description> <modelNumber>Semi Electric Bed 5310</modelNumber> <serialNumber>05D744969-FEB</serialNumber> <status>Active</status> <typeId>15</typeId> <type>Building</type> <categoryId>4855</categoryId> <category>Homecare Beds</category> <subCategoryId>27509</subCategoryId> <subCategory>test sub</subCategory> <customFieldList> <customField> <apiName>LicenseTag</apiName> <fieldType>1</fieldType> <value></value> <name>License Tag</name> </customField> <customField> <apiName>ServicedBy</apiName> <fieldType>6</fieldType> <value></value> <name>Serviced By</name> </customField> <customField> <apiName>OilFilterNumber</apiName> <fieldType>1</fieldType> <value></value> <name>Oil Filter Number</name> </customField> <customField> <apiName>valueofassets</apiName> <fieldType>1</fieldType> <value>2000</value> <name>Value of asset</name> </customField> <customField> <apiName>images</apiName> <fieldType>25</fieldType> <value></value> <name>Additional Images</name> </customField> </customFieldList> </asset> </response>