Get Order Information

Submit a request to get the orders from the account.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/ordermgmt/order/orderinfo?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
305
306
307
309

Resource Information

HTTP Method	Authentication?	Request Formats	Response Formats	Rate Limited?
PUT	Required	XML, Json	XML, Json	1000 request per hour

Request Body

Attribute	Required?	Format	Description
IssueUser	No	String	Specify your eligible seller account (email address) here.
OperationType	Yes	String	Fixed value: GetOrderInfoRequest
PageIndex	No	Integer	Current page index If left blank, will use 1 as default.
PageSize	No	Integer	Return records count in one page. (Max is 100 per page)If left blank, will use 100 as default.
OrderNumber	No	Integer	Newegg order number Ignores other search conditions (request criteria) if order number specified this field.
SellerOrderNumber	No	String	The seller order number This is available for sellers using SBN (Shipped by Newegg) to fulfill multichannel orders. If not specify Newegg order number in field “OrderNumber”, ignores other search conditions (request criteria) and only apply the query result on seller order numbers specified in this field. Available version: 307
Status	No	Integer	Available values: 0: Unshipped 1: Partially Shipped 2: Shipped 3: Invoiced 4: Voided If left blank, will return orders in all order status
OrderDownloaded	No	Integer	Available values: 0: False (Default): include downloaded orders 1: True: do not include downloaded orders
Type	No	Integer	Available values: 0: All (Default) 1: SBN (Shipped by Newegg) 2: SBS (Shipped by Seller) 3: Multi-Channel
VoidSoon	No	Integer	The order will be auto voided after 24 or 48 hours. Available values: 24 48
OrderDateFrom	No	String	Order Date From (Pacific Standard Time) Please refer to the Acceptable Date Format
OrderDateTo	No	String	Order Date To (Pacific Standard Time) Please refer to the Acceptable Date Format
CountryCode	No	String	The country for your orders. Only the ISO standard 3-digit codes are accepted. To review the complete list of available values, please download the following: International Country Guide
PremierOrder	No	String	Available values: 0: All (Default) 1: Premier Order Only 2: No Premier Order

Schema: GetOrderInfoRequest.xsd

Example: XML, Request

PUT https://api.newegg.com/marketplace/ordermgmt/order/orderinfo?sellerid={sellerid}&version={version}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest>
    <OperationType>GetOrderInfoRequest</OperationType>
    <RequestBody>
        <PageIndex>1</PageIndex>
        <PageSize>10</PageSize>
        <RequestCriteria>
            <OrderNumberList>
                <OrderNumber>159243598</OrderNumber>
                <OrderNumber>41473642</OrderNumber>
            </OrderNumberList>
            <SellerOrderNumberList>
                <SellerOrderNumber>SO159243598</SellerOrderNumber>
                <SellerOrderNumber>SO41473642</SellerOrderNumber>
            </SellerOrderNumberList>
            <Status>1</Status>
            <Type>1</Type>
            <OrderDateFrom>2011-01-01 09:30:47</OrderDateFrom>
            <OrderDateTo>2011-12-17 09:30:47</OrderDateTo>
            <OrderDownloaded>0</OrderDownloaded>
            <CountryCode>USA</CountryCode>
            <PremierOrder>1</PremierOrder>
        </RequestCriteria>
    </RequestBody>
</NeweggAPIRequest>

Example: Json, Request

PUT https://api.newegg.com/marketplace/ordermgmt/order/orderinfo?sellerid={sellerid}&version={version}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "GetOrderInfoRequest",
    "RequestBody": {
        "PageIndex": "1",
        "PageSize": "10",
        "RequestCriteria": {
            "OrderNumberList": {
                "OrderNumber": [
                    "159243598",
                    "41473642"
                ]
            },
            "SellerOrderNumberList": {
                "SellerOrderNumber": [
                    "SO159243598",
                    "SO41473642"
                ]
            },
            "Status": "1",
            "Type": "1",
            "OrderDateFrom": "2011-01-01 09:30:47",
            "OrderDateTo": "2011-12-17 09:30:47",
            "OrderDownloaded": 0,
            "CountryCode": "USA",
            "PremierOrder": "1"
        }
    }
}

