/hardware

get https://develop.snipeitapp.com/api/v1/hardware

Return a listing of assets

time	status	user agent
Retrieving recent requests…

Loading…

Sortable Columns

Field Name	Description
`id`	Asset ids
`name`	Asset names
`asset_tag`	Asset unique asset tag
`serial`	Asset serial numbers
`model`	Name of the associated asset model
`model_number`	Model number of the associated asset model
`last_checkout`	Date the asset was last checked out
`category`	Name of the asset model's associated category
`manufacturer`	Name of the asset's manufacturer
`notes`	Asset notes
`expected_checkin`	Expected checkin date
`order_number`	Order number associated with the asset
`companyName`	Company name associated with the asset, if applicable
`location`	Name of the location of the asset, either the default Ready to Deploy location, or the assigned user's location
`image`	Name of the optional image file associated with the asset
`status_label`	Name of the status label associated with the asset
`assigned_to`	Name of the person the asset is assigned to
`created_at`	Date the asset was created
`purchase_date`	Date the asset was purchased
`purchase_cost`	Purchase cost of the asset

Query Params

limit

int32

Defaults to 2

Specify the number of results you wish to return. Defaults to 50, but we have it set to 2 by default so the API explorer doesn't scroll forever.

offset

int32

Defaults to 0

Offset to use

string

A text string to search the assets data for

order_number

string

Return only assets associated with a specific order number

sort

string

Defaults to created_at

Specify the column name you wish to sort by

order

string

Defaults to desc

Specify the order (asc or desc) you wish to order by on your sort column

model_id

int32

Optionally restrict asset results to this asset model ID

category_id

int32

Optionally restrict asset results to this status label ID

manufacturer_id

int32

Optionally restrict asset results to this asset model ID

company_id

int32

Optionally restrict asset results to this company ID

location_id

int32

Optionally restrict asset results to this location ID

status

string

Optionally restrict asset results to one of these status types: RTD, Deployed, Undeployable, Deleted, Archived, Requestable

status_id

int32

Optionally restrict asset results to this status label ID

Responses

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://develop.snipeitapp.com/api/v1/hardware?limit=2&offset=0&sort=created_at&order=desc' \
3
     --header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxIiwianRpIjoiZTU2MDc0MjVmYjM5YTEwYjFjNTZlZTAxMTBmZDk4ZjQ0ZjVjODMzYjcxZWVhYjZlNDk1NGMwOThlY2YzMzU2MDY4Mzg4MmFhMDMzOTAzNzciLCJpYXQiOjE2MzI4NjU5MTgsIm5iZiI6MTYzMjg2NTkxOCwiZXhwIjoyMjY0MDIxNTE4LCJzdWIiOiIxIiwic2NvcGVzIjpbXX0.LgGVzyH67IRhXvccHd4j2Dn6TDuIuQTBoo30_wD9jPehy8v_h0xBmE1-dOUBRJyeJOI8B4gwPeALsWaudpGj9Lb5qWAtKV7eYtH9IYQKoLF_iHgOGXnAUcNwID6zBU_YyLNSI6gp8zjutLJias33CBLsHy5ZRNpxVibVrZouJ_HjYuIYbtZyLus-KFFeibtZoPiTWOeHhQFD37MR6ifx4dBqT37fN-xDS99mONtrkAplEIou5aSO1oZ4IlJIPCUyA1lixPgpn1YU7PxiBDZp1teeugD0WEmrAqxRS2I0bH4qPsuTsrVXS_lo87Sf5LBGLW7lGHKqyYH6J47OZOM0K-SrxLKtE1ww8jyLBgnnxH0lJHRLCBiwUnL5ZGTUmiOysUA-wSJ6s78o8Pc-ec6bpBvAlelHdiQ-wslE7gzEJDptbejFg-75b_CEwgJYh7J2D18ul6Qu5EFCUEgt033mm04dgVk0isWTDt6EW5ZvTo5Qhr1LY0YnEIXCTqIRN-BSQjL55sZaCrtwR_21bnBGgniyI5MRDYblFawVmFKroeClCpSjBo9vi66akdD5hjpvx67RL3r33BZQhEXmPifUPNH5wP_U-IHGFUD99TJk2c1awF0RASveZRLSunbJb1x6hGAVUaIvQV4r2quWzXqYyKLph9kGTyJYrb6iJtH5smE' \
4
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Sortable Columns

200200

401401

405405