# Get All Picklists

**Table of Contents**

### Overview

This endpoint allows you to retrieve data for a list of existing **Picklists.** To consume it, you must be an [Authenticated User](https://developer.sellercloud.com/dev-article/authentication/). 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
}
```