Response Body

Attribute	Format	Description
IsSuccess	String	Used to identify the operation of Get Order Info is successful True or False.
SellerID	String	Your seller ID
OperationType	String	Fixed value: GetOrderInfoResponse
TotalCount	Integer	Total number of records
TotalPageCount	Integer	Total page count
PageSize	Integer	How many records in a page
PageIndex	Integer	Current page index
SellerID	String	Seller ID
OrderNumber	Integer	Newegg Order number
SellerOrderNumber	String	Order number, assigned by seller. This is available for sellers using SBN (Shipped by Newegg) to fulfill multi-channel orders. Available version: 307
InvoiceNumber	Integer	The Invoice Number
OrderDownloaded	String	False: Order has not been downloaded yet. True: Order downloaded already.When order is shipped, this field will automatically become “True”.
OrderDate	String	Create date
OrderStatus	Integer	The Order Status: 0: Unshipped 1: Partially Shipped 2: Shipped 3: Invoiced 4: Voided
OrderStatusDescription	String	The Order Status Description Unshipped for order status code: 0 Partially Shipped for order status code: 1 Shipped for order status code: 2 Invoiced for order status code: 3 Voided for order status code: 4
CustomerName	String	Customer name
CustomerPhoneNumber	String	Phone number of customer
CustomerEmailAddress	String	The masked customer email address, you can reach to the customer through this email address. For example: gdv6l0viwo4l7j1d@marketplace.newegg.com
ShipToAddress1	String	Shipped to address of customer
ShipToAddress2	String	Shipped to address line 2 of customer
ShipToCityName	String	Shipped to city name
ShipToStateCode	String	Shipped to state
ShipToZipCode	String	Shipped to zip code
ShipToCountryCode	String	Shipped to country, i.e. United Kingdom
ShipService	String	The order’s shipping service: Shipped By Newegg APO/FPO – Military ONLY Super Saver(7-14 business days) Standard Shipping (5-7 business days) Expedited Shipping (3-5 business days) Two-Day Shipping(2 business days) One-Day Shipping(Next day) International Expedited Shipping(3-5 business days) International Two-Day Shipping(2 business days) International Economy Shipping(8-15 business days) International Standard Shipping(5-7 business days) Newegg Premier 3 Days Newegg Premier 2 Days Newegg Premier Next Day Note: That the following shipping services are for indicating Newegg Premier orders, you should ship the order as soon as the service required. Please contact datafeeds@newegg.com for more detail regarding Premier Seller Enrollment Program.
ShipToFirstName	String	Ship to first name
ShipToLastName	String	Ship to last name
ShipToCompany	String	Ship to company
OrderItemAmount	Decimal	Order’s item(s) total amount Note: All amounts are set in U.S. Dollars (USD).
ShippingAmount	Decimal	Order’s shipping Amount Note: All amounts are set in U.S. Dollars (USD).
DiscountAmount	Decimal	Order’s total discount amount Note: All amounts are set in U.S. Dollars (USD).
OrderQty	integer	Order’s total item quantity
RefundAmount	Decimal	The order’s refund amount Note: All amounts are set in U.S. Dollars (USD).
SalesTax	Decimal	Order’s sales tax Note: All amounts are set in U.S. Dollars (USD). Available version: 305, 306
VATTotal	Decimal	International Value Additional Tax Total Note: All amounts are set in U.S. Dollars (USD). Available version: 306
DutyTotal	Decimal	International Duty Total Note: All amounts are set in U.S. Dollars (USD). Available version: 306
RecyclingFeeAmount	Decimal	A Recycling Fee is a fee imposed by the government on new purchases of electronic products, batteries, new tires, etc. The fees are used to pay for the future recycling of these products, as many contain hazardous materials. The following recycling fees will be added to Recycling Fee Total: E-Waste Recycling Fee, Battery Recycling Fee, Tire Recycling Fee, Eco Fee. Available version: 309
OrderTotalAmount	Decimal	Order’s total amount Note: All amounts are set in U.S. Dollars (USD).
IsAutoVoid	String	If an order was auto voided by Newegg system, then the value is true. Otherwise, value is false.
SalesChannel	Integer	Order sales channel: 0: Newegg order 1: Multi-channel order 2: Replacement order
FulfillmentOption	integer	Order fulfillment option: 0: Ship by seller 1: Ship by Newegg
SellerPartNumber	String	Seller part number of item
NeweggItemNumber	String	Newegg number of item
MfrPartNumber	String	Manufacture part number of item
UPCCode	String	UPC code of item
Description	String	Web short title of item
OrderedQty	Integer	Ordered quantity of item
ShippedQty	integer	Shipped quantity of item
UnitPrice	Decimal	The final price per unit of the item appearing in customer’s shopping cart. Note: All amounts are set in U.S. Dollars (USD).
ExtendUnitPrice	Decimal	Item’s total charge (Item Unit Price x Quantity Ordered) Note: All amounts are set in U.S. Dollars (USD).
ExtendShippingCharge	Decimal	Item’s total shipping charge (Item Unit Shipping Price x Quantity Ordered) Note: All amounts are set in U.S. Dollars (USD).
ExtendSalesTax	Decimal	Item’s total sales tax charge NOTE: All amounts are set in U.S. Dollars (USD). Available version: 305, 306
ExtendVAT	Decimal	Item’s total Value Additional Tax charge Note: All amounts are set in U.S. Dollars (USD). Available version: 306
ExtendDuty	Decimal	Item’s total Duty charge NOTE: All amounts are set in U.S. Dollars (USD). Available version: 306
Status	Integer	Available values: 1: Unshipped 2: Shipped 3: Cancelled
StatusDescription	String	Available values: Unshipped for status code: 1 Shipped for status code: 2 Cancelled for status code: 3
PackageType	String	The package type: Shipped Unshipped
ShipCarrier	String	Package’s actual ship Carrier
ShipService	String	Package’s actual ship Service
TrackingNumber	String	Package’s tracking number
ShipDate	String	Package’s ship date (Pacific Standard Time)
SellerPartNumber	String	Seller part number of item
MfrPartNumber	String	Manufacture part number of item
ShippedQty	String	Shipped quantity of item
Memo	String	Other information
ResponseDate	String	Response date (Pacific Standard Time)

