definition
Get values for an observability filter
Returns a paginated list of distinct values for a given filter within an optional time range.
- ENUM filters return their static enum values.
- KEYWORD filters return distinct values from the analytics data store.
- NUMBER and STRING filters are not supported and return 400.
get/environments/{envId}/observability/filters/{filterName}/values
Path parameters
envIdstring required
The unique ID of your environment
filterName'API' | 'APPLICATION' | 'PLAN' | 'API_PRODUCT' | 'GATEWAY' | 'TENANT' | 'ZONE' | 'HTTP_METHOD' | 'HTTP_STATUS_CODE_GROUP' | 'HTTP_STATUS' | 'HTTP_PATH' | 'HTTP_PATH_MAPPING' | 'HOST' | 'GEO_IP_COUNTRY' | 'GEO_IP_REGION' | 'GEO_IP_CITY' | 'GEO_IP_CONTINENT' | 'CONSUMER_IP' | 'HTTP_USER_AGENT_OS_NAME' | 'HTTP_USER_AGENT_DEVICE' | 'MESSAGE_CONNECTOR_TYPE' | 'MESSAGE_CONNECTOR_ID' | 'MESSAGE_OPERATION_TYPE' | 'MESSAGE_SIZE' | 'MESSAGE_COUNT' | 'MESSAGE_ERROR_COUNT' | 'HTTP_ENDPOINT_RESPONSE_TIME' | 'HTTP_GATEWAY_LATENCY' | 'HTTP_GATEWAY_RESPONSE_TIME' | 'HTTP_REQUEST_CONTENT_LENGTH' | 'HTTP_RESPONSE_CONTENT_LENGTH' | 'LLM_PROXY_MODEL' | 'LLM_PROXY_PROVIDER' | 'MCP_PROXY_METHOD' | 'MCP_PROXY_TOOL' | 'MCP_PROXY_RESOURCE' | 'MCP_PROXY_PROMPT' | 'API_TYPE' | 'ERROR_KEY' | 'REQUEST_ID' | 'TRANSACTION_ID' | 'EDGE_PROVIDER' | 'EDGE_PROCESS' | 'EDGE_CLIENT' | 'EDGE_TYPE' | 'EDGE_VERSION' | 'EDGE_MODEL' | 'EDGE_TOOL' | 'NATIVE_CONNECTION_STATUS' | 'URI' | 'ENTRYPOINT' required
Available filter names for filtering analytics data
The filter name for which to retrieve values
Query parameters
frominteger
Start of the time range (epoch milliseconds). Only applies to KEYWORD filters.
tointeger
End of the time range (epoch milliseconds). Only applies to KEYWORD filters.
pageinteger
Page number (starting from 1)
perPageinteger
Number of items per page
querystring
Optional search string (case-insensitive). For ENUM filters, matches enum labels by substring. For KEYWORD filters backed by analytics data (Elasticsearch), matches the stored keyword value exactly. For ID-based filters (API, APPLICATION, PLAN), matches display names by substring.
Response
A paginated list of filter values.
Example response
{
"data": [
{
"value": "gateway-1"
},
{
"value": "gateway-2"
},
{
"value": "gateway-3"
}
],
"pagination": {
"page": 1,
"perPage": 10,
"pageCount": 1,
"pageItemsCount": 3,
"totalCount": 3
}
}