- Pages
- /
- Dealers
- /
- Data Depot
- /
- Version 4
- /
- API
- /
- Services
- /
- Items
- Downloads
- API Documentation
- Support
API News and Updates
Subscribe to stay alert on the API.
items
Items are the building blocks of a Product; they are simplest form of a Product and refer to one individual variant (specific configuration) or SKU of a Product.
For example:
The FLY Patrol Jersey is a Product, whereas the SKU:370-6402X 2X-Large Black/Grey FLY Patrol Jersey is an Item.
| Products | Items |
|---|---|
| FLY Patrol Jersey |
370-640S → Small → Black/Grey → FLY Patrol Jersey 370-640M → Medium → Black/Grey → FLY Patrol Jersey 370-640L → Large → Black/Grey → FLY Patrol Jersey 370-640X → X-Large → Black/Grey → FLY Patrol Jersey 370-6402X → 2X-Large → Black/Grey → FLY Patrol Jersey ... |
| FLY Trekker Helmet |
73-1010XS → X-Small → Gloss Black → Trekker Helmet 73-1010S → Small → Gloss Black → Trekker Helmet 73-1010M → Medium → Gloss Black → Trekker Helmet ...73-1014XS → X-Small → Hi-Vis Yellow → Trekker Helmet 73-1014S → Small → Hi-Vis Yellow → Trekker Helmet 73-1014M → Medium → Hi-Vis Yellow → Trekker Helmet ... |
Example requests
Collection
https://api.wps-inc.com/items
Entity
https://api.wps-inc.com/items/
...or send multiple ids separated by a comma(,)
https://api.wps-inc.com/items/216584,22864,72757,220510
Associated Attributevalues
https://api.wps-inc.com/items/216584/attributevalues
Associated Unit-of-measurements
https://api.wps-inc.com/items/216584/unit-of-measurements
Parent Country
https://api.wps-inc.com/items/216584/country
Associated Images
https://api.wps-inc.com/items/216584/images
Parent Product
https://api.wps-inc.com/items/216584/product
Associated Tags
https://api.wps-inc.com/items/216584/tags
Associated Taxonomyterms
https://api.wps-inc.com/items/216584/taxonomyterms
Associated Vehicles
https://api.wps-inc.com/items/216584/vehicles
Status Codes
DIR
DIRECT SHIP FROM VENDOR
DSC
DISCONTINUED ITEM
CLO
CLOSEOUT ITEM
NOT AVAILABLE AT THIS TIME
NEW
NEW ITEM
NLA
NO LONGER AVAILABLE
PRE
PRE -RELEASE ITEM (CONTACT REP TO ORDER)
SPEC
SPECIAL ORDER
STK
STANDARD STOCKING ITEM
Item Inventory
Pro Tip: Get inventory levels for an Item in one request
As you've probably discovered, there are many ways of getting inventory for a particular Item. But, to reduce the number of requests needed, it may be helpful to use includes.
https://api.wps-inc.com/items?filter[sku]=72-7044L&include=inventory
...or even better would be target the exact Item by using a crutch...
https://api.wps-inc.com/items/crutch/72-7044L?include=inventory
This will give you an specific entity response instead of a collection with one result.