Schema: GetOrderInfoResponse.xsd

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <SellerID>A006</SellerID>
    <OperationType>GetOrderInfoResponse</OperationType>
    <ResponseBody>
        <PageInfo>
            <TotalCount>2</TotalCount>
            <TotalPageCount>1</TotalPageCount>
            <PageSize>10</PageSize>
            <PageIndex>1</PageIndex>
        </PageInfo>
        <OrderInfoList>
            <OrderInfo>
                <SellerID>A006</SellerID>
                <OrderNumber>41473642</OrderNumber>
                <SellerOrderNumber>2153930</SellerOrderNumber>
                <InvoiceNumber>0</InvoiceNumber>
                <OrderDownloaded>true</OrderDownloaded>
                <OrderDate>1/23/2012 7:33:05</OrderDate>
                <OrderStatus>4</OrderStatus>
                <OrderStatusDescription>Voided</OrderStatusDescription>
                <CustomerName>WY SD</CustomerName>
                <CustomerPhoneNumber>123-223-3223</CustomerPhoneNumber>
                <CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
                <ShipToAddress1>149 Kenwood Dr</ShipToAddress1>
                <ShipToAddress2 />
                <ShipToCityName>Newcastle</ShipToCityName>
                <ShipToStateCode>WY</ShipToStateCode>
                <ShipToZipCode>82701</ShipToZipCode>
                <ShipToCountryCode>UNITED STATES</ShipToCountryCode>
                <ShipService>Media Mail (7-14 business days)</ShipService>
                <ShipToFirstName>WY</ShipToFirstName>
                <ShipToLastName>SD</ShipToLastName>
                <ShipToCompany />
                <OrderItemAmount>0</OrderItemAmount>
                <ShippingAmount>0.00</ShippingAmount>
                <DiscountAmount>0.00</DiscountAmount>
                <RefundAmount>0</RefundAmount>
                <SalesTax />
                <VATTotal />
                <DutyTotal />
                <RecyclingFeeAmount />
                <OrderTotalAmount>0.00</OrderTotalAmount>
                <OrderQty>1</OrderQty>
                <IsAutoVoid>true</IsAutoVoid>
                <SalesChannel>0</SalesChannel>
                <FulfillmentOption>1</FulfillmentOption>
                <ItemInfoList>
                    <ItemInfo>
                        <SellerPartNumber>A00655467241</SellerPartNumber>
                        <NeweggItemNumber>9SIA0060823129</NeweggItemNumber>
                        <MfrPartNumber>55467241</MfrPartNumber>
                        <UPCCode />
                        <Description>test creation test item</Description>
                        <OrderedQty>1</OrderedQty>
                        <ShippedQty>0</ShippedQty>
                        <UnitPrice>1.00</UnitPrice>
                        <ExtendUnitPrice>1.03</ExtendUnitPrice>
                        <ExtendShippingCharge>1.03</ExtendShippingCharge>
                        <ExtendSalesTax />
                        <ExtendVAT />
                        <ExtendDuty />
                        <Status>3</Status>
                        <StatusDescription>Canceled</StatusDescription>
                    </ItemInfo>
                </ItemInfoList>
                <PackageInfoList />
            </OrderInfo>
            <OrderInfo>
                <SellerID>A006</SellerID>
                <OrderNumber>159243598</OrderNumber>
                <SellerOrderNumber>2153930</SellerOrderNumber>
                <InvoiceNumber>82961992</InvoiceNumber>
                <OrderDownloaded>true</OrderDownloaded>
                <OrderDate>1/18/2012 1:05:18</OrderDate>
                <OrderStatus>3</OrderStatus>
                <OrderStatusDescription>Invoiced</OrderStatusDescription>
                <CustomerName>WY SD</CustomerName>
                <CustomerPhoneNumber>123-223-3223</CustomerPhoneNumber>
                <CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
                <ShipToAddress1>149 Kenwood Dr</ShipToAddress1>
                <ShipToAddress2 />
                <ShipToCityName>Newcastle</ShipToCityName>
                <ShipToStateCode>WY</ShipToStateCode>
                <ShipToZipCode>82701</ShipToZipCode>
                <ShipToCountryCode>UNITED STATES</ShipToCountryCode>
                <ShipService>Media Mail (7-14 business days)</ShipService>
                <ShipToFirstName>WY</ShipToFirstName>
                <ShipToLastName>SD</ShipToLastName>
                <ShipToCompany />
                <OrderItemAmount>2.00</OrderItemAmount>
                <ShippingAmount>10.00</ShippingAmount>
                <DiscountAmount>1.00</DiscountAmount>
                <RefundAmount>0</RefundAmount>
                <SalesTax />
                <VATTotal />
                <DutyTotal />
                <RecyclingFeeAmount />
                <OrderTotalAmount>11.00</OrderTotalAmount>
                <OrderQty>2</OrderQty>
                <IsAutoVoid>false</IsAutoVoid>
                <SalesChannel>0</SalesChannel>
                <FulfillmentOption>1</FulfillmentOption>
                <ItemInfoList>
                    <ItemInfo>
                        <SellerPartNumber>A006ZX-35833</SellerPartNumber>
                        <NeweggItemNumber>9SIA0060845543</NeweggItemNumber>
                        <MfrPartNumber>ZX-35833</MfrPartNumber>
                        <UPCCode>431573000287</UPCCode>
                        <Description>GYRO Huge Metal Goliath 3.5CH Electric RTF RC Helicopter</Description>
                        <OrderedQty>2</OrderedQty>
                        <ShippedQty>2</ShippedQty>
                        <UnitPrice>1.00</UnitPrice>
                        <Status>2</Status>
                        <StatusDescription>Shipped</StatusDescription>
                        <ExtendUnitPrice>1.03</ExtendUnitPrice>
                        <ExtendShippingCharge>1.03</ExtendShippingCharge>
                        <ExtendSalesTax />
                        <ExtendVAT />
                        <ExtendDuty />
                    </ItemInfo>
                </ItemInfoList>
                <PackageInfoList>
                    <PackageInfo>
                        <PackageType>Shipped</PackageType>
                        <ShipCarrier>UPS</ShipCarrier>
                        <ShipService>342</ShipService>
                        <TrackingNumber>2342424</TrackingNumber>
                        <ShipDate>1/18/2012 16:59:15</ShipDate>
                        <ItemInfoList>
                            <ItemInfo>
                                <SellerPartNumber>A006ZX-35833</SellerPartNumber>
                                <MfrPartNumber>ZX-35833</MfrPartNumber>
                                <ShippedQty>2</ShippedQty>
                            </ItemInfo>
                        </ItemInfoList>
                    </PackageInfo>
                </PackageInfoList>
            </OrderInfo>
        </OrderInfoList>
    </ResponseBody>
    <Memo />
    <ResponseDate>2/22/2012 16:51:03</ResponseDate>
</NeweggAPIResponse>

Example: Json, Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "SellerID": "A006",
        "OperationType": "GetOrderInfoResponse",
        "ResponseBody": {
            "PageInfo": {
                "TotalCount": "2",
                "TotalPageCount": "1",
                "PageSize": "10",
                "PageIndex": "1"
            },
            "OrderInfoList": {
                "OrderInfo": [
                    {
                        "SellerID": "A006",
                        "OrderNumber": "41473642",
                        "SellerOrderNumber": "2153930",
                        "InvoiceNumber": "0",
                        "OrderDownloaded": "true",
                        "OrderDate": "1/23/2012 7:33:05",
                        "OrderStatus": "4",
                        "OrderStatusDescription": "Voided",
                        "CustomerName": "WY SD",
                        "CustomerPhoneNumber": "123-223-3223",
                        "CustomerEmailAddress": "gdv6l0viwo4l7j1d@marketplace.newegg.com",
                        "ShipToAddress1": "149 Kenwood Dr",
                        "ShipToAddress2": "",
                        "ShipToCityName": "Newcastle",
                        "ShipToStateCode": "WY",
                        "ShipToZipCode": "82701",
                        "ShipToCountryCode": "UNITED STATES",
                        "ShipService": "Media Mail (7-14 business days)",
                        "ShipToFirstName": "WY",
                        "ShipToLastName": "SD",
                        "ShipToCompany": "",
                        "OrderItemAmount": "0",
                        "ShippingAmount": "0.00",
                        "DiscountAmount": "0.00",
                        "RefundAmount": "0",
                        "SalesTax": "",
                        "VATTotal": "",
                        "DutyTotal": "",
                        "RecyclingFeeAmount": "",
                        "OrderTotalAmount": "0.00",
                        "OrderQty": "1",
                        "IsAutoVoid": "true",
                        "SalesChannel": "0",
                        "FulfillmentOption": "1",
                        "ItemInfoList": {
                            "ItemInfo": {
                                "SellerPartNumber": "A00655467241",
                                "NeweggItemNumber": "9SIA0060823129",
                                "MfrPartNumber": "55467241",
                                "UPCCode": "",
                                "Description": "test creation test item",
                                "OrderedQty": "1",
                                "ShippedQty": "0",
                                "UnitPrice": "1.00",
                                "ExtendUnitPrice": "1.03",
                                "ExtendShippingCharge": "1.03",
                                "ExtendSalesTax": "",
                                "ExtendVAT": "",
                                "ExtendDuty": "",
                                "Status": "3",
                                "StatusDescription": "Canceled"
                            }
                        }
                    },
                    {
                        "SellerID": "A006",
                        "OrderNumber": "159243598",
                        "SellerOrderNumber": "2153930",
                        "InvoiceNumber": "82961992",
                        "OrderDownloaded": "true",
                        "OrderDate": "1/18/2012 1:05:18",
                        "OrderStatus": "3",
                        "OrderStatusDescription": "Invoiced",
                        "CustomerName": "WY SD",
                        "CustomerPhoneNumber": "123-223-3223",
                        "CustomerEmailAddress": "gdv6l0viwo4l7j1d@marketplace.newegg.com",
                        "ShipToAddress1": "149 Kenwood Dr",
                        "ShipToAddress2": "",
                        "ShipToCityName": "Newcastle",
                        "ShipToStateCode": "WY",
                        "ShipToZipCode": "82701",
                        "ShipToCountryCode": "UNITED STATES",
                        "ShipService": "Media Mail (7-14 business days)",
                        "ShipToFirstName": "WY",
                        "ShipToLastName": "SD",
                        "ShipToCompany": "",
                        "OrderItemAmount": "2.00",
                        "ShippingAmount": "10.00",
                        "DiscountAmount": "1.00",
                        "RefundAmount": "0",
                        "SalesTax": "",
                        "VATTotal": "",
                        "DutyTotal": "",
                        "RecyclingFeeAmount": "",
                        "OrderTotalAmount": "11.00",
                        "OrderQty": "2",
                        "IsAutoVoid": "false",
                        "SalesChannel": "0",
                        "FulfillmentOption": "1",
                        "ItemInfoList": {
                            "ItemInfo": {
                                "SellerPartNumber": "A006ZX-35833",
                                "NeweggItemNumber": "9SIA0060845543",
                                "MfrPartNumber": "ZX-35833",
                                "UPCCode": "431573000287",
                                "Description": "GYRO Huge Metal Goliath 3.5CH Electric RTF RC Helicopter",
                                "OrderedQty": "2",
                                "ShippedQty": "2",
                                "UnitPrice": "1.00",
                                "Status": "2",
                                "StatusDescription": "Shipped",
                                "ExtendUnitPrice": "1.03",
                                "ExtendShippingCharge": "1.03",
                                "ExtendSalesTax": "",
                                "ExtendVAT": "",
                                "ExtendDuty": ""
                            }
                        },
                        "PackageInfoList": {
                            "PackageInfo": {
                                "PackageType": "Shipped",
                                "ShipCarrier": "UPS",
                                "ShipService": "342",
                                "TrackingNumber": "2342424",
                                "ShipDate": "1/18/2012 16:59:15",
                                "ItemInfoList": {
                                    "ItemInfo": {
                                        "SellerPartNumber": "A006ZX-35833",
                                        "MfrPartNumber": "ZX-35833",
                                        "ShippedQty": "2"
                                    }
                                }
                            }
                        }
                    }
                ]
            }
        },
        "Memo": "",
        "ResponseDate": "2/22/2012 16:51:03"
    }
}

Request Failure Errors

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

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CE001</Code>
        <Message>SellerID cannot be null or empty</Message>
    </Error>
</Errors>

Example: Json, Response

[
    {
        "Code": "CE001",
        "Message": "SellerID cannot be null or empty"
    }
]

Last updated: October 15, 2018