Overview
This endpoint allows you to retrieve data for a list of existing Picklists. To consume it, you must be an Authenticated User. Once you have obtained a valid token, it must be passed on the call.
Endpoint
An example of this endpoint for server XX:
https://xx.api.sellercloud.com/rest/api/picklists?pageNumber=1&pageSize=1
For your server, the endpoint will be:
https://{your_server_id}.api.sellercloud.com/rest/api/picklists?pageNumber=1&pageSize=1
Request
- Method Type: HttpGet
- Authorization: Use Bearer Token + token received from token authentication
- Header info: Content-Type: application/json
- Parameters:
| Parameters | Data Type | Description | Is Required |
| pageNumber | integer | Page number that will be retrieved. If the page number is not set in the request, then only 1st page will be pulled. | no |
| pageSize | integer | Number of results per page. If not set in the request, then the top 10 picklists will be pulled. The maximum number of results per page is 50. | no |
| picklistID | integer | List of existing Picklist IDs. | no |
| title |
string | Title of the Picklist. | no |
| productID | string | List of Product IDs contained in picklists. | no |
| generatedFrom | datetime | Earliest Picklist generation date. | no |
| generatedTo | datetime | Latest Picklist generation date. | no |
| warehouse | array/integer | List of IDs of warehouses. | no |
| status | enum | The available values are 0 = Open, 1 = Closed, -1 = All. | no |
| orderID | string | Sellercloud Order ID. | no |
Response
- If the user is authenticated and provides a valid page number and page size, then the response will be Status Code 200 => OK and picklist metadata in JSON format.
- If the user is not authenticated, then the response will be Status Code 401 => Not Valid Token.
- In case of an error, the response will be Status Code 500 => Internal Server Error.
Response Body
{
"Items": [
{
"ID": 0,
"Title": "string",
"Status": 0,
"GeneratedOn": "2026-02-19T11:33:47.510Z",
"GeneratedByUserID": 0,
"GeneratedByUserName": "string",
"WarehouseID": 0,
"WarehouseName": "string",
"Orders": 0,
"SKUs": 0,
"Units": 0,
"UnitsPicked": 0,
"RelatedQueuedJobID": 0,
"ParentPicklistID": 0,
"UnshippedOrders": 0,
"TotalShipped": 0
}
],
"TotalResults": 0
}