---
title: "List all Consumers"
method: GET
path: "/consumers"
tags: ["Consumers"]
---

# List all Consumers

`GET /consumers`

List all Consumers

## Query parameters

- `size` integer
- `offset` string
- `tags` string

## Response `200`

A successful response listing Consumers

- object
  - `data` Consumer[]
    - `created_at` integer — Unix epoch when the resource was created.
    - `custom_id` string — 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.
    - `id` string
    - `tags` string[] — An optional set of strings associated with the Consumer for grouping and filtering.
    - `updated_at` integer — Unix epoch when the resource was last updated.
    - `username` string — The unique username of the Consumer. You must send either this field or `custom_id` with the request.
  - `next` string — URI to the next page (may be null)
  - `offset` string — Offset is used to paginate through the API. Provide this value to the next list operation to fetch the next page

## Other responses

- `401` — Unauthorized

## Changes

> 3 revisions in range; 1 not diffed.

- **2024-09-11** `5bd52189d290` — 1 info
  - added the optional property `next` to the response with the `200` status

[Change history](https://skmtc.dev/kong/apis/kong-enterprise-admin-api/changes/consumers/get.md)

---

[API](https://skmtc.dev/kong/apis/kong-enterprise-admin-api.md) · [All operations](https://skmtc.dev/kong/apis/kong-enterprise-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kong/kong-enterprise-admin-api/revisions/5bd52189d290/schema)