{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Trench","colors":{"primary":"#0F1FA1","light":"#FFFFFF","dark":null},"favicon":"/favicon.png","logo":{"light":"https://mintcdn.com/frigade-v2-docs/FxFHpZ8uaGl7Kvi_/logo/dark.svg?fit=max\u0026auto=format\u0026n=FxFHpZ8uaGl7Kvi_\u0026q=85\u0026s=0b091486c3b72ca074be6db2dca3b4b8","dark":"https://mintcdn.com/frigade-v2-docs/FxFHpZ8uaGl7Kvi_/logo/dark.svg?fit=max\u0026auto=format\u0026n=FxFHpZ8uaGl7Kvi_\u0026q=85\u0026s=0b091486c3b72ca074be6db2dca3b4b8"},"api":{"mdx":{"server":"https://api.trench.dev","auth":{"method":"bearer","name":null}}},"appearance":{"default":"dark","strict":true},"background":{"decoration":null,"color":{"light":null,"dark":"#010101"}},"navbar":{"links":[{"label":"Website","href":"https://trench.dev"}],"primary":{"type":"button","label":"Get Started","href":"https://github.com/frigadehq/trench"}},"footer":{"socials":{"twitter":"https://twitter.com/FrigadeHQ","github":"https://github.com/FrigadeHQ/trench","linkedin":"https://www.linkedin.com/company/frigade/","website":"https://trench.dev"}},"integrations":{},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","href":"https://github.com/frigadehq/trench","icon":"github"},{"anchor":"Slack Community","href":"https://join.slack.com/t/trench-community/shared_invite/zt-2sjet5kh2-v31As3yC_zRIadk_AGn~3A","icon":"slack"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"frigade-v2-docs","hasAudioNarration":false,"actualSubdomain":"frigade-v2-docs","customDomains":["docs.trench.dev"],"gitSource":{"type":"github","owner":"frigadehq","repo":"trench","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae91e347acc70e71f350c66:success","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"Webhooks API","count":3},{"language":"default","tag":"Events API","count":2},{"language":"default","tag":"SDK and API","count":2},{"language":"default","tag":"Query API","count":1},{"language":"default","tag":"Guides","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"hr{margin-bottom:1.5rem!important}#topbar-cta-button{border-radius:100px;border:1px solid #627ee910;background:radial-gradient(\n 77.34% 100% at 50% 0%,\n rgba(255, 255, 255, 0.17) 0%,\n rgba(255, 255, 255, 0) 100%\n ),\n linear-gradient(0deg, #12228f 0%, #12228f 100%), #090f1b;background-blend-mode:normal, overlay, normal;box-shadow:0px 1px 0px 0px rgba(255, 255, 255, 0.47) inset,\n 0px 0px 140px 28px rgba(53, 79, 255, 0.5),\n 0px 0px 0px 5px rgba(255, 255, 255, 0.08) inset,\n 0px 0px 0px 4px rgba(0, 0, 0, 0.2), 0px 0px 36px 0px #242b5a,\n 0px 1.864px 0.466px -1.553px rgba(255, 255, 255, 0.7) inset,\n 0px 0.621px 0.311px -0.155px rgba(255, 255, 255, 0.3),\n 0px -0.311px 0.621px 0.621px rgba(0, 0, 0, 0.9) inset}"}],"page":{"pagePath":"api-reference/events-get","slug":"/api-reference/events-get","pageMetadata":{"title":"Get Events","description":"Get events based on a query","openapi":"get /events","href":"/api-reference/events-get","hidden":false},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Get events based on a query\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,..._provideComponents(),...props.components},{Info}=_components;if(!Info)_missingMdxReference(`Info`,true);return _jsxs(Info,{children:[`This endpoint requires your `,_jsx(_components.a,{href:`/api-reference/overview#authentication`,children:`private API key`}),`.`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Events","description":"Get events based on a query","openapi":"get /events","href":"/api-reference/events-get","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"EventsController_getEvents","summary":"Get events based on a query. Requires private API key in Bearer token.","parameters":["ab29345e-04bb-4a01-964c-63511f28c09a","39f2406d-8252-4b7f-902f-0ca55fda4dda","fb4ba13c-01c6-4d5f-a9e5-e140d8201697","25c4072a-7ef6-4734-b16e-8ddcfe7672f3","ed149547-6fb8-4268-b7be-604b7a5b199a","d21a9f37-3a40-48ef-89c0-bb306da1d1b2","32c05bf8-96b0-4968-948a-466f2809bd65","d74c18f1-31f5-44ef-bc62-331860b4ecea","90e410c3-5d65-4b14-967b-b87bbfbc12b2","201884cd-01d5-4ac5-ac8a-71d29fcdc6ea","296383b4-0008-47d7-a089-d80ee587ce05","5694fc5e-600a-48f7-820b-fcb23d93b493"],"responses":{"200":"7bfae554-24a7-4499-94d4-0c776be47842"},"tags":["events"],"security":["b22f6fd5-3338-4b38-a747-7e8fade03814"],"method":"get","type":"path","servers":[],"path":"/events","baseUrlOptions":["https://api.trench.dev"],"title":"Get events based on a query. Requires private API key in Bearer token.","description":"Get events based on a query","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ab29345e-04bb-4a01-964c-63511f28c09a":{"name":"event","required":false,"in":"query","description":"The event name to filter by.","schema":{"example":"Created Account","type":"string","isRequired":false,"description":"The event name to filter by.","uniqueKey":"","typeLabel":"string"}},"39f2406d-8252-4b7f-902f-0ca55fda4dda":{"name":"uuid","required":false,"in":"query","description":"The UUID to filter by.","schema":{"example":"123e4567-e89b-12d3-a456-426614174000","type":"string","isRequired":false,"description":"The UUID to filter by.","uniqueKey":"","typeLabel":"string"}},"fb4ba13c-01c6-4d5f-a9e5-e140d8201697":{"name":"userId","required":false,"in":"query","description":"The user ID to filter by.","schema":{"example":"user-123","type":"string","isRequired":false,"description":"The user ID to filter by.","uniqueKey":"","typeLabel":"string"}},"25c4072a-7ef6-4734-b16e-8ddcfe7672f3":{"name":"groupId","required":false,"in":"query","description":"The group ID to filter by.","schema":{"example":"group-456","type":"string","isRequired":false,"description":"The group ID to filter by.","uniqueKey":"","typeLabel":"string"}},"ed149547-6fb8-4268-b7be-604b7a5b199a":{"name":"anonymousId","required":false,"in":"query","description":"The anonymous ID to filter by.","schema":{"example":"anon-789","type":"string","isRequired":false,"description":"The anonymous ID to filter by.","uniqueKey":"","typeLabel":"string"}},"d21a9f37-3a40-48ef-89c0-bb306da1d1b2":{"name":"instanceId","required":false,"in":"query","description":"The instance ID to filter by.","schema":{"example":"instance-101112","type":"string","isRequired":false,"description":"The instance ID to filter by.","uniqueKey":"","typeLabel":"string"}},"32c05bf8-96b0-4968-948a-466f2809bd65":{"name":"startDate","required":false,"in":"query","description":"The start date to filter by.","schema":{"example":"2022-01-01T00:00:00Z","type":"string","isRequired":false,"description":"The start date to filter by.","uniqueKey":"","typeLabel":"string"}},"d74c18f1-31f5-44ef-bc62-331860b4ecea":{"name":"endDate","required":false,"in":"query","description":"The end date to filter by.","schema":{"example":"2022-12-31T23:59:59Z","type":"string","isRequired":false,"description":"The end date to filter by.","uniqueKey":"","typeLabel":"string"}},"90e410c3-5d65-4b14-967b-b87bbfbc12b2":{"name":"limit","required":false,"in":"query","description":"The limit of records to return.","schema":{"example":100,"type":"number","isRequired":false,"description":"The limit of records to return.","uniqueKey":"","typeLabel":"number"}},"201884cd-01d5-4ac5-ac8a-71d29fcdc6ea":{"name":"offset","required":false,"in":"query","description":"The offset of records to return.","schema":{"example":0,"type":"number","isRequired":false,"description":"The offset of records to return.","uniqueKey":"","typeLabel":"number"}},"296383b4-0008-47d7-a089-d80ee587ce05":{"name":"orderByField","required":false,"in":"query","description":"The field to order by.","schema":{"example":"timestamp","type":"string","isRequired":false,"description":"The field to order by.","uniqueKey":"","typeLabel":"string"}},"5694fc5e-600a-48f7-820b-fcb23d93b493":{"name":"orderByDirection","required":false,"in":"query","description":"The direction to order by.","schema":{"example":"ASC","enum":["ASC","DESC"],"type":"string","isRequired":false,"description":"The direction to order by.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"7bfae554-24a7-4499-94d4-0c776be47842":{"description":"The events have been successfully retrieved.","content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"oneOf":[{"type":"number","description":"The limit of the pagination.","isRequired":true,"uniqueKey":"limit.oneOf.0","typeLabel":"number"},{"type":"null","description":"The limit of the pagination.","isRequired":true,"uniqueKey":"limit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"limit","typeLabel":"number | null"},"offset":{"oneOf":[{"type":"number","description":"The offset of the pagination.","isRequired":true,"uniqueKey":"offset.oneOf.0","typeLabel":"number"},{"type":"null","description":"The offset of the pagination.","isRequired":true,"uniqueKey":"offset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"offset","typeLabel":"number | null"},"total":{"oneOf":[{"type":"number","description":"The total number of results. If `null`, the total is unknown.","isRequired":true,"uniqueKey":"total.oneOf.0","typeLabel":"number"},{"type":"null","description":"The total number of results. If `null`, the total is unknown.","isRequired":true,"uniqueKey":"total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"total","typeLabel":"number | null"},"results":{"description":"The events found based on the query.","example":[{"uuid":"123","type":"track","event":"user_signed_up","userId":"user-123","groupId":"group-456","anonymousId":"anon-789","instanceId":"instance-101112","properties":{"key":"value"}}],"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string","description":"The UUID of the event.","example":"123e4567-e89b-12d3-a456-426614174000","isRequired":true,"uniqueKey":"results.items.[INDEX].uuid","typeLabel":"string"},"type":{"type":"string","description":"The type of the event.","example":"track","isRequired":true,"uniqueKey":"results.items.[INDEX].type","typeLabel":"string"},"timestamp":{"format":"date-time","type":"string","description":"The timestamp of the event.","example":"2021-01-01T00:00:00Z","isRequired":true,"uniqueKey":"results.items.[INDEX].timestamp","typeLabel":"string\u003cdate-time>"},"anonymousId":{"type":"string","description":"The anonymous ID of the user. See [anonymousId](https://segment.com/docs/connections/spec/common/#anonymousid).","example":"guest-1234567890","uniqueKey":"results.items.[INDEX].anonymousId","typeLabel":"string"},"event":{"type":"string","description":"The event name.","example":"User SignedUp","uniqueKey":"results.items.[INDEX].event","typeLabel":"string"},"userId":{"type":"string","description":"The user ID.","example":"user-123","uniqueKey":"results.items.[INDEX].userId","typeLabel":"string"},"groupId":{"type":"string","description":"The group ID.","example":"group-456","uniqueKey":"results.items.[INDEX].groupId","typeLabel":"string"},"properties":{"type":"object","description":"The properties of the event. Only used with `type: \"track\"`.","example":{"page":"/home","referrer":"https://www.google.com"},"uniqueKey":"results.items.[INDEX].properties","typeLabel":"object"},"instanceId":{"type":"string","description":"Optional instance ID. Instance IDs are used to partition events by source. It is typically used for isolating data for the same customer. For instance, if you have a SaaS product, you may want to segment events by customer. In this case, you can set the instance ID to the customer's organizaiton ID.","example":"customer-1234567890","uniqueKey":"results.items.[INDEX].instanceId","typeLabel":"string"}},"required":["uuid","type","timestamp"],"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"}},"required":["limit","offset","total","results"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"limit":123,"offset":123,"total":123,"results":[{"uuid":"123","type":"track","event":"user_signed_up","userId":"user-123","groupId":"group-456","anonymousId":"anon-789","instanceId":"instance-101112","properties":{"key":"value"}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b22f6fd5-3338-4b38-a747-7e8fade03814":{"bearer":{"$ref":"c93dc64a-3160-4e45-9ca3-108d35dd3b01","scopes":[]}}},"servers":{}},"originalFileLocation":"swagger-spec.json"},"subdomain":"frigade-v2-docs","siteName":"Trench","title":"Get Events - Trench","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T00:43:12.905Z","originalFileLocation":"api-reference/events-get.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get events based on a query\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trench\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Events - Trench\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get events based on a query\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trench\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trench.dev/api-reference/events-get\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://frigade-v2-docs.mintlify.site/_mintlify/api/og/v2?division=Events+API\u0026amp;title=Get+Events\u0026amp;description=Get+events+based+on+a+query\u0026amp;theme=89264c7f061cc34ea92efd66\u0026amp;signature=2400913a8dde64c35912ec960833e03fbbd294c7157b67341631ea4d90ecce08\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Events - Trench\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get events based on a query\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://frigade-v2-docs.mintlify.site/_mintlify/api/og/v2?division=Events+API\u0026amp;title=Get+Events\u0026amp;description=Get+events+based+on+a+query\u0026amp;theme=89264c7f061cc34ea92efd66\u0026amp;signature=2400913a8dde64c35912ec960833e03fbbd294c7157b67341631ea4d90ecce08\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/frigade-v2-docs/wpPiPiPpDSDik3Ij/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trench\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F1FA1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trench.dev/api-reference/events-get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/events-get.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trench.dev/#organization\",\"name\":\"Trench\",\"url\":\"https://docs.trench.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/frigade-v2-docs/FxFHpZ8uaGl7Kvi_/logo/dark.svg?fit=max\u0026auto=format\u0026n=FxFHpZ8uaGl7Kvi_\u0026q=85\u0026s=0b091486c3b72ca074be6db2dca3b4b8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trench.dev#website\",\"name\":\"Trench\",\"url\":\"https://docs.trench.dev\",\"publisher\":{\"@id\":\"https://docs.trench.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trench.dev/api-reference/events-get#webpage\",\"url\":\"https://docs.trench.dev/api-reference/events-get\",\"name\":\"Get Events\",\"description\":\"Get events based on a query\",\"dateModified\":\"2026-01-07T00:43:12.905Z\",\"isPartOf\":{\"@id\":\"https://docs.trench.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trench.dev/api-reference/events-get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trench.dev/api-reference/events-get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Events API\",\"item\":\"https://docs.trench.dev/api-reference/events-create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Events\",\"item\":\"https://docs.trench.dev/api-reference/events-get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.trench.dev/api-reference/events-get#apireference\",\"headline\":\"Get Events\",\"name\":\"Get Events\",\"description\":\"Get events based on a query\",\"url\":\"https://docs.trench.dev/api-reference/events-get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trench.dev/api-reference/events-get#webpage\"},\"dateModified\":\"2026-01-07T00:43:12.905Z\",\"publisher\":{\"@id\":\"https://docs.trench.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trench.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trench\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Trench","nav":{"global":{"anchors":[{"anchor":"GitHub","href":"https://github.com/frigadehq/trench","icon":"github"},{"anchor":"Slack Community","href":"https://join.slack.com/t/trench-community/shared_invite/zt-2sjet5kh2-v31As3yC_zRIadk_AGn~3A","icon":"slack"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Self-host Quickstart","sidebarTitle":"Self-host Quickstart","href":"/quickstart"},{"title":"Cloud Quickstart","sidebarTitle":"Cloud Quickstart","href":"/cloud-quickstart"},{"title":"Contributing to Trench","sidebarTitle":"Contributing","href":"/contributing"}]},{"group":"Guides","pages":[{"title":"Grafana","sidebarTitle":"Grafana","href":"/guides/grafana"}]},{"group":"SDK and API","pages":[{"title":"JavaScript Client","href":"/client"},{"title":"API Overview","href":"/api-reference/overview"}]},{"group":"Events API","pages":[{"title":"Create Events","description":"Use `track`, `identify`, and `group` to send events to Trench.","openapi":"post /events","href":"/api-reference/events-create"},{"title":"Get Events","openapi":"get /events","href":"/api-reference/events-get"}]},{"group":"Webhooks API","pages":[{"title":"Get Webhooks","description":"Get all webhooks under your account.","openapi":"get /webhooks","href":"/api-reference/webhooks-get"},{"title":"Create Webhook","openapi":"post /webhooks","href":"/api-reference/webhooks-create"},{"title":"Delete Webhook","openapi":"delete /webhooks/{uuid}","href":"/api-reference/webhooks-delete"}]},{"group":"Query API","pages":[{"title":"Execute Queries","openapi":"post /queries","href":"/api-reference/queries-execute"}]}]}]},"basePath":"","title":"Get Events - Trench","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}