Opaque cursor returned by the previous pull page, or the raw fixed-width sequence of the last successfully processed event for recovery. Events at or before the supplied position are excluded. Omit it to begin at the earliest retained event.
When true, includes the exact number of events matching the tenant, after cursor and filter before the page limit. The count is omitted by default because it requires scanning all matches.
RFC 7644-derived event filter. Supports eq, and, or, parentheses and double-quoted strings. Example: (type eq "source.updated" and sourceId eq "products") or (type eq "segment.updated" and segmentId eq "summer-sale"). Filterable properties are listed by GET /v1/event-types. Subject filters match only events normalized after subject projection was enabled; older events are not backfilled.
Maximum string length: 4096
Response
An ordered page of tenant events and its continuation cursor.
A finite page from the ordered tenant event stream.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Occtoo Documentation","colors":{"primary":"#E36103","light":"#FA9A17","dark":"#EB8F38"},"logo":{"light":"https://mintcdn.com/occtoo/-gNJJgSF3T9V_IbQ/logo/occtoo-light.svg?fit=max\u0026auto=format\u0026n=-gNJJgSF3T9V_IbQ\u0026q=85\u0026s=21e485640a50820820a663446d883d87","dark":"https://mintcdn.com/occtoo/-gNJJgSF3T9V_IbQ/logo/occtoo-dark.svg?fit=max\u0026auto=format\u0026n=-gNJJgSF3T9V_IbQ\u0026q=85\u0026s=d127d743e86586f660c4432069ac6e7f"},"favicon":"https://mintcdn.com/occtoo/wBeHKCIOR2NPRpYE/favicon.ico?fit=max\u0026auto=format\u0026n=wBeHKCIOR2NPRpYE\u0026q=85\u0026s=2ef86d93e26a6f82f9947f1881a0e8e8","navbar":{"links":[{"href":"https://www.occtoo.com","label":"occtoo.com"}]},"footer":{"socials":{"github":"https://github.com/Occtoo","linkedin":"https://www.linkedin.com/company/occtoo"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"occtoo","hasAudioNarration":false,"actualSubdomain":"occtoo","customDomains":["docs.occtoo.com"],"gitSource":{"type":"github","owner":"occtoo","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adb5f3cb256aa4200f8bb43","collectionId":"9fb5ceeb-bec7-4a13-8fd7-bd3f632e547b","liveDeploymentHistoryId":"6adb5f3cb256aa4200f8bb43","schemaVersion":"v3"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adb5f3cb256aa4200f8bb43","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Documentation","count":131},{"language":"default","tag":"Guides","count":112},{"language":"default","tag":"Occtoo Studio","count":99},{"language":"default","tag":"API Reference","count":44},{"language":"default","tag":"Sources","count":33},{"language":"default","tag":"Configuration API","count":26},{"language":"default","tag":"Destinations","count":18},{"language":"default","tag":"Partner Zone","count":13},{"language":"default","tag":"Cards","count":13},{"language":"default","tag":"Get started","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table td:first-child>code:only-child{white-space:nowrap}.occ-hero h1,.occ-home{margin:0 auto;color:var(--occ-ink)}.occ-home{--occ-accent:rgb(var(--primary));--occ-accent-text:color-mix(in srgb, rgb(var(--primary)) 82%, #1d1916);--occ-ink:#1d1916;--occ-strong:#2c2825;--occ-muted:#565250;--occ-border:rgb(3 7 18 / 0.1);--occ-card:#ffffff;--occ-tile:rgb(var(--primary) / 0.09);--occ-panel:rgb(var(--primary) / 0.06);--occ-hover-border:rgb(var(--primary) / 0.45);--occ-on-accent:#ffffff;--occ-shadow:rgba(29, 25, 22, 0.22);max-width:72rem;padding:0 1.5rem 5rem;font-size:15px;line-height:1.55}.dark .occ-home{--occ-accent:rgb(var(--primary-light));--occ-accent-text:rgb(var(--primary-light));--occ-ink:#e5e1de;--occ-strong:#ffffff;--occ-muted:#a39d97;--occ-border:rgb(255 255 255 / 0.1);--occ-card:rgb(var(--background-dark));--occ-tile:rgb(var(--primary-light) / 0.14);--occ-panel:rgb(var(--primary-light) / 0.07);--occ-hover-border:rgb(var(--primary-light) / 0.45);--occ-on-accent:rgb(var(--background-dark));--occ-shadow:rgba(0, 0, 0, 0.55)}.occ-home a{text-decoration:none}.occ-arrow{flex:none;width:15px;height:15px}.occ-hero{text-align:center;padding:3.75rem 0 2.5rem}.occ-eyebrow{font-size:11px;font-weight:700;letter-spacing:.14em;text-transform:uppercase;color:var(--occ-accent-text);margin:0 0 1.25rem}.occ-hero h1{max-width:18ch;font-size:clamp(2.25rem,5.2vw,3.4rem);font-weight:800;letter-spacing:-.03em;line-height:1.07}.occ-dot,.occ-pill svg{color:var(--occ-accent)}.occ-hl{color:var(--occ-accent-text)}.occ-lede{max-width:44ch;margin:1.15rem auto 0;color:var(--occ-muted)}.occ-popular{display:flex;flex-wrap:wrap;align-items:center;justify-content:center;gap:.5rem;margin-top:1.65rem}.occ-pill,.occ-popular-label{font-size:12px;font-weight:600}.occ-popular-label{margin-right:.25rem;color:var(--occ-muted)}.occ-pill{display:inline-flex;align-items:center;gap:.4rem;padding:.35rem .8rem;border:1px solid var(--occ-border);border-radius:999px;background:var(--occ-card);color:var(--occ-ink);transition:border-color .15s ease,transform .15s ease}.occ-pill:hover{border-color:var(--occ-accent);transform:translateY(-1px)}.occ-pill svg{flex:none}.occ-section-head{display:flex;align-items:baseline;justify-content:space-between;gap:1rem;margin:1.1rem 0}.occ-card h3,.occ-panel-head h2,.occ-section-head h2{font-weight:700;letter-spacing:-.02em;color:var(--occ-ink)}.occ-section-head h2{margin:0;font-size:1.35rem}.occ-section-link{display:inline-flex;align-items:center;gap:.35rem;font-size:13px;font-weight:600;white-space:nowrap;color:var(--occ-accent);transition:opacity .15s ease}.occ-section-link:hover{opacity:.75}.occ-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:1rem}.occ-card{display:flex;flex-direction:column;padding:1.5rem;border:1px solid var(--occ-border);border-radius:14px;background:var(--occ-card);transition:border-color .15s ease,box-shadow .15s ease}.occ-card:hover{border-color:var(--occ-hover-border);box-shadow:0 8px 22px -14px var(--occ-shadow)}.occ-tile{--occ-tile-size:34px;display:inline-flex;align-items:center;justify-content:center;flex:none;width:var(--occ-tile-size);height:var(--occ-tile-size);border-radius:10px;background:var(--occ-tile);color:var(--occ-accent)}.occ-card .occ-tile{--occ-tile-size:44px;border-radius:12px;margin-bottom:1.25rem}.occ-card .occ-tile svg{width:22px;height:22px}.occ-card h3{margin:0 0 .5rem;font-size:17px;letter-spacing:-.01em;color:var(--occ-strong)}.occ-card p{margin:0 0 1.35rem;font-size:13.5px;line-height:1.55;color:var(--occ-muted)}.occ-card-links{margin-top:auto}.occ-sub{display:flex;align-items:center;justify-content:space-between;gap:.5rem;padding:.6rem 0;border-top:1px solid var(--occ-border);font-size:13px;font-weight:500;color:var(--occ-accent-text);transition:color .15s ease}.occ-sub .occ-arrow{opacity:.55}.occ-sub:hover{color:var(--occ-accent)}.occ-sub:hover .occ-arrow{opacity:1}.occ-panel{margin-top:1.75rem;padding:1.5rem;border:1px solid var(--occ-border);border-radius:16px;background:var(--occ-panel)}.occ-panel-head{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:1rem;margin-bottom:1.25rem}.occ-panel-head h2{margin:.35rem 0 0;font-size:1.3rem}.occ-button{display:inline-flex;align-items:center;gap:.4rem;padding:.5rem 1rem;border-radius:8px;background:var(--occ-accent);color:var(--occ-on-accent);font-size:12.5px;font-weight:700;white-space:nowrap;transition:filter .15s ease,transform .15s ease}.occ-button:hover{filter:brightness(1.07);transform:translateY(-1px)}.occ-steps{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:.85rem}.occ-step{padding:.9rem;border:1px solid var(--occ-border);border-radius:12px;background:var(--occ-card)}.occ-step-num{display:inline-flex;align-items:center;justify-content:center;width:20px;height:20px;margin-bottom:.85rem;border-radius:999px;background:var(--occ-accent);color:var(--occ-on-accent);font-size:11px;font-weight:700}.occ-footer-card h3,.occ-step h4{margin:0 0 .25rem;font-size:12.5px;font-weight:700;color:var(--occ-strong)}.occ-footer-card p,.occ-step p{margin:0;font-size:11.5px;line-height:1.45;color:var(--occ-muted)}.occ-footer-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1rem;margin-top:1.75rem}.occ-footer-card{display:flex;align-items:flex-start;gap:.75rem;padding:1rem 1.1rem;border:1px solid var(--occ-border);border-radius:14px;background:var(--occ-card);transition:border-color .15s ease}.occ-footer-card:hover{border-color:var(--occ-hover-border)}.occ-footer-card h3{margin:0 0 .15rem;font-size:13.5px}.occ-footer-card p{font-size:12px}.occ-footer-arrow{margin-left:auto;color:var(--occ-muted)}@media (max-width:900px){.occ-grid,.occ-steps{grid-template-columns:repeat(2,minmax(0,1fr))}}@media (max-width:620px){.occ-footer-grid,.occ-grid,.occ-steps{grid-template-columns:minmax(0,1fr)}.occ-hero{padding-top:2.5rem}}"}],"page":{"pagePath":"api-reference/event-delivery/pull-public-events","slug":"/api-reference/event-delivery/pull-public-events","pageMetadata":{"title":"Pull public events","description":"Reads retained events in ascending `sequence` order. Every item is a structured CloudEvent 1.0 document.\n\n**Cursor handling**\n\n- Omit `after` to start at the beginning of the retained tenant stream.\n- Persist the returned `after` cursor only after the page has been processed successfully.\n- If the cursor is lost, `after` also accepts the raw fixed-width `sequence` of the last successfully processed event.\n- A cursor identifies a position in the tenant stream, not in a filtered view. Persist the filter together with its cursor.\n\nSet `total=true` only when an exact count is required. The count covers all matching events after the supplied cursor, before the page limit is applied.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events","href":"/api-reference/event-delivery/pull-public-events","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Reads retained events in ascending \", _jsx(_components.code, {\n children: \"sequence\"\n }), \" order. Every item is a structured CloudEvent 1.0 document.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Cursor handling\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"Omit \", _jsx(_components.code, {\n children: \"after\"\n }), \" to start at the beginning of the retained tenant stream.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Persist the returned \", _jsx(_components.code, {\n children: \"after\"\n }), \" cursor only after the page has been processed successfully.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"If the cursor is lost, \", _jsx(_components.code, {\n children: \"after\"\n }), \" also accepts the raw fixed-width \", _jsx(_components.code, {\n children: \"sequence\"\n }), \" of the last successfully processed event.\"]\n }), \"\\n\", _jsx(_components.li, {\n children: \"A cursor identifies a position in the tenant stream, not in a filtered view. Persist the filter together with its cursor.\"\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Set \", _jsx(_components.code, {\n children: \"total=true\"\n }), \" only when an exact count is required. The count covers all matching events after the supplied cursor, before the page limit is applied.\"]\n })]\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{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Pull public events","description":"Reads retained events in ascending `sequence` order. Every item is a structured CloudEvent 1.0 document.\n\n**Cursor handling**\n\n- Omit `after` to start at the beginning of the retained tenant stream.\n- Persist the returned `after` cursor only after the page has been processed successfully.\n- If the cursor is lost, `after` also accepts the raw fixed-width `sequence` of the last successfully processed event.\n- A cursor identifies a position in the tenant stream, not in a filtered view. Persist the filter together with its cursor.\n\nSet `total=true` only when an exact count is required. The count covers all matching events after the supplied cursor, before the page limit is applied.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events","href":"/api-reference/event-delivery/pull-public-events","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Event delivery"],"summary":"Pull public events","description":"Reads retained events in ascending `sequence` order. Every item is a structured CloudEvent 1.0 document.\n\n**Cursor handling**\n\n- Omit `after` to start at the beginning of the retained tenant stream.\n- Persist the returned `after` cursor only after the page has been processed successfully.\n- If the cursor is lost, `after` also accepts the raw fixed-width `sequence` of the last successfully processed event.\n- A cursor identifies a position in the tenant stream, not in a filtered view. Persist the filter together with its cursor.\n\nSet `total=true` only when an exact count is required. The count covers all matching events after the supplied cursor, before the page limit is applied.","operationId":"PullPublicEvents","parameters":["f6f933a0-0488-49c1-8130-267363f9bab0","e9e5ee41-5a1c-479f-92e4-5cc6a8608197","16b53eb1-a915-4e15-98dd-9d0db1495296","68195ca8-3684-4828-bcd9-1ba1d726f4a2"],"responses":{"200":"81987527-a6b3-4bd6-b1e1-8921e58bbfc3","400":"22d4ef9f-4e98-4593-93dc-6fb98d8b2ba6","401":"042f14b1-dad7-4bba-bb04-19143c374fb5","403":"55dca8ec-416d-47f2-b89e-dca29e99856f"},"security":["f26271e7-f00e-4cb4-ade7-3d7ae23a13f9","b68eccf2-3b74-4d4a-9ec4-7eb6bf49f7ba","6045cee2-6708-423d-a2cb-87a4b3763d3b"],"x-required-permissions":["read:events"],"x-permission-match":"any","method":"get","type":"path","servers":["a6742b48-73ce-46bf-a900-54407ae27827"],"path":"/v1/events","baseUrlOptions":["https://api.occtoo.com"],"title":"Pull public events","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f6f933a0-0488-49c1-8130-267363f9bab0":{"name":"after","in":"query","description":"Opaque cursor returned by the previous pull page, or the raw fixed-width `sequence` of the last successfully processed event for recovery. Events at or before the supplied position are excluded. Omit it to begin at the earliest retained event.","schema":{"type":"string","description":"Opaque cursor returned by the previous pull page, or the raw fixed-width `sequence` of the last successfully processed event for recovery. Events at or before the supplied position are excluded. Omit it to begin at the earliest retained event.","uniqueKey":"","typeLabel":"string"},"example":"MDAzLjAwMDAwMDAwMDAwMDAwMTg0NDY3"},"e9e5ee41-5a1c-479f-92e4-5cc6a8608197":{"name":"limit","in":"query","description":"Maximum number of events to return. The default is 100 and the maximum is 1,000.","schema":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","format":"int32","default":100,"description":"Maximum number of events to return. The default is 100 and the maximum is 1,000.","uniqueKey":"oneOf.0","typeLabel":"integer\u003cint32>"},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","format":"int32","default":100,"description":"Maximum number of events to return. The default is 100 and the maximum is 1,000.","uniqueKey":"oneOf.1","typeLabel":"string\u003cint32>"}],"uniqueKey":"","typeLabel":"integer\u003cint32> | string\u003cint32>"},"example":100},"16b53eb1-a915-4e15-98dd-9d0db1495296":{"name":"total","in":"query","description":"When true, includes the exact number of events matching the tenant, after cursor and filter before the page limit. The count is omitted by default because it requires scanning all matches.","schema":{"type":"boolean","default":false,"description":"When true, includes the exact number of events matching the tenant, after cursor and filter before the page limit. The count is omitted by default because it requires scanning all matches.","uniqueKey":"","typeLabel":"boolean"},"example":true},"68195ca8-3684-4828-bcd9-1ba1d726f4a2":{"name":"filter","in":"query","description":"RFC 7644-derived event filter. Supports eq, and, or, parentheses and double-quoted strings. Example: (type eq \"source.updated\" and sourceId eq \"products\") or (type eq \"segment.updated\" and segmentId eq \"summer-sale\"). Filterable properties are listed by GET /v1/event-types. Subject filters match only events normalized after subject projection was enabled; older events are not backfilled.","schema":{"maxLength":4096,"type":"string","description":"RFC 7644-derived event filter. Supports eq, and, or, parentheses and double-quoted strings. Example: (type eq \"source.updated\" and sourceId eq \"products\") or (type eq \"segment.updated\" and segmentId eq \"summer-sale\"). Filterable properties are listed by GET /v1/event-types. Subject filters match only events normalized after subject projection was enabled; older events are not backfilled.","uniqueKey":"","typeLabel":"string"},"example":"(type eq \"source.updated\" and sourceId eq \"products\") or (type eq \"segment.updated\" and segmentId eq \"summer-sale\")","x-occtoo-filter-dialect":"rfc7644-subset","x-occtoo-filter-operators":["eq","and","or"],"x-occtoo-filterable-properties":["apiVersion","apiVersionId","cardDefinitionId","destinationId","endpointId","segmentDefinitionId","segmentId","sourceId","subject","userId"]}},"responses":{"81987527-a6b3-4bd6-b1e1-8921e58bbfc3":{"description":"An ordered page of tenant events and its continuation cursor.","content":{"application/json":{"schema":{"required":["items","after","hasMore"],"type":"object","properties":{"items":{"type":"array","items":{"required":["specversion","id","type","source","subject","datacontenttype","dataschema","sequence","tenantid","data"],"type":"object","properties":{"specversion":{"type":"string","description":"CloudEvents specification version.","example":"1.0","isRequired":true,"uniqueKey":"\\items.items.[INDEX].specversion","typeLabel":"string"},"id":{"type":"string","description":"Deterministic UUIDv5 idempotency key.","format":"uuid","example":"0197a2b4-7c1e-59f3-a8d4-1b2c3d4e5f60","isRequired":true,"uniqueKey":"\\items.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","description":"Stable, unversioned event type.","example":"source.updated","isRequired":true,"uniqueKey":"\\items.items.[INDEX].type","typeLabel":"string"},"source":{"type":"string","description":"Tenant-relative resource path that produced the event.","example":"/sources/products","isRequired":true,"uniqueKey":"\\items.items.[INDEX].source","typeLabel":"string"},"subject":{"type":"string","description":"Entity key within the source resource.","example":"products","isRequired":true,"uniqueKey":"\\items.items.[INDEX].subject","typeLabel":"string"},"datacontenttype":{"type":"string","description":"Media type of `data`.","example":"application/json","isRequired":true,"uniqueKey":"\\items.items.[INDEX].datacontenttype","typeLabel":"string"},"dataschema":{"type":"string","description":"Immutable versioned JSON Schema URL for `data`.","format":"uri","example":"https://api.occtoo.com/v1/events/schemas/source.updated/1.0","isRequired":true,"uniqueKey":"\\items.items.[INDEX].dataschema","typeLabel":"string\u003curi>"},"sequence":{"type":"string","description":"Fixed-width tenant stream position and SSE event id.","example":"003.00000000000000184467","isRequired":true,"uniqueKey":"\\items.items.[INDEX].sequence","typeLabel":"string"},"tenantid":{"type":"string","description":"Occtoo tenant identifier included for multi-tenant consumers.","format":"uuid","example":"9f3c2a10-2e2e-4e67-b941-89e8d3190c47","isRequired":true,"uniqueKey":"\\items.items.[INDEX].tenantid","typeLabel":"string\u003cuuid>"},"data":{"type":"object","description":"Event-specific payload validated by `dataschema`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].data","typeLabel":"object"},"time":{"type":"string","description":"UTC time at which the domain change occurred when supplied by the source event. This optional field is never synthesized from delivery or processing time.","format":"date-time","example":"2026-07-04T09:15:12.345Z","uniqueKey":"\\items.items.[INDEX].time","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"description":"Customer-safe CloudEvents 1.0 envelope returned by both delivery transports.","uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"description":"Structured CloudEvents in ascending `sequence` order.","isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"after":{"type":"string","description":"Opaque continuation cursor to send with the next request.","example":"MDAzLjAwMDAwMDAwMDAwMDAwMTg0NDY3","isRequired":true,"uniqueKey":"after","typeLabel":"string"},"hasMore":{"type":"boolean","description":"Whether another matching event was available when this page was read.","example":true,"isRequired":true,"uniqueKey":"hasMore","typeLabel":"boolean"},"total":{"oneOf":[{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"null","description":"Exact matching count when `total=true`; omitted otherwise.","format":"int64","example":42,"uniqueKey":"total.oneOf.0","typeLabel":"null"},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"integer","description":"Exact matching count when `total=true`; omitted otherwise.","format":"int64","example":42,"uniqueKey":"total.oneOf.1","typeLabel":"integer\u003cint64>"},{"pattern":"^-?(?:0|[1-9]\\d*)$","type":"string","description":"Exact matching count when `total=true`; omitted otherwise.","format":"int64","example":42,"uniqueKey":"total.oneOf.2","typeLabel":"string\u003cint64>"}],"uniqueKey":"total","typeLabel":"null | integer\u003cint64> | string\u003cint64>"}},"description":"A finite page from the ordered tenant event stream.","uniqueKey":"","typeLabel":"object"},"examples":{"matchingEvents":{"title":"matchingEvents","value":{"items":[{"specversion":"1.0","id":"0197a2b4-7c1e-59f3-a8d4-1b2c3d4e5f60","type":"source.updated","source":"/sources/products","subject":"products","time":"2026-07-04T09:15:12.345Z","datacontenttype":"application/json","dataschema":"https://api.occtoo.com/v1/events/schemas/source.updated/1.0","sequence":"003.00000000000000184467","tenantid":"9f3c2a10-2e2e-4e67-b941-89e8d3190c47","data":{"sourceId":"products","changes":["settings"],"correlationIds":["0197a2b4-56bb-7b38-b82c-33b55b61ef2a"]}}],"after":"MDAzLjAwMDAwMDAwMDAwMDAwMTg0NDY3","hasMore":true,"total":42}},"emptyPage":{"title":"emptyPage","value":{"items":[],"after":"MDAzLjAwMDAwMDAwMDAwMDAwMTg0NDY3","hasMore":false}}},"exampleType":"examples"}},"exampleType":"examples"},"22d4ef9f-4e98-4593-93dc-6fb98d8b2ba6":{"description":"The cursor, limit or filter expression is invalid.","content":{"application/json":{"schema":{"required":["message"],"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalidFilter":{"title":"invalidFilter","value":{"message":"Property 'entryId' is not filterable."}}},"exampleType":"examples"}},"exampleType":"examples"},"042f14b1-dad7-4bba-bb04-19143c374fb5":{"description":"The credential is missing, invalid or does not identify an Occtoo tenant.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"55dca8ec-416d-47f2-b89e-dca29e99856f":{"description":"Forbidden","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"f26271e7-f00e-4cb4-ade7-3d7ae23a13f9":{"kindeOAuth":{"type":"oauth2","description":"Sign in with the existing Occtoo Studio identity and selected organization.","flows":{"authorizationCode":{"authorizationUrl":"https://auth.occtoo.com/oauth2/auth?audience=https%3A%2F%2Fapi-weu.occtoo.com","tokenUrl":"https://auth.occtoo.com/oauth2/token","scopes":{"openid":"Authenticate the user with OpenID Connect.","profile":"Read the user's basic profile.","email":"Read the user's email address.","offline":"Refresh the access token without another interactive sign-in."},"x-usePkce":"SHA-256","x-scalar-redirect-uri":"https://api.occtoo.com/docs/"}},"scopes":[],"schemeName":"kindeOAuth"}},"b68eccf2-3b74-4d4a-9ec4-7eb6bf49f7ba":{"bearerAuth":{"type":"http","description":"Tenant-scoped Occtoo access token, including Kinde machine-to-machine application tokens.","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}},"6045cee2-6708-423d-a2cb-87a4b3763d3b":{"apiKey":{"type":"apiKey","description":"Occtoo organization API key.","name":"x-api-key","in":"header","scopes":[],"schemeName":"apiKey"}}},"servers":{"a6742b48-73ce-46bf-a900-54407ae27827":{"url":"https://api.occtoo.com","description":"Occtoo public API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","description":"Sign in with the existing Occtoo Studio identity and selected organization.","flows":{"authorizationCode":{"authorizationUrl":"https://auth.occtoo.com/oauth2/auth?audience=https%3A%2F%2Fapi-weu.occtoo.com","tokenUrl":"https://auth.occtoo.com/oauth2/token","scopes":{"openid":"Authenticate the user with OpenID Connect.","profile":"Read the user's basic profile.","email":"Read the user's email address.","offline":"Refresh the access token without another interactive sign-in."},"x-usePkce":"SHA-256","x-scalar-redirect-uri":"https://api.occtoo.com/docs/"}},"scopes":[],"schemeName":"kindeOAuth"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"Sign in with the existing Occtoo Studio identity and selected organization.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"kindeOAuth","name":"Authorization"}],"title":"kindeOAuth"},{"schemes":[{"scheme":{"type":"http","description":"Tenant-scoped Occtoo access token, including Kinde machine-to-machine application tokens.","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Tenant-scoped Occtoo access token, including Kinde machine-to-machine application tokens.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","description":"Occtoo organization API key.","name":"x-api-key","in":"header","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","description":"Occtoo organization API key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi/events.json"},"subdomain":"occtoo","siteName":"Occtoo Documentation","title":"Pull public events - Occtoo Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-07T12:08:19.128Z","originalFileLocation":"api-reference/event-delivery/pull-public-events.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;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=\"system\"}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=\"Reads retained events in ascending sequence order. Every item is a structured CloudEvent 1.0 document. Cursor handling - Omit after to start at the beginning of the retained tenant stream. - Persist the returned after cursor only after the page has been processed successfully. - If the cursor is lost, after also accepts the raw fixed-width sequence of the last successfully processed event. - A cursor identifies a position in the tenant stream, not in a filtered view. Persist the filter together with its cursor. Set total=true only when an exact count is required. The count covers all matching events after the supplied cursor, before the page limit is applied.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Occtoo Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_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/occtoo/7xHmPomztRvrPxPl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Pull public events - Occtoo Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Reads retained events in ascending sequence order. Every item is a structured CloudEvent 1.0 document. Cursor handling - Omit after to start at the beginning of the retained tenant stream. - Persist the returned after cursor only after the page has been processed successfully. - If the cursor is lost, after also accepts the raw fixed-width sequence of the last successfully processed event. - A cursor identifies a position in the tenant stream, not in a filtered view. Persist the filter together with its cursor. Set total=true only when an exact count is required. The count covers all matching events after the supplied cursor, before the page limit is applied.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Occtoo Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://occtoo.mintlify.app/_mintlify/api/og/v2?division=Events+API\u0026amp;title=Pull+public+events\u0026amp;description=Reads+retained+events+in+ascending+%60sequence%60+order.+Every+item+is+a+structured+CloudEvent+1.0+document.%0A%0A**Cursor+handling**%0A%0A-+Omit+%60after%60+to+start+at+the+be\u0026amp;theme=088d609b25a5d30f2fe21826\u0026amp;signature=d6921738fedfd839c239e8e0071af06e81bb99d24a386630bff6c69632bbbe80\">\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=\"Pull public events - Occtoo Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Reads retained events in ascending sequence order. Every item is a structured CloudEvent 1.0 document. Cursor handling - Omit after to start at the beginning of the retained tenant stream. - Persist the returned after cursor only after the page has been processed successfully. - If the cursor is lost, after also accepts the raw fixed-width sequence of the last successfully processed event. - A cursor identifies a position in the tenant stream, not in a filtered view. Persist the filter together with its cursor. Set total=true only when an exact count is required. The count covers all matching events after the supplied cursor, before the page limit is applied.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://occtoo.mintlify.app/_mintlify/api/og/v2?division=Events+API\u0026amp;title=Pull+public+events\u0026amp;description=Reads+retained+events+in+ascending+%60sequence%60+order.+Every+item+is+a+structured+CloudEvent+1.0+document.%0A%0A**Cursor+handling**%0A%0A-+Omit+%60after%60+to+start+at+the+be\u0026amp;theme=088d609b25a5d30f2fe21826\u0026amp;signature=d6921738fedfd839c239e8e0071af06e81bb99d24a386630bff6c69632bbbe80\">\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/occtoo/7xHmPomztRvrPxPl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Occtoo Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E36103\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/event-delivery/pull-public-events.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.occtoo.com/#organization\",\"name\":\"Occtoo Documentation\",\"url\":\"https://docs.occtoo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/occtoo/-gNJJgSF3T9V_IbQ/logo/occtoo-light.svg?fit=max\u0026auto=format\u0026n=-gNJJgSF3T9V_IbQ\u0026q=85\u0026s=21e485640a50820820a663446d883d87\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.occtoo.com#website\",\"name\":\"Occtoo Documentation\",\"url\":\"https://docs.occtoo.com\",\"publisher\":{\"@id\":\"https://docs.occtoo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events#webpage\",\"url\":\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events\",\"name\":\"Pull public events\",\"description\":\"Reads retained events in ascending sequence order. Every item is a structured CloudEvent 1.0 document. Cursor handling - Omit after to start at the beginning of the retained tenant stream. - Persist the returned after cursor only after the page has been processed successfully. - If the cursor is lost, after also accepts the raw fixed-width sequence of the last successfully processed event. - A cursor identifies a position in the tenant stream, not in a filtered view. Persist the filter together with its cursor. Set total=true only when an exact count is required. The count covers all matching events after the supplied cursor, before the page limit is applied.\",\"dateModified\":\"2026-10-07T12:08:19.128Z\",\"isPartOf\":{\"@id\":\"https://docs.occtoo.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Events API\",\"item\":\"https://docs.occtoo.com/api-reference/events/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Pull public events\",\"item\":\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events#apireference\",\"headline\":\"Pull public events\",\"name\":\"Pull public events\",\"description\":\"Reads retained events in ascending sequence order. Every item is a structured CloudEvent 1.0 document. Cursor handling - Omit after to start at the beginning of the retained tenant stream. - Persist the returned after cursor only after the page has been processed successfully. - If the cursor is lost, after also accepts the raw fixed-width sequence of the last successfully processed event. - A cursor identifies a position in the tenant stream, not in a filtered view. Persist the filter together with its cursor. Set total=true only when an exact count is required. The count covers all matching events after the supplied cursor, before the page limit is applied.\",\"url\":\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events\",\"mainEntityOfPage\":{\"@id\":\"https://docs.occtoo.com/api-reference/event-delivery/pull-public-events#webpage\"},\"dateModified\":\"2026-10-07T12:08:19.128Z\",\"publisher\":{\"@id\":\"https://docs.occtoo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.occtoo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Occtoo Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Occtoo Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/get-started/introduction"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Getting started","pages":[{"title":"API overview","href":"/api-reference/overview"}]},{"group":"Application authentication","pages":[{"title":"Request an Application access token","sidebarTitle":"Application access token","openapi":"api-reference/openapi/applications.json POST /oauth2/token","playground":"interactive","href":"/api-reference/authentication/application-token"}]},{"group":"Ingest API","pages":[{"title":"Ingest","href":"/api-reference/ingest/overview"},{"title":"Ingest typed JSON into a source","deprecated":null,"version":null,"sidebarTitle":"Typed source entries","tag":"NEW","openapi":"/api-reference/openapi/ingest.json post /v1/sources/{sourceId}","href":"/api-reference/ingest/typed-source-entries"},{"title":"Read source entries by ID","deprecated":null,"version":null,"sidebarTitle":"Read source entries","openapi":"/api-reference/openapi/ingest.json get /v1/sources/{sourceId}/entries","href":"/api-reference/ingest/read-source-entries"},{"title":"Read a typed source entry","deprecated":null,"version":null,"sidebarTitle":"Read source entry","openapi":"/api-reference/openapi/ingest.json get /v1/sources/{sourceId}/entries/{entryId}","href":"/api-reference/ingest/read-source-entry"},{"title":"Start an asynchronous ingest","deprecated":true,"version":null,"openapi":"/api-reference/openapi/ingest.json post /datasources/{dataSource}/import","href":"/api-reference/ingest/start-an-asynchronous-ingest"}]},{"group":"Events API","pages":[{"title":"Events","href":"/api-reference/events/overview"},{"title":"List public event types and schema versions","description":"Returns the public event catalog. Each entry identifies a stable event `type`, its current payload schema version, the immutable JSON Schema URL, and the envelope subject and data properties accepted by the filter grammar.\n\nCache the catalog briefly and resolve payload contracts through `schemaUrl`. Event type names do not contain a schema version.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/event-types","href":"/api-reference/event-discovery/list-public-event-types-and-schema-versions"},{"title":"Pull public events","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events","href":"/api-reference/event-delivery/pull-public-events"},{"title":"Get public event stream metadata","description":"Returns metadata for retained events matching the optional `filter`: the first and latest positions, their optional CloudEvent `time`, and the exact retained count.\n\n`after` is the opaque pull cursor for `latest`. `first`, `latest`, and `after` are null when no retained event matches, while `total` is zero. Compare `latest.sequence` with the last processed sequence to detect whether a consumer is caught up. Sequence gaps do not equal a count of pending matching events, and `total` counts the complete retained filtered view rather than events after a consumer checkpoint.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events/metadata","href":"/api-reference/event-delivery/get-public-event-stream-metadata"},{"title":"Stream public events using SSE","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events/stream","href":"/api-reference/event-delivery/stream-public-events-using-sse"},{"title":"Get a versioned event data schema","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json get /v1/events/schemas/{type}/{version}","href":"/api-reference/event-schemas/get-a-versioned-event-data-schema"},{"title":"Event stream (SSE)","href":"/api-reference/events/streaming"},{"title":"Durable consumers","href":"/api-reference/events/durable-consumers"},{"title":"Pull the next leased batch of events","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json post /v1/event-destinations/{id}/pull","href":"/api-reference/event-delivery/pull-the-next-leased-batch-of-events"},{"title":"Acknowledge a leased batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi/events.json post /v1/event-destinations/{id}/acknowledge","href":"/api-reference/event-delivery/acknowledge-a-leased-batch"}]},{"group":"Configuration API","pages":[{"title":"Configuration","href":"/api-reference/configuration/overview"},{"group":"Sources","pages":[{"title":"List sources","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/sources","href":"/api-reference/sources/list-sources"},{"title":"Create a source","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json post /v1/sources","href":"/api-reference/sources/create-a-source"},{"title":"Get a source","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/sources/{sourceId}","href":"/api-reference/sources/get-a-source"},{"title":"Update source metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json patch /v1/sources/{sourceId}","href":"/api-reference/sources/update-source-metadata"},{"title":"Delete a source","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/sources/{sourceId}","href":"/api-reference/sources/delete-a-source"},{"title":"List source properties","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/sources/{sourceId}/properties","href":"/api-reference/sources/list-source-properties"},{"title":"Get a source property","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/sources/{sourceId}/properties/{propertyId}","href":"/api-reference/sources/get-a-source-property"},{"title":"Create or update a source property","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json put /v1/sources/{sourceId}/properties/{propertyId}","href":"/api-reference/sources/create-or-update-a-source-property"},{"title":"Delete a source property","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/sources/{sourceId}/properties/{propertyId}","href":"/api-reference/sources/delete-a-source-property"}]},{"group":"Applications","pages":[{"title":"List applications","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/applications","href":"/api-reference/applications/list-applications"},{"title":"Create an application","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json post /v1/applications","href":"/api-reference/applications/create-an-application"},{"title":"Discover application access options","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/applications/access-catalog","href":"/api-reference/applications/discover-application-access-options"},{"title":"Get an application","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/applications/{applicationId}","href":"/api-reference/applications/get-an-application"},{"title":"Replace application settings and access","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json put /v1/applications/{applicationId}","href":"/api-reference/applications/replace-application-settings-and-access"},{"title":"Delete an application and revoke its credentials","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/applications/{applicationId}","href":"/api-reference/applications/delete-an-application-and-revoke-its-credentials"}]},{"group":"Managed tags","pages":[{"title":"List managed tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/managed-tags","href":"/api-reference/managed-tags/list-managed-tags"},{"title":"Create a managed tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json post /v1/managed-tags","href":"/api-reference/managed-tags/create-a-managed-tag"},{"title":"Get a managed tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/managed-tags/{managedTagId}","href":"/api-reference/managed-tags/get-a-managed-tag"},{"title":"Replace managed tag settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json put /v1/managed-tags/{managedTagId}","href":"/api-reference/managed-tags/replace-managed-tag-settings"},{"title":"Delete a managed tag and its values","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/managed-tags/{managedTagId}","href":"/api-reference/managed-tags/delete-a-managed-tag-and-its-values"},{"title":"List managed tag values","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/managed-tags/{managedTagId}/values","href":"/api-reference/managed-tag-values/list-managed-tag-values"},{"title":"Create a managed tag value","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json post /v1/managed-tags/{managedTagId}/values","href":"/api-reference/managed-tag-values/create-a-managed-tag-value"},{"title":"Get a managed tag value","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json get /v1/managed-tags/{managedTagId}/values/{key}","href":"/api-reference/managed-tag-values/get-a-managed-tag-value"},{"title":"Replace a managed tag value","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json put /v1/managed-tags/{managedTagId}/values/{key}","href":"/api-reference/managed-tag-values/replace-a-managed-tag-value"},{"title":"Delete a managed tag value","deprecated":null,"version":null,"openapi":"/api-reference/openapi/configuration.json delete /v1/managed-tags/{managedTagId}/values/{key}","href":"/api-reference/managed-tag-values/delete-a-managed-tag-value"}]}]},{"group":"Data consumption","pages":[{"title":"Destination","href":"/api-reference/consumption/overview"}]}]},{"tab":"Integrations","icon":"plug","hidden":true,"pages":[{"title":"Integrations","href":"/integrations/providers/overview"}]},{"tab":"Changelog","icon":"list-check","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Announcements","icon":"bullhorn","pages":[{"title":"Announcements","href":"/announcements/overview"}]}]},"title":"Pull public events - Occtoo Documentation","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}