View source for Get Asset History By Serial Number

== Summary ==
{| border="1" class="wikitable"

! Asset History
! colspan="2" | 
|-
! URL
| colspan="2" |  http://:base_url/:api_path/:version/assets/asset/history?api_key=YOUR_KEY&serial_number=SERIAL_NUMBER
|-
! Type
| colspan="2" | GET
|-
! Params:
| api_key || required 
|-
! 
| serial_number || required
|-
! Response
| colspan="2" | JSON
|}

The Get Asset History method returns the asset history entries corresponding to the asset serial number specified.

== Response Parameters ==
{| border="1" class="wikitable"

! Field
! Description
|-
! asset
| The asset the history is associated with
|-
|-
! created_at
| Date asset was created
|-
! custom_fields
| Asset custom fields
|-
! customer
| Customer the asset is linked to
|-
! description
| Asset description
|-
|-
! external_id
| Asset external id
|-
! item
| Contains the name, category and external id of the item the asset is linked to
|-
! job
| Job the asset is linked to
|-
! last_scanned_by
| User who last scanned asset
|-
! last_updated_by
| User who last updated asset
|-
! location
| Asset location 
|-
|-
! photos
| Photos associated with the asset history 
|-
|-
! serial_number
| Asset serial number
|-
! status
| Contains both external id and status name for asset status
|-
|-
|}

== Example response ==
<source lang="java">
[ { "asset" : { "external_id" : "sss32",
        "serial_number" : "serialNo123"
      },
    "created_at" : 1375874083000,
    "custom_fields" : null,
    "customer" : { "name" : "john" },
    "description" : "describingwords",
    "external_id" : "sss32",
    "item" : { "category" : "Test Numero 1",
        "external_id" : null,
        "name" : "Woo"
      },
    "job" : { "job_ number" : "123" },
    "last_scanned_by" : null,
    "last_updated_by" : null,
    "location" : "aPlace2",
    "photos" : [ { "file_name" : "www.testFileName.com/test" },
        { "file_name" : "www.testFileName.com/test" }
      ],
    "serial_number" : "serialNo123",
    "status" : { "external_id" : null,
        "name" : "test"
      }
  },
  { "asset" : { "external_id" : "sss32",
        "serial_number" : "serialNo123"
      },
    "created_at" : 1375874146000,
    "custom_fields" : null,
    "customer" : { "name" : "john" },
    "description" : "describingwords",
    "external_id" : "sss32",
    "item" : { "category" : "Test Numero 1",
        "external_id" : null,
        "name" : "Woo"
      },
    "job" : { "job_ number" : "123" },
    "last_scanned_by" : null,
    "last_updated_by" : null,
    "location" : "aPlace2",
    "photos" : [ { "file_name" : "www.testFileName.com/test" } ],
    "serial_number" : "serialNo123",
    "status" : { "external_id" : null,
        "name" : "test"
      }
  }
]
</source>

== Example curl request ==

curl "http://live.mymobileworkers.com:8080/api/1/assets/asset/history/?api_key=darrenwebapi&serial_number=serialNo123"