v50

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-07-068428533.0 MB

Centrally Managed Consumers

Get a consumer

Get a consumer from the given realm.

get/v1/realms/{realmId}/consumers/{consumerId}

Response

success

idstring uuid required

The Consumer ID.

usernamestring required

The unique username of the Consumer. You must send either this field or custom_id with the request.

custom_idstring nullable required

Field for storing an existing unique ID for the Consumer - useful for mapping Kong with users in your existing database. You must send either this field or username with the request.

type'proxy' | 'developer' | 'admin' | 'application' required

Type of the consumer.

tagsstring[] required

consumer_groupsstring[] required

A list of consumer groups that the Consumer is in. If consumer_groups are provided on the Consumer object and on the Realm, the Consumer will be placed in all defined consumer groups.

created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "custom_id": "4200",
  "id": "8a388226-80e8-4027-a486-25e4f7db5d21",
  "type": "proxy",
  "consumer_groups": [
    "gold"
  ],
  "tags": [
    "partner"
  ],
  "username": "bob-the-builder",
  "created_at": "2025-06-17T16:55:58.569399532Z",
  "updated_at": "2025-06-17T16:55:58.569399532Z"
}