Update Listing

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the listing to retrieve.

Body Params
string
length ≤ 80

The name (title) of the listing. Max 80 characters.

string
length ≤ 8000

The description of the listing. Max 8000 characters, no HTML.

integer
string

If set, and if there is an active listing for the User with the same private_id, the existing listing will be updated.

string

The currency of the listing.

integer

The quantity of items available in the listing. Must be greater than 1.

float

Required when listing_type = auction.

float

Required when listing_type = product.

boolean

If buyers can make offers on the listing.

float

The hidden minimum offer amount set by the Seller which an offer must meet.

float

The hidden maximum offer amount set by the Seller which an offer must meet.

date-time

Can only be changed on listings currently scheduled to start in the future.

integer
enum

The duration of the listing.

Allowed:
boolean

If the listing is homepage featured.

integer

A valid Country ID.

string

A valid State ID or string (if outside the list of countries where State IDs are defined).

string

A zip or postal code.

boolean

Whether the seller accepts returns.

string

Optional text explaining the returns policy.

postage
array of objects

A Postage represents a single postage option attached to a Listing. If you do not plan to create different postage costs for different Listings, we recommend that when creating or updating Listings through the API, that you leave the postage field blank. This will result in your Listing being assigned your default postage costs and options, which can be set from the Members Area > Selling > Seller Tools > Default Listing Settings page.
Combined Shipping: On Hip eCommerce, when an item is purchased, the cost to ship the item is represented by the price in the Postage resource. If a buyer purchases multiple items from a Seller in a single Sale (Order), the highest price for any of the applicable Postage resources will be used for the attached Listing. All other Listings will be charged the price_addl rate instead (the cost to ship the item as an additional item in a Sale (Order)). If there is a specific item which you do not wish to offer combined shipping on, simply set the price and price_addl to the same rate. However, please keep in mind that Hip eCommerce requires all shipping settings to be reasonable and not excessive.
Table Rate Shipping per Number of Items: The price_addl field can be used to set-up table rate shipping per number of items in a Sale (Order). For example, 3.00/5 where 3.00 would only be added after every 5th additional item in the Sale (Order).

postage
integer

Only required if the User is using calculated shipping.

integer

Only required if the User is using calculated shipping.

integer

The depth of the package.

integer

The length of the package.

integer

The width of the package.

string

Additional shipping details.

images
array of urls

An array of URLs which list the images associated with the listing. The first item returned is the main image.

images
string

Custom item specifics for the listing, depending on the marketplace.

Response

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json