---
title: "List all administrators"
method: GET
path: "/console/v1/admins"
tags: ["Administrators"]
---

# List all administrators

`GET /console/v1/admins`

## Request

- Base URL: `https://apis.druva.com/platform`
- URL: `https://apis.druva.com/platform/console/v1/admins`
- Auth: API key in header `Authorization`

Returns the details of existing administrators in the Cloud Console. 
 > 📘 Note 
 To use this API endpoint, enable the [Administrator API from Druva Cloud settings](/reference/administrators).

## Query parameters

- `pageSize` integer
- `pageNumber` integer
- `pageToken` string
- `sortBy` 'adminName' | 'email' | 'lastLogin'
- `sortOrder` 'ASC' | 'DESC'
- `searchString` string
- `filters` string

## Headers

- `Content-Type` 'application/json', required

## Response `200`

Success

- ListAdminsResponse
  - `globalCustomerId` string: The unique ID associated with the customer
  - `totalSize` integer: The total number of admins wrt to the filters applied
  - `nextPageToken` string: The token to access the next page of results. This parameter will be empty for the last page of the results.
  - `admins` Admin[]
    - `globalAdminId` string: The unique ID associated with the admin
    - `adminEmail` string: The email associated with the admin
    - `adminName` string: The name of the admin
    - `lastLogin` number, float: The last time the admin had logged-in
    - `role` string: The role associated with the admin
    - `provisioningMode` string: The mode through which the admin was created
    - `adminState` string: The current state of the admin
    - `disabledThroughMode` string: The mode through which the admin was disabled(Applicable only if the Admin is in DISABLED state)
    - `adGuid` string: The globally unique identifier
    - `deletionEpoch` number, float: The deletion epoch in case the admin is marked for deletion
    - `deletionTime` string, date-time: The deletion time in case the admin is marked for deletion. The time is in the UTC time zone. Example - 2024-01-04T09:06:02.191Z
    - `customId` string: Null in case customId is not enabled for the customer
    - `adMappingId` integer: The mapping ID for the AD created admin
    - `disabledOnTS` number, float: The epoch time when the admin was disabled.

## Other responses

- `400`: Bad Request
- `404`: The requested resource was not found.
- `500`: The request was not processed due to an internal error.

---

[API](https://skmtc.dev/druva/apis/platform.md) - [All operations](https://skmtc.dev/druva/apis/platform/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/platform/revisions/80533a559af4?raw)
