# Get All Customers

**Table of Contents**

### Overview

In order to get information for many customers in a single request, then you can consume the endpoint presented in this article. However in order to do that, you must:

- Be authenticated user

For information on how you can authenticate, see: [Authentication](https://developer.sellercloud.com/dev-article/authentication/)

As soon as you do authentication and receive a valid token, it needs to be passed on the call for getting customers information.

- You can provide page number and page size and some filtering information

### Endpoint

Example for such endpoint for TT server:

[https://tt.api.sellercloud.com/rest/api/Customers?pageNumber=1&pageSize=1](https://tt.api.sellercloud.com/rest/api/Customers?pageNumber=1&pageSize=1)

For your server endpoint will be:
​ [https://{your_server_id}.api.sellercloud.com/rest/api/Customers?pageNumber=1&pageSize=1](https://{your_server_id}.api.sellercloud.com/rest/api/Customers?pageNumber=1&pageSize=1)

### Request

Information about expected request parameters can be found on swagger UI [https://tt.api.sellercloud.com/rest/swagger](https://tt.api.sellercloud.com/rest/swagger).

- 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 | Number of page | yes |
| pageSize | integer | Number of customers per page | yes |
| customerIDs | List | List of ID of customers | No |
| firstName | string | First name of customer | No |
| lastName | string | Last name of customer | No |
| email | string | Email of customer | No |
| rating | string | NotRated, Very_Disatisfied, Neutral, Satisfied, Very_Satisfied | No |
| customerType | string | Retail, Wholesale | No |
| subscribed | integer |  | No |
| createdOnFrom | DateTime |  | No |
| createdOnTo | DateTime |  | No |
| modifiedOnFrom | DateTime |  | No |
| modifiedOnTo | DateTime |  | No |
| phoneNumber | string | Customer phone number. | No |
| city | string | Customer city. | No |
| zipCode | string | Customer zip code | No |
| exported | integer |  | No |
| channel | string | Local_Store, Amazon etc.<br>Please check swagger for more information. | No |
| corporateName | string | The Business Name | No |
| keyword | string | A search term for performing a global search. No | No |

### Response

- If user is authenticated and provides a valid page number and page size, then response will be **Status Code 200 => OK** and orders metadata in JSON format

```json
{
   "Items": [],
   "TotalResults": 0
}
```

- If user is not authenticated, then response will be **Status Code 401 => Not Valid Token**
- On server response => **Status Code 500 => Internal Server Error**