---
title: "Get Consumer Keys list"
method: GET
path: "/user/consumerKeys"
tags: ["consumerkey"]
---

# Get Consumer Keys list

`GET /user/consumerKeys`

## Request

- Base URL: `https://pro.api.serversmtp.com/api/v2`
- URL: `https://pro.api.serversmtp.com/api/v2/user/consumerKeys`
- Auth: API key in header `Authorization`

Get Consumer Keys list

Note: Consumer Keys listing is not allwed when authenticated via Consumer Key.

## Response `200`

Sucess

Consumer Keys list

- ConsumerKeyListSucessResponsetBody
  - `count` integer, required
  - `results` ConsumerKey[], required
    - `consumerKey` string, required: Consumer Key
    - `label` string, required: Consumer Key label.
    - `creation_time` string, required
    - `ips` string[], required: IP addresses restricted to this consumer key. Empty array means no restriction.
    - `is_legacy` boolean, required: True if this is a legacy consumer key.
    - `permissions` string[], required: Permissions granted to this consumer key.

## Other responses

- `401`: Unauthorized This API requires a valid API Key to be provided. (Use [/authentication/authorize](#/authentication/AuthenticationLogin) to obtain an API Key) Produces: * missing_authorization_key * invalid_authorization_key * account_is_inactive

---

[API](https://skmtc.dev/serversmtp/apis/turbosmtp-public-apis.md) - [All operations](https://skmtc.dev/serversmtp/apis/turbosmtp-public-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/serversmtp/apis/turbosmtp-public-apis/revisions/8503e099b215?raw)