---
title: "List all customers"
method: GET
path: "/msp/v3/customers"
tags: ["Customers"]
---

# List all customers

`GET /msp/v3/customers`

Returns the list of all customers.

## Query parameters

- `pageSize` string
- `pageToken` string
- `includeFeatures` boolean

## Headers

- `Authorization` string, required

## Response `200`

Ok

- GetCustomersV3Response
  - `customers` GetCustomerV3Response[] — The list of returned customers.
    - `id` string — The unique ID of the customer. Example - 'bde7f8c2-d063-4a4a-9a8f-c2ea5aff42f3-198'
    - `accountName` string — The Account name of the customer. Example - Druva
    - `address` string — The postal address of the customer. Example - '213 Derrick Street Boston, MA 02130 USA'.
    - `phone` string — The contact number of the customer. Example - '12345678910'.
    - `customerName` string — The name of the customer. Example - 'Druva'
    - `features` object[] — The features subscribed by the customer.
    - `tenantAdmins` integer[] — The unique IDs of the tenant admins assigned to the customer. Example - [1]
    - `status` integer — The current status of the customer account creation in the MSP Console. Example - 1 - 0 - Creation pending - 1 - Ready - 2 - Tenant processing
    - `createdOn` string, date-time — The date and time when the customer was created in the MSP Console. Example - '2022-10-25T00:00:00Z'
    - `activeSince` string, date-time — The date and time since the customer is in Active state in MSP Console. Example - '2022-10-25T00:00:00Z'.
    - `attributes` CustomerAttributes[] — The attributes of the given customer
      - `name` string, required — - The name of the customer attribute - For valid attributes and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values
      - `value` string, required — - The value of the customer attribute - For valid attributes and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values
    - `cloud` integer — The cloud where customer account is present. Example - 1 - 0 - Public - 1 - FIPS - 2 - FedRamp
  - `nextPageToken` string — The token to access the next page of results. This is empty if there are no more results. Example - 'eyJwYWdlU2l6ZSI6IDEwMH0='

## Other responses

- `400` — Bad Request
- `401` — The request did not include a valid Access Token. Kindly provide a valid Access Token to process the request.
- `500` — The request was not processed due to an internal error. Kindly try again later. If the error persists, contact Druva Support.

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)