get_consumer_requests

Retrieve and analyze API requests by a specific consumer using consumer ID, time range, and filters for success or failure to gain insights into usage patterns and performance metrics.

Instructions

Retrieve and analyze API requests made by a specific consumer.

INPUT:

consumerId: String - ID of the consumer to analyze. The format of this field must be "controlPlaneID:consumerId".
timeRange: String - Time range for data retrieval (15M, 1H, 6H, 12H, 24H, 7D)
successOnly: Boolean - Filter to only show successful (2xx) requests (default: false)
failureOnly: Boolean - Filter to only show failed (non-2xx) requests (default: false)
maxResults: Number - Maximum number of results to return (1-1000)

OUTPUT:

metadata: Object - Contains consumerId, totalRequests, timeRange, and filters
statistics: Object - Usage statistics including:
- averageLatencyMs: Number - Average response time in milliseconds
- successRate: Number - Percentage of successful requests
- statusCodeDistribution: Array - Breakdown of requests by status code
- serviceDistribution: Array - Breakdown of requests by service
requests: Array - List of requests with details for each request

Input Schema

Name	Required	Description	Default
`consumerId`	Yes	Consumer ID to filter by (obtainable from analyze-failed-requests or query-api-requests tools)
`failureOnly`	No	Show only failed (non-2xx) requests
`maxResults`	No	Number of items to return per page
`successOnly`	No	Show only successful (2xx) requests
`timeRange`	No	Time range for data retrieval (15M = 15 minutes, 1H = 1 hour, etc.)	1H

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "consumerId": {
      "description": "Consumer ID to filter by (obtainable from analyze-failed-requests or query-api-requests tools)",
      "type": "string"
    },
    "failureOnly": {
      "default": false,
      "description": "Show only failed (non-2xx) requests",
      "type": "boolean"
    },
    "maxResults": {
      "default": 100,
      "description": "Number of items to return per page",
      "maximum": 1000,
      "minimum": 1,
      "type": "integer"
    },
    "successOnly": {
      "default": false,
      "description": "Show only successful (2xx) requests",
      "type": "boolean"
    },
    "timeRange": {
      "default": "1H",
      "description": "Time range for data retrieval (15M = 15 minutes, 1H = 1 hour, etc.)",
      "enum": [
        "15M",
        "1H",
        "6H",
        "12H",
        "24H",
        "7D"
      ],
      "type": "string"
    }
  },
  "required": [
    "consumerId"
  ],
  "type": "object"
}

Kong Konnect MCP Server

get_consumer_requests

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Kong Konnect MCP Server

Related Tools