Get Item Inventory

Tracking the inventory quantity of items in default warehouse.

Resource URL

This operation is designed for Neweggbusiness.com and Newegg.ca:

Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/contentmgmt/item/inventory?sellerid={sellerid}&version={version}
Newegg.ca: https://api.newegg.com/marketplace/can/contentmgmt/item/inventory?sellerid={sellerid}&version={version}

Note: Please make sure your request URL is all in lower case (except for Seller ID) and cannot contain any blank spaces or line breaks.

Parameters

Name Required? Description
sellerid Yes Your seller ID on Newegg Marketplace
version Yes Available version numbers: 304

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
POST Required XML, Json XML, Json 10,000 request per hour

Request Body

Attribute Required? Format Description
Condition No Integer Available values:

  • 1: New
  • 2: Refurbished
  • 3: Used – Like New
  • 4: Used – Very Good
  • 5: Used – Good
  • 6: Used – Acceptable

Note:

  • Only applies if type = [2-UPC code]. If type does not = [2-UPC code], then this column will be disregarded.
  • If left blank, default value will be New.
Type Yes Integer Available values:

  • 0: NE Item#
  • 1: Seller Part#
  • 2: UPC Code
Value Yes String A string according to the specified value of Type.

Schema: GetItemInventoryRequest.xsd

Example: XML, Request

POST https://api.newegg.com/marketplace/b2b/contentmgmt/item/inventory?sellerid={SellerID}&version=304
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<ContentQueryCriteria>
    <Type>1</Type>
    <Value>A006testitem201201021459</Value>
</ContentQueryCriteria>

Example: Json, Request

POST https://api.newegg.com/marketplace/b2b/contentmgmt/item/inventory?sellerid={SellerID}&version=304
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "Type": "1",
    "Value": "A006testitem201201021459"
}

 

Response Body

Attribute Format Description
SellerID String Your seller ID
ItemNumber String Newegg Item#
SellerPartNumber String Seller Part#
FulfillmentOption String Available values:

  • 0: ShipBySeller
  • 1: ShipByNewegg
  • 2: All
Active Integer
  • 0: Inactive
  • 1: Active
AvailableQuantity Integer Total available inventory
WarehouseCode String Currently available Newegg warehouse for SBN (Shipped By Newegg):
Available values Neweggbusiness.com:

  • 06: Tennessee Bulk Warehouse
  • 07: California Small Warehouse
  • 08: California Bulk Item Warehouse
  • 10: New Jersey Bulk Warehouse
  • 12: Tennessee Small Warehouse
  • 14: New Jersey Small Warehouse

Available values Newegg.ca:

  • 35: Canada Vancouver Small&Bulk Warehouse
  • 36: Canada Toronto Small&Bulk Warehouse

Note: This information will be returned for the SBN (Shipped by Newegg) item only.
Quantity Integer Current available inventory in this Newegg warehouse.
Note: This information will be returned only when the inventory is currently stored in Newegg’s warehouse.

Schema: GetItemInventoryResponse.xsd

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<InventoryResult>
    <SellerID>A006</SellerID>
    <ItemNumber>9SIA0060884598</ItemNumber>
    <SellerPartNumber>A006testitem201201021459</SellerPartNumber>
    <FulfillmentOption>1</FulfillmentOption >
    <Active>0</Active>
    <AvailableQuantity>50</AvailableQuantity>
    <WarehouseAllocation>
        <Warehouse>
            <WarehouseCode>35</WarehouseCode>
            <Quantity>3</Quantity>
        </Warehouse>
        <Warehouse>
            <WarehouseCode>36</WarehouseCode>
            <Quantity>37</Quantity>
        </Warehouse>
        <Warehouse>
            <WarehouseCode>SBS</WarehouseCode>
            <Quantity>10</Quantity>
        </Warehouse>
    </WarehouseAllocation>
</InventoryResult>

Example: Json, Response

{
    "Active": "0",
    "ItemNumber": "9SIA0060884598",
    "SellerID": "A006",
    "SellerPartNumber": "A006testitem201201021459",
    "FulfillmentOption": "1",
    "AvailableQuantity": 71,
    "WarehouseAllocation": {
        "Warehouse": [
            {
                "WarehouseCode": "35",
                "Quantity": "3"
            },
            {
                "WarehouseCode": "36",
                "Quantity": "37"
            }
        ]
    }
}

Request Failure Errors

For common HTTP error responses, please refer to Failed Response Error Code List.

Error Code Description
CT001 Invalid ItemNumber
CT002 Invalid SellerPartNumber
CT003 Invalid UPCCode
CT005 Invalid Action Type. We only support: 0 – NE Item#, 1 — Seller Parts#, 2 — UPC Code
CT010 Cannot find item with specified item condition.
CT026 No data found

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CT002</Code>
        <Message>Invalid SellerPartNumber</Message>
    </Error>
</Errors>

Example: Json, Response

[
    {
        "Code": "CT002",
        "Message": "Invalid SellerPartNumber"
    }
]

Last updated: October 15, 2018