API Documentation

    Inventory ItemsList & Search Inventory Items

    Method: /items.[format]

    Note: The modifiedSince parameter is used for retrieving only the inventory item’s data that has been modified since a specific point in time. This is based on the value of the “modified” field and is useful for doing faster, more efficient syncing. The modifiedSince value must be provided in unix timestamp number format (unix epoch, i.e. 1470429617).

    The pageLimit parameter will accept any numeric digit between 1 and 100 which defines how many results you get in each resultset (defaults to 20 per page).

    Parameters: (optional)
    Param Name:Description:
    pageWhich page to retrieve from paginated results (numeric)
    pageLimitHow many records per result set (numeric between 1 – 100)
    categoryIdFilter items by categoryId (36 char string)
    locationIdFilter items by locationId (36 char string)
    itemIdNumberGet data for specific item by itemIdNumber (numeric)
    orderFieldSort result set by specific field
    orderDirectionSort result set “asc” or “desc”
    modifiedSinceReturn anything modified since timestamp (epoch timestamp)
    sSearch parameter
    fieldSearch a specific data field (name, sku, serial_number, item_number, barcode)
    exactOnly return exact matches in your search results (true or blank)
    compactReduces returned results’ object nested depth (true or blank)
    Syntax:
    https://[subdomain].salesbinder.com/api/2.0/items.json?page=[number]&categoryId=[category_id]&locationId=[location_id]&modifiedSince=[unix_timestamp]&pageLimit[int]
    HTTP Request Type: GET
    Sample Returned JSON Data
    1{  
    2   "count":"2",
    3   "page":"1",
    4   "pages":"1",
    5   "items":[  
    6      [  
    7         {  
    8            "name":"Motivate Pant",
    9            "quantity":42,
    10            "threshold":4,
    11            "cost":80,
    12            "price":98,
    13            "description":"",
    14            "sku":"",
    15            "serial_number":"",
    16            "item_number":507,
    17            "barcode":"",
    18            "published":true,
    19            "id":"54d7e076-96fc-4937-9eb8-0db0a2d10228",
    20            "category_id":"54f60687-c5fc-4182-bd7d-0dd26882ca98",
    21            "location_id":null,
    22            "modified":"2016-10-06T17:16:23+00:00",
    23            "created":"2015-02-08T22:17:26+00:00",
    24            "unit_of_measure":{  
    25               "id":"4dd3e070-5c03-11e1-b47b-4040248327e7",
    26               "full_name":"Items",
    27               "short_name":"item(s)"
    28            },
    29            "item_details":[  
    30               {  
    31                  "value":"Blue",
    32                  "id":"54d7e076-b188-4212-b739-0db0a2d10228",
    33                  "item_id":"54d7e076-96fc-4937-9eb8-0db0a2d10228",
    34                  "custom_field_id":"54f60687-ff18-4874-9dcc-0dd26882ca98",
    35                  "custom_field":{  
    36                     "name":"Colour",
    37                     "publish":true
    38                  }
    39               },
    40               {  
    41                  "value":"Small",
    42                  "id":"54d7e076-d0bc-469e-97ec-0db0a2d10228",
    43                  "item_id":"54d7e076-96fc-4937-9eb8-0db0a2d10228",
    44                  "custom_field_id":"54f60687-7e54-4442-ba20-0dd26882ca98",
    45                  "custom_field":{  
    46                     "name":"Size",
    47                     "publish":true
    48                  }
    49               }
    50            ],
    51            "location":null,
    52            "images":[  
    53               {  
    54                  "id":"54d7e071-e96c-47a5-91a8-0d72a2d10228",
    55                  "filename":"54d7e071-8e8c-43c1-98c3-0d72a2d10228.png",
    56                  "weight":null,
    57                  "url_small":"https://..truncated../98c3-0d72a2d10228_75x100.png",
    58                  "url_medium":"https://..truncated../98c3-0d72a2d10228_400x500.png",
    59                  "url_original":"https://..truncated../98c3-0d72a2d10228.png"
    60               }
    61            ]
    62         },
    63         {  
    64            "name":"Essence Tank",
    65            "quantity":0,
    66            "threshold":0,
    67            "cost":40,
    68            "price":52,
    69            "description":"",
    70            "sku":"",
    71            "serial_number":"",
    72            "item_number":506,
    73            "barcode":"",
    74            "published":true,
    75            "id":"54d7e004-ae34-4f50-ba90-0db0a2d10228",
    76            "category_id":"54f60687-c5fc-4182-bd7d-0dd26882ca98",
    77            "location_id":null,
    78            "modified":"2015-10-23T20:27:18+00:00",
    79            "created":"2015-02-08T22:15:32+00:00",
    80            "unit_of_measure":{  
    81               "id":"4dd3e070-5c03-11e1-b47b-4040248327e7",
    82               "full_name":"Items",
    83               "short_name":"item(s)"
    84            },
    85            "item_details":[  
    86               {  
    87                  "value":"Medium",
    88                  "id":"54d7e004-cb4c-4a8b-8f6d-0db0a2d10228",
    89                  "item_id":"54d7e004-ae34-4f50-ba90-0db0a2d10228",
    90                  "custom_field_id":"54f60687-7e54-4442-ba20-0dd26882ca98",
    91                  "custom_field":{  
    92                     "name":"Size",
    93                     "publish":true
    94                  }
    95               },
    96               {  
    97                  "value":"Black",
    98                  "id":"54d7e004-dd98-4b50-933f-0db0a2d10228",
    99                  "item_id":"54d7e004-ae34-4f50-ba90-0db0a2d10228",
    100                  "custom_field_id":"54f60687-ff18-4874-9dcc-0dd26882ca98",
    101                  "custom_field":{  
    102                     "name":"Colour",
    103                     "publish":true
    104                  }
    105               }
    106            ],
    107            "location":null,
    108            "images":[  
    109               {  
    110                  "id":"54d7e001-bcb4-46d9-8fc5-0d72a2d10228",
    111                  "filename":"54d7e001-3a60-469c-9859-0d72a2d10228.png",
    112                  "weight":null,
    113                  "url_small":"https://..truncated../0d72a2d10228_75x100.png",
    114                  "url_medium":"https://..truncated../0d72a2d10228_400x500.png",
    115                  "url_original":"https://..truncated../0d72a2d10228.png"
    116               }
    117            ]
    118         }
    119      ]
    120   ]
    121}
    Sample Returned XML Data
    1<response>
    2    <item>
    3        <name>Motivate Pant</name>
    4        <quantity>42</quantity>
    5        <threshold>4</threshold>
    6        <cost>80</cost>
    7        <price>98</price>
    8        <description/>
    9        <sku/>
    10        <serial_number/>
    11        <item_number>507</item_number>
    12        <barcode/>
    13        <published>1</published>
    14        <id>54d7e076-96fc-4937-9eb8-0db0a2d10228</id>
    15        <category_id>54f60687-c5fc-4182-bd7d-0dd26882ca98</category_id>
    16        <location_id/>
    17        <modified>10/6/16, 5:16 PM</modified>
    18        <created>2/8/15, 10:17 PM</created>
    19        <unit_of_measure>
    20            <id>4dd3e070-5c03-11e1-b47b-4040248327e7</id>
    21            <full_name>Items</full_name>
    22            <short_name>item(s)</short_name>
    23        </unit_of_measure>
    24        <item_details>
    25            <value/>
    26            <id>54d7e076-b188-4212-b739-0db0a2d10228</id>
    27            <item_id>54d7e076-96fc-4937-9eb8-0db0a2d10228</item_id>
    28            <custom_field_id>54f60687-ff18-4874-9dcc-0dd26882ca98</custom_field_id>
    29            <custom_field>
    30                <name>Colour</name>
    31                <publish>1</publish>
    32            </custom_field>
    33        </item_details>
    34        <item_details>
    35            <value/>
    36            <id>54d7e076-d0bc-469e-97ec-0db0a2d10228</id>
    37            <item_id>54d7e076-96fc-4937-9eb8-0db0a2d10228</item_id>
    38            <custom_field_id>54f60687-7e54-4442-ba20-0dd26882ca98</custom_field_id>
    39            <custom_field>
    40                <name>Size</name>
    41                <publish>1</publish>
    42            </custom_field>
    43        </item_details>
    44        <location/>
    45        <images>
    46            <id>54d7e071-e96c-47a5-91a8-0d72a2d10228</id>
    47            <filename>54d7e071-8e8c-43c1-98c3-0d72a2d10228.png</filename>
    48            <weight/>
    49            <url_small>https://..truncated../0d72a2d10228_75x100.png</url_small>
    50            <url_medium>https://..truncated../0d72a2d10228_400x500.png</url_medium>
    51            <url_original>https://..truncated../0d72a2d10228.png</url_original>
    52        </images>
    53    </item>
    54    <item>
    55        <name>Essence Tank</name>
    56        <quantity>0</quantity>
    57        <threshold>0</threshold>
    58        <cost>40</cost>
    59        <price>52</price>
    60        <description/>
    61        <sku/>
    62        <serial_number/>
    63        <item_number>506</item_number>
    64        <barcode/>
    65        <published>1</published>
    66        <id>54d7e004-ae34-4f50-ba90-0db0a2d10228</id>
    67        <category_id>54f60687-c5fc-4182-bd7d-0dd26882ca98</category_id>
    68        <location_id/>
    69        <modified>10/23/15, 8:27 PM</modified>
    70        <created>2/8/15, 10:15 PM</created>
    71        <unit_of_measure>
    72            <id>4dd3e070-5c03-11e1-b47b-4040248327e7</id>
    73            <full_name>Items</full_name>
    74            <short_name>item(s)</short_name>
    75        </unit_of_measure>
    76        <item_details>
    77            <value/>
    78            <id>54d7e004-cb4c-4a8b-8f6d-0db0a2d10228</id>
    79            <item_id>54d7e004-ae34-4f50-ba90-0db0a2d10228</item_id>
    80            <custom_field_id>54f60687-7e54-4442-ba20-0dd26882ca98</custom_field_id>
    81            <custom_field>
    82                <name>Size</name>
    83                <publish>1</publish>
    84            </custom_field>
    85        </item_details>
    86        <item_details>
    87            <value/>
    88            <id>54d7e004-dd98-4b50-933f-0db0a2d10228</id>
    89            <item_id>54d7e004-ae34-4f50-ba90-0db0a2d10228</item_id>
    90            <custom_field_id>54f60687-ff18-4874-9dcc-0dd26882ca98</custom_field_id>
    91            <custom_field>
    92                <name>Colour</name>
    93                <publish>1</publish>
    94            </custom_field>
    95        </item_details>
    96        <location/>
    97        <images>
    98            <id>54d7e001-bcb4-46d9-8fc5-0d72a2d10228</id>
    99            <filename>54d7e001-3a60-469c-9859-0d72a2d10228.png</filename>
    100            <weight/>
    101            <url_small>https://..truncated../0d72a2d10228_75x100.png</url_small>
    102            <url_medium>https://..truncated../0d72a2d10228_400x500.png</url_medium>
    103            <url_original>https://..truncated../0d72a2d10228.png</url_original>
    104        </images>
    105    </item>
    106</response>

    Updated on February 8th, 2022

    Network Status:
    100% Global Availability