Verify Service Status

Newegg Marketplace API provides an interface in every major service group to allow you to check whether the service you are invoking is available or not. Each major service group is listed in the Parameters section, domain field description.  Return each major service group’s availability.

Resource URL 

Newegg.com: https://api.newegg.com/marketplace/{domain}/servicestatus?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/{domain}/servicestatus?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/{domain}/servicestatus?sellerid={sellerid}

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
domain Yes Major Service Groups Options:

  • contentmgmt
  • ordermgmt
  • datafeedmgmt
  • servicemgmt
  • reportmgmt
  • sellermgmt
  • sbnmgmt
  • shippingservice
sellerid Yes Your seller ID on Newegg Marketplace

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
GET Required XML, Json XML, Json 1000 per min per client

Example: XML, Request

GET https://api.newegg.com/marketplace/contentmgmt/servicestatus?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

Example: Json,  Request

GET https://api.newegg.com/marketplace/contentmgmt/servicestatus?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

Response Body

Attribute Format Description
IsSuccess String Used to identify whether the requested service is successful or not. Returns true or false.
OperationType String Fixed value: GetServiceStatus
SellerID String Your Seller ID
Status Integer 0.  Service unavailable
1.  Service available
Timestamp String Request date time (Pacific Standard Time)
Message String When service is unavailable (status = 0), this field will provide a detailed explanation.

Schema: GetSellerAccountStatusResponse.xsd

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>GetServiceStatus</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <Status>1</Status>
        <Timestamp>2/14/2012 9:42:46</Timestamp>
    </ResponseBody>
</NeweggAPIResponse>

Example: Json, Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "OperationType": "GetServiceStatus",
        "SellerID": "A006",
        "ResponseBody": {
            "Status": "0",
            "Timestamp": "2/15/2012 2:50:38",
            "Message": "The service is unavailable or experiencing extremely high error rates."
        }
    }
}

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