Get a Consumer Group
GET /apisix/admin/consumer_groups/{id}
GET /apisix/admin/consumer_groups/{id}Interactive request editor loads with JavaScript.
X-API-KEY<token>
Admin API key configured in config.yaml under deployment.admin.admin_key. You can also pass the key as a query parameter api_key or cookie x_api_key.
In: header
Path Parameters
id*string
Unique identifier of the resource. Can be a string (alphanumeric, -, _, .) or a positive integer.
Response Body
application/json
application/json
application/json
curl -X GET "http://127.0.0.1:9180/apisix/admin/consumer_groups/my-resource-1"Successful response.
{
"value": {
"plugins": {
"limit-count": {
"allow_degradation": false,
"count": 2,
"group": "consumer_group_name",
"time_window": 60,
"show_limit_quota_header": true,
"key": "remote_addr",
"rejected_code": 503,
"key_type": "var",
"policy": "local"
}
},
"desc": "desc",
"id": "company_a",
"create_time": 1684377809,
"update_time": 1684378459
},
"key": "/apisix/consumer_groups/company_a",
"modifiedIndex": 144,
"createdIndex": 143
}**Unauthorized** — The API key is missing, invalid, or lacks permission.
{
"error_msg": "failed to check token",
"description": "missing apikey"
}{
"error_msg": "failed to check token",
"description": "wrong apikey"
}{
"error_msg": "failed to check token",
"description": "invalid method for role viewer"
}Key not found
{
"error_msg": "Key not found"
}Complete operation details and schema variants
GET /apisix/admin/consumer_groups/{id}
Get a Consumer Group
Retrieve a single consumer group by its ID.
Parameters
id(path, string, required): Unique identifier of the resource. Can be a string (alphanumeric,-,_,.) or a positive integer.
Responses
200: Successful response.key(string, required):value(object, required): Consumer Group configuration. Defines shared plugin configurations for multiple consumers.value.id(object, optional): Unique identifier for the resource. Can be a string (1–64 characters, alphanumeric with-,_,.) or a positive integer.- anyOf variant 1: String ID
- anyOf variant 2: Integer ID
value.name(string, optional): Human-readable name.value.desc(string, optional): Description of this group.value.labels(object, optional): Key-value pairs for categorizing and filtering resources. Values must be non-empty strings (max 256 characters).value.create_time(integer, optional): Unix timestamp of creation. Read-only.value.update_time(integer, optional): Unix timestamp of last update. Read-only.value.plugins(object, required): Plugin configurations as a JSON object. Each key is a plugin name, and the value is that plugin's configuration object.
Example:
{
"limit-count": {
"count": 100,
"time_window": 60
},
"key-auth": {}
}
See the Plugin Hub for available plugins and their schemas.
createdIndex(integer, optional):modifiedIndex(integer, optional):401: Unauthorized — The API key is missing, invalid, or lacks permission.error_msg(string, required): Authentication error message.description(string, optional): Detailed reason for the authentication failure.404: Not Found — The specified resource does not exist.error_msg(string, required): Error message indicating the resource was not found.
cURL
curl -X GET 'http://127.0.0.1:9180/apisix/admin/consumer_groups/{id}'