/Items/BulkRelist?{itemIDs} POST
Allows you to bulk relist ended items.
- URL
- /Items/BulkRelist?{itemIDs}
- Verb
- Post
Headers
Header |
Data Type |
Valid Values |
Required |
Description |
Content-Type |
string |
application/json |
YES |
The format your data will be sent to our site. |
X-DevKey |
string |
string |
YES |
The devkey assigned to the developer. |
X-AccessToken |
string |
string |
YES |
The token acquired from a POST to Users/AccessToken. |
Input
Parameter |
Data Type |
Valid Values |
Description |
itemIds |
string |
Comma-separated item ids |
List of item ids to bulk relist. Limited to 100 per request. Ex: itemIds=12345,67890 |
Output
If itemIDs is not provided, you will receive a 400 Bad Request
If one of the itemIDs cannot be parsed into an integer, you will receive a 400 Bad Request
and a message indicating which item ID was invalid.
If the number of itemIDs provided exceeds 100, you will receive a 403 Forbidden
If there are no errors with the input parameters, this call will respond with a 200 OK
and the following data as serialized JSON
Main Body
Parameter |
Data Type |
Valid Values |
Description |
ErrorRelistCount |
integer |
positive # |
The count of items that returned an error and did not relist |
ErrorRelistItems |
Array |
Array of ErrorRelistItem objects (see below) |
The list of items that returned an error and did not relist |
SuccessRelistCount |
integer |
positive # |
The count of items successfully relisted |
SuccessRelistItems |
Array |
Array of SuccessRelistItem Objects (see below) |
The list of items that successfully relisted |
SuccessRelistPriceTotal |
decimal |
positive # |
The total relist price of the items successfully relisted |
ErrorRelistItem
Parameter |
Data Type |
Valid Values |
Description |
ErrorMessage |
string |
string |
The error message for the item that failed to relist |
ItemID |
integer |
positive # |
The id of the item that failed to relist |
SuccessRelistItem
Parameter |
Data Type |
Valid Values |
Description |
ItemID |
integer |
positive # |
The id of the original item to relist |
Links |
Array |
Array of Links (see below) |
Links for the original item and the relisted item |
RelistItemID |
integer |
positive # |
The id of the relisted item |
RelistPrice |
decimal |
positive # |
The relist price of the item |
Links
Rel |
Description |
Condition |
relisteditem |
The item details for the relisted item |
|
self |
The item details for the original item |
|