Get Authorized Shipping Carriers

Retrieve the complete list of authorized shipping carriers for the platform in the request URL. Use the returned Shipping Carrier Name as the carrier name when you submit shipment tracking information, so the name matches the standard carrier name exactly.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/ordermgmt/order/shipping-carriers?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/ordermgmt/order/shipping-carriers?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/ordermgmt/order/shipping-carriers?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
sellerid	Yes	Your seller ID on Newegg Marketplace

Resource Information

HTTP Method	Authentication?	Request Formats	Response Formats	Rate Limited?	Maximum Size of Request
GET	Required	N/A	Json	10 requests per min per seller

Request Body

This request has no request body. The platform is determined by the request URL; the response always contains the complete list for that platform (no paging).

Example: Json, Request

GET https://api.newegg.com/marketplace/ordermgmt/order/shipping-carriers?sellerid={sellerid}
Authorization: {your API key}
SecretKey: {your secret key}
Accept: application/json

Response Body

Attribute	Format	Description
PlatformCode	String	The platform of the request URL: USA: Newegg.com CAN: Newegg.ca B2B: Neweggbusiness.com
TotalCount	Int	Number of shipping carriers returned. Equals the number of items in ShippingCarriers.
ShippingCarriers	Array	Complete list of authorized shipping carriers for the platform, sorted alphabetically by ShippingCarrierName (case-insensitive). Returns an empty array when the platform has no authorized shipping carrier.
ShippingCarrierName	String	Standard shipping carrier name. Submit this value exactly as returned (same spelling and letter case) as the shipping carrier when you submit shipment tracking information.

Example: Json, Response

{
    "PlatformCode": "USA",
    "TotalCount": 3,
    "ShippingCarriers": [
        {
            "ShippingCarrierName": "FedEx"
        },
        {
            "ShippingCarrierName": "UPS"
        },
        {
            "ShippingCarrierName": "USPS"
        }
    ]
}

Note: The carrier names above are examples only. Each platform has its own list; query each platform separately.

Usage Recommendations

• Map the shipping carrier names in your own system to the returned ShippingCarrierName for each platform, and submit the returned name instead of your own carrier name.
• Refresh the list once a day, and query again when a shipping carrier name is rejected. A refreshed list does not guarantee that a previously returned name remains valid until the next refresh.
• If the request fails, keep your existing mapping and retry later. A failed request does not mean the list is empty.

Request Failure Errors

For common HTTP error responses, such as missing or invalid credentials, please refer to Failed Response Error Code List. Error responses are returned in the format of your Accept header (XML or Json).

Error Code	Description
InvalidToken	The seller ID, Authorization or SecretKey is missing or invalid, or the credentials do not belong to the platform in the request URL.
429	Too many request. The request rate limit has been exceeded. Please retry after the time in the X-RateLimit-ResetTime response header.
InternalError	Our servers are currently unavailable and cannot process your request at this time. Please try again.

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>InvalidToken</Code>
        <Message>Illegal secret key.</Message>
    </Error>
</Errors>

Example: Json, Response

[
    {
        "Code": "InvalidToken",
        "Message": "Illegal secret key."
    }
]

Last updated: November 4, 2026