/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 |
|