Returns fee estimate for a single item by Seller SKU

POST

/products/fees/v4/listings/:SellerSKU/feesEstimate

POST

/seller/v1/products/fees/v4/listings/:SellerSKU/feesEstimate

curl -X POST "https://marketplace.walmart.com/seller/v1/products/fees/v4/listings/SellerSKU/feesEstimate?MarketplaceId=WALMART_US" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "payload": {
    "FeesEstimateResult": {
      "Status": "Success",
      "FeesEstimateIdentifier": {
        "MarketplaceId": "string",
        "IdType": "WalmartItemId",
        "IdValue": "string",
        "IsWalmartFulfilled": true,
        "PriceToEstimateFees": {
          "ListingPrice": {
            "CurrencyCode": "USD",
            "Amount": 1.1
          },
          "Shipping": {
            "CurrencyCode": "USD",
            "Amount": 1.1
          },
          "Points": {
            "PointsNumber": 1
          }
        },
        "SellerId": "string",
        "SellerInputIdentifier": "string",
        "OptionalFulfillmentProgram": "string"
      },
      "FeesEstimate": {
        "TimeOfFeesEstimation": "2024-01-15T09:30:00Z",
        "TotalFeesEstimate": {
          "CurrencyCode": "USD",
          "Amount": 1.1
        },
        "FeeDetailList": [
          {
            "FeeType": "string",
            "FeeAmount": {
              "CurrencyCode": "USD",
              "Amount": 1.1
            },
            "FinalFee": {
              "CurrencyCode": "USD",
              "Amount": 1.1
            },
            "FeePromotion": {
              "CurrencyCode": "USD",
              "Amount": 1.1
            },
            "TaxAmount": {
              "CurrencyCode": "USD",
              "Amount": 1.1
            },
            "IncludedFeeDetailList": [
              null
            ]
          }
        ]
      },
      "Error": {
        "Type": "string",
        "Code": "string",
        "Message": "string",
        "Detail": [
          "string"
        ]
      }
    }
  },
  "errors": {
    "errors": [
      {
        "code": "string",
        "message": "string",
        "details": "string"
      }
    ]
  }
}

Returns an estimated fee for a seller listing identified by Seller SKU.

Path parameters

SellerSKUstringRequired

The seller's SKU for the listing. Scoped to the authenticated seller.

Query parameters

MarketplaceIdenumRequired

Marketplace identifier.

Allowed values:

Request

This endpoint expects an object.

FeesEstimateRequestobjectOptional

Fee estimate parameters for a single item. Used in both single-item and batch endpoints. Mirrors SP-API FeesEstimateRequest.

Response

Success

payloadobjectOptional

Wraps the fee estimate result for a single-item endpoint.

errorsobjectOptional

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error