--- title: Get available event filter values slug: reference/get-available-event-filter-values docTags: createdAt: 2025-08-13T21:16:12.609Z --- { "id": "Ji1d8mmCVqLtBIxPygMPx", "type": "api-oas-v2", "data": { "method": "GET", "url": "https://app.amberflo.io/account-event/filters", "servers": [ { "url": "https://app.amberflo.io/account-event/filters" } ], "name": "Get available event filter values", "description": "

Retrieves all available filter value combinations for account events within a specified time range.\nUse this endpoint to discover what filter values are available before querying the main\nevent logs, enabling dynamic filter UI construction.

\n

Returns all unique combinations of level, domain, and eventType that have\nactual events in the selected time period. This helps you:

\n\n

Important Note: Results are based on events within the specified time range only.\nUse the same time filters as your main event query for accurate results.

", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [], "queryParameters": [ { "kind": "optional", "name": "startTimeInMillis", "type": "integer", "description": "

Filter for events that happened after (inclusive) this time. In milliseconds since UNIX epoch.

" }, { "kind": "optional", "name": "endTimeInMillis", "type": "integer", "description": "

Filter for events that happened before (inclusive) this time. In milliseconds since UNIX epoch.

" }, { "kind": "optional", "name": "customerId", "type": "string", "description": "Filter for events related to this customer." }, { "kind": "optional", "name": "level", "type": "string", "description": "Filter for events at this level of severity." }, { "kind": "optional", "name": "domain", "type": "string", "description": "Filter for events pertaining to this domain." }, { "kind": "optional", "name": "eventType", "type": "string", "description": "Filter for events of this type." } ], "bodyDataParameters": [], "formDataParameters": [], "oAuthParameters": [ { "id": "api_key", "name": "x-api-key", "kind": "optional", "type": "apiKey", "in": "header" } ] }, "responses": [ { "statusCode": "200", "description": "Available filter combinations for the specified time range and criteria", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "array", "description": "List of available filter combinations for account events within the specified time range.", "customType": "account-event-filters-response", "schema": [ { "name": "level", "kind": "optional", "type": "string", "description": "Event severity level for filtering logs. Values are INFO, WARN, ERROR.", "example": "" }, { "name": "domain", "kind": "optional", "type": "string", "description": "Event domain category such as webhooks, notifications, or billing operations.", "example": "" }, { "name": "eventType", "kind": "optional", "type": "string", "description": "Specific event type identifier within the domain for detailed filtering.", "example": "" } ], "modelRef": "#/components/schemas/account-event-filters-response", "isExpanded": true } ] }, { "statusCode": "400", "description": "Invalid query parameters or filter values", "jsonExample": "", "isExpanded": true }, { "statusCode": "401", "description": "Missing or invalid API key authentication", "jsonExample": "", "isExpanded": true }, { "statusCode": "403", "description": "Insufficient permissions to access this resource", "jsonExample": "", "isExpanded": true }, { "statusCode": "500", "description": "Internal server error occurred while processing request", "jsonExample": "", "isExpanded": true } ], "hasXCodeSamples": false, "examples": { "languages": [ { "id": "93m13SHMGLanPE-FUtiFQ", "language": "curl", "label": "cURL", "code": "curl --request GET \\\n --url https://app.amberflo.io/account-event/filters \\\n --header 'accept: application/json'" }, { "id": "scHhfmvUF7djr0sPu2NXd", "language": "javascript", "label": "javascript", "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n method: 'GET',\n headers: myHeaders,\n redirect: 'follow'\n};\n\nfetch(\"https://app.amberflo.io/account-event/filters\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));" }, { "id": "xYr90rBvA6wRY1WHjVJeA", "language": "ruby", "label": "Ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://app.amberflo.io/account-event/filters\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n" }, { "id": "3GMAfc-mrE3hmra8B2oD6", "language": "python", "label": "Python", "code": "import requests\nimport json\n\nurl = \"https://app.amberflo.io/account-event/filters\"\n\npayload = {}\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n" } ], "selectedLanguageId": "93m13SHMGLanPE-FUtiFQ" }, "results": { "languages": [ { "id": "response-0-200", "language": "200", "code": "// Available filter combinations for the specified time range and criteria\n[\n {\n \"level\": \"\",\n \"domain\": \"\",\n \"eventType\": \"\"\n }\n]" }, { "id": "response-1-400", "language": "400", "code": "// Invalid query parameters or filter values\n" }, { "id": "response-2-401", "language": "401", "code": "// Missing or invalid API key authentication\n" }, { "id": "response-3-403", "language": "403", "code": "// Insufficient permissions to access this resource\n" }, { "id": "response-4-500", "language": "500", "code": "// Internal server error occurred while processing request\n" } ], "selectedLanguageId": "response-0-200" } }, "children": [ { "text": "", "id": "_7gq__gz0fHgFdSRQ1M-K" } ] }