---
title: "List your active administrators"
method: GET
path: "/v1/admins"
tags: ["Partner API"]
---

# List your active administrators

`GET /v1/admins`

## Request

- Base URL: `https://sandbox.onlink.africa`
- URL: `https://sandbox.onlink.africa/v1/admins`
- Auth: API key in header `X-OnLink-Key`

## Response `200`

Your administrators

- PartnerAdminResponseDto[]
  - `adminId` string, uuid, required: The administrator id. Use it for DELETE /v1/admins/{id}.
  - `email` string, required: Administrator email, returned whole. It is an address you supplied on your own configured domain, so echoing it discloses nothing you do not hold — unlike `approvalSentTo`, which is masked because it accompanies a live second factor.
  - `name` string, required: Administrator name, as you registered it.
  - `status` 'active' | 'removed', required: Lifecycle. Removal is recorded rather than deleted, so a removed administrator reads `removed` and never disappears from the audit trail — but only `active` administrators receive approval codes, and GET /v1/admins lists only those.

---

[API](https://skmtc.dev/onlink/apis/onlink-partner-api.md) - [All operations](https://skmtc.dev/onlink/apis/onlink-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onlink/apis/onlink-partner-api/revisions/1d1c6a3671f2?raw)