URL-encode the cursor value when it contains | or other special characters.Stop when has_more is false or next_cursor is absent.
Paginating views and messages
The same pattern applies to:
GET /public/v1/views — default limit=50
GET /public/v1/tickets/:ticketNumber/messages — default limit=30, use order=asc for chronological threads
GET /public/v1/tickets/:ticketNumber/events — default limit=100, maximum 500, always oldest first
Anti-pattern — offset polling loops
Do not simulate pages with incrementing offsets or re-fetch page 1 in a tight loop:
# ❌ Wrong — v1 has no offset/page parameterGET /public/v1/tickets?page=2# ❌ Wrong — wasteful and may miss or duplicate rows under concurrent writeswhile true; do GET /public/v1/tickets?limit=40; sleep 1; done
Cursors are opaque and tied to the sort order (created_at desc for tickets). Do not parse or construct cursors manually — always use the value returned by the API.If a cursor expires or becomes invalid, start a fresh list request without cursor.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Chatarmin CX Docs","colors":{"primary":"#4361ee","light":"#4361ee","dark":"#4361ee"},"logo":{"light":"https://mintcdn.com/chatarmincom/A54BHt_5VfpG_omm/logo/armin-cx-logo-new.svg?fit=max\u0026auto=format\u0026n=A54BHt_5VfpG_omm\u0026q=85\u0026s=117961a02f1919fccd0ff384f0498b37","dark":"https://mintcdn.com/chatarmincom/A54BHt_5VfpG_omm/logo/armin-cx-logo-new.svg?fit=max\u0026auto=format\u0026n=A54BHt_5VfpG_omm\u0026q=85\u0026s=117961a02f1919fccd0ff384f0498b37"},"favicon":"https://mintcdn.com/chatarmincom/A54BHt_5VfpG_omm/favicon.svg?fit=max\u0026auto=format\u0026n=A54BHt_5VfpG_omm\u0026q=85\u0026s=a476e623eb449a6cb9ae442291dd59a4","appearance":{"default":"system"},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/chatarmin-com"}},"seo":{"metatags":{"og:image":"/logo/armin-cx-logo-new.svg"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"mailto:support@chatarmin.com","label":"Support"},{"href":"https://api.armin.cx/docs/v1","label":"API reference"}],"primary":{"type":"button","label":"Dashboard","href":"https://armin.cx/signin"}},"href":"introduction"},{"language":"de","navbar":{"links":[{"href":"mailto:support@chatarmin.com","label":"Support"},{"href":"https://api.armin.cx/docs/v1","label":"API-Referenz"}],"primary":{"type":"button","label":"Dashboard","href":"https://armin.cx/signin"}},"href":"de/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chatarmincom","hasAudioNarration":false,"actualSubdomain":"chatarmincom","customDomains":["docs.armin.cx"],"gitSource":{"type":"github","owner":"chatarmin-com","repo":"cx","deployBranch":"main","contentDirectory":"mintlify-docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aff044ba79a2a42f499e620","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Guides","count":112},{"language":"de","tag":"Anleitungen","count":112},{"language":"en","tag":"Integrations","count":54},{"language":"de","tag":"Integrationen","count":54},{"language":"en","tag":"API","count":17},{"language":"de","tag":"API","count":17},{"language":"en","tag":"AI Agents","count":16},{"language":"en","tag":"Public API v1","count":16},{"language":"de","tag":"KI-Agenten","count":16},{"language":"de","tag":"Public API v1","count":16},{"language":"en","tag":"Channels","count":12},{"language":"en","tag":"Inbox","count":12},{"language":"de","tag":"Kanäle","count":12},{"language":"de","tag":"Posteingang","count":12},{"language":"en","tag":"Ticket import","count":10},{"language":"de","tag":"Ticket-Import","count":10},{"language":"en","tag":"Settings","count":6},{"language":"de","tag":"Einstellungen","count":6},{"language":"en","tag":"Troubleshooting","count":5},{"language":"de","tag":"Fehlerbehebung","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":""}]}
{"page":{"pagePath":"api/pagination","slug":"/api/pagination","pageMetadata":{"title":"Pagination","description":"Cursor-based pagination for ticket, view, and message lists.","icon":"list","href":"/api/pagination"},"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: \"Cursor-based pagination for ticket, view, and message lists.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`All Public API v1 list endpoints use `,_jsx(_components.strong,{children:`cursor pagination`}),`. There is no `,_jsx(_components.code,{children:`page`}),` or `,_jsx(_components.code,{children:`offset`}),` parameter.`]}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Param`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Max`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`limit`})}),_jsx(_components.td,{children:`40 (tickets), 50 (views), 30 (messages)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`100`}),_jsx(_components.td,{children:`Page size`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cursor`})}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Opaque token from the previous response`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response-shape`,children:`Response shape`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [ `}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`...`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pagination\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"has_more\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"next_cursor\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-20T10:00:00.000Z|019b0e3d-e88a-715c-b540-ea11ac058052\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`has_more`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` if another page exists`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`next_cursor`})}),_jsxs(_components.td,{children:[`Pass as `,_jsx(_components.code,{children:`cursor`}),` on the next request; omitted or `,_jsx(_components.code,{children:`null`}),` when done`]})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Ticket list responses do `,_jsx(_components.strong,{children:`not`}),` include a total count. Use `,_jsx(_components.code,{children:`count`}),` on a saved view from `,_jsx(_components.code,{children:`GET /views`}),` when you need “how many tickets match this filter?”`]})}),`\n`,_jsx(Heading,{level:`2`,id:`walkthrough-—-paginate-tickets`,children:`Walkthrough — paginate tickets`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Page 1:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sS`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"cx-api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.armin.cx/public/v1/tickets?limit=40\"`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Page 2`}),` (use `,_jsx(_components.code,{children:`next_cursor`}),` from page 1):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sS`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"cx-api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.armin.cx/public/v1/tickets?limit=40\u0026cursor=2026-07-20T10:00:00.000Z%7C019b...\"`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`URL-encode the cursor value when it contains `,_jsx(_components.code,{children:`|`}),` or other special characters.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Stop`}),` when `,_jsx(_components.code,{children:`has_more`}),` is `,_jsx(_components.code,{children:`false`}),` or `,_jsx(_components.code,{children:`next_cursor`}),` is absent.`]}),`\n`,_jsx(Heading,{level:`2`,id:`paginating-views-and-messages`,children:`Paginating views and messages`}),`\n`,_jsx(_components.p,{children:`The same pattern applies to:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /public/v1/views`}),` — default `,_jsx(_components.code,{children:`limit=50`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /public/v1/tickets/:ticketNumber/messages`}),` — default `,_jsx(_components.code,{children:`limit=30`}),`, use `,_jsx(_components.code,{children:`order=asc`}),` for chronological threads`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /public/v1/tickets/:ticketNumber/events`}),` — default `,_jsx(_components.code,{children:`limit=100`}),`, maximum `,_jsx(_components.code,{children:`500`}),`, always oldest first`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`anti-pattern-—-offset-polling-loops`,children:`Anti-pattern — offset polling loops`}),`\n`,_jsxs(_components.p,{children:[`Do `,_jsx(_components.strong,{children:`not`}),` simulate pages with incrementing offsets or re-fetch page 1 in a tight loop:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# ❌ Wrong — v1 has no offset/page parameter`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /public/v1/tickets?page=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# ❌ Wrong — wasteful and may miss or duplicate rows under concurrent writes`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`while`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`; `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`do`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /public/v1/tickets?limit=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`40`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`; `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sleep`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`; `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`done`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Instead:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Store `,_jsx(_components.code,{children:`next_cursor`}),` from each response.`]}),`\n`,_jsxs(_components.li,{children:[`Request the next page only when `,_jsx(_components.code,{children:`has_more`}),` is `,_jsx(_components.code,{children:`true`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Back off on `,_jsx(_components.a,{href:`/api/rate-limits`,children:`rate limits`}),` (`,_jsx(_components.code,{children:`429`}),`).`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`cursor-stability`,children:`Cursor stability`}),`\n`,_jsxs(_components.p,{children:[`Cursors are opaque and tied to the sort order (`,_jsx(_components.code,{children:`created_at`}),` desc for tickets). Do not parse or construct cursors manually — always use the value returned by the API.`]}),`\n`,_jsxs(_components.p,{children:[`If a cursor expires or becomes invalid, start a fresh list request without `,_jsx(_components.code,{children:`cursor`}),`.`]})]})}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":"Pagination","description":"Cursor-based pagination for ticket, view, and message lists.","icon":"list","href":"/api/pagination"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Parameters","slug":"parameters","depth":2,"children":[]},{"title":"Response shape","slug":"response-shape","depth":2,"children":[]},{"title":"Walkthrough — paginate tickets","slug":"walkthrough-—-paginate-tickets","depth":2,"children":[]},{"title":"Paginating views and messages","slug":"paginating-views-and-messages","depth":2,"children":[]},{"title":"Anti-pattern — offset polling loops","slug":"anti-pattern-—-offset-polling-loops","depth":2,"children":[]},{"title":"Cursor stability","slug":"cursor-stability","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"chatarmincom","siteName":"Chatarmin CX Docs","title":"Pagination - Chatarmin CX Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api/pagination","matchLevel":0},"de":{"href":"/de/api/pagination","matchLevel":1}}},"lastModified":"2026-11-18T08:23:08.298Z","originalFileLocation":"api/pagination.mdx","locale":"en"},"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=\"Cursor-based pagination for ticket, view, and message lists.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Chatarmin CX Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chatarmincom/MzrWBgXuR1l62BeB/_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/chatarmincom/MzrWBgXuR1l62BeB/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chatarmincom/MzrWBgXuR1l62BeB/_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/chatarmincom/MzrWBgXuR1l62BeB/_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/chatarmincom/MzrWBgXuR1l62BeB/_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/chatarmincom/MzrWBgXuR1l62BeB/_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/chatarmincom/MzrWBgXuR1l62BeB/_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/chatarmincom/MzrWBgXuR1l62BeB/_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/chatarmincom/MzrWBgXuR1l62BeB/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Pagination - Chatarmin CX Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cursor-based pagination for ticket, view, and message lists.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chatarmin CX Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.armin.cx/api/pagination\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chatarmincom.mintlify.site/logo/armin-cx-logo-new.svg\">\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=\"Pagination - Chatarmin CX Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cursor-based pagination for ticket, view, and message lists.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chatarmincom.mintlify.site/logo/armin-cx-logo-new.svg\">\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/chatarmincom/MzrWBgXuR1l62BeB/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chatarmin CX Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4361ee\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.armin.cx/api/pagination\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/pagination.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.armin.cx/api/pagination\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.armin.cx/de/api/pagination\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.armin.cx/api/pagination\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.armin.cx/#organization\",\"name\":\"Chatarmin CX Docs\",\"url\":\"https://docs.armin.cx\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chatarmincom/A54BHt_5VfpG_omm/logo/armin-cx-logo-new.svg?fit=max\u0026auto=format\u0026n=A54BHt_5VfpG_omm\u0026q=85\u0026s=117961a02f1919fccd0ff384f0498b37\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.armin.cx#website\",\"name\":\"Chatarmin CX Docs\",\"url\":\"https://docs.armin.cx\",\"publisher\":{\"@id\":\"https://docs.armin.cx/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.armin.cx/api/pagination#webpage\",\"url\":\"https://docs.armin.cx/api/pagination\",\"name\":\"Pagination\",\"description\":\"Cursor-based pagination for ticket, view, and message lists.\",\"dateModified\":\"2026-11-18T08:23:08.298Z\",\"isPartOf\":{\"@id\":\"https://docs.armin.cx#website\"},\"breadcrumb\":{\"@id\":\"https://docs.armin.cx/api/pagination#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.armin.cx/api/pagination#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Public API v1\",\"item\":\"https://docs.armin.cx/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Pagination\",\"item\":\"https://docs.armin.cx/api/pagination\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.armin.cx/api/pagination#article\",\"headline\":\"Pagination\",\"name\":\"Pagination\",\"description\":\"Cursor-based pagination for ticket, view, and message lists.\",\"url\":\"https://docs.armin.cx/api/pagination\",\"mainEntityOfPage\":{\"@id\":\"https://docs.armin.cx/api/pagination#webpage\"},\"image\":\"https://docs.armin.cx/logo/armin-cx-logo-new.svg\",\"dateModified\":\"2026-11-18T08:23:08.298Z\",\"publisher\":{\"@id\":\"https://docs.armin.cx/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.armin.cx#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chatarmin CX Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Chatarmin CX Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/pagination.md","siteName":"Chatarmin CX Docs","nav":{"global":{"anchors":[]},"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"mailto:support@chatarmin.com","label":"Support"},{"href":"https://api.armin.cx/docs/v1","label":"API reference"}],"primary":{"type":"button","label":"Dashboard","href":"https://armin.cx/signin"}},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API","groups":[{"group":"Public API v1","pages":[{"title":"Overview","icon":"code","href":"/api/overview"},{"title":"Endpoints","icon":"list","href":"/api/endpoints"},{"title":"Getting started","icon":"rocket","href":"/api/getting-started"},{"title":"Authentication \u0026 API keys","icon":"key","href":"/api/authentication"},{"title":"Rate limits","icon":"gauge","href":"/api/rate-limits"},{"title":"Filtering \u0026 saved views","icon":"filter","href":"/api/filtering-and-saved-views"},{"title":"Search contacts and tickets","description":"Find a customer by email or name, list all of their tickets, and search tickets the same way the inbox search bar does.","icon":"magnifying-glass","href":"/api/search"},{"title":"Pagination","icon":"list","href":"/api/pagination"},{"title":"Errors","description":"Structured error envelopes, machine-readable codes, and HTTP status mapping.","icon":"triangle-exclamation","href":"/api/errors"},{"title":"Agent tool examples","icon":"robot","href":"/api/agent-tool-examples"},{"title":"Create a ticket","icon":"ticket","href":"/api/create-ticket"},{"title":"Send a message","icon":"message","href":"/api/send-message"},{"title":"Reports and metrics","icon":"chart-line","href":"/api/reports"},{"title":"CSAT, session and ticket-action exports","icon":"file-export","href":"/api/analytics-exports"},{"title":"Ticket exports","icon":"file-zipper","href":"/api/ticket-exports"},{"title":"Migrating from legacy /public","icon":"arrow-right-arrow-left","href":"/api/v1/migration"}]},{"group":"MCP","pages":[{"title":"Connect AI tools (MCP)","icon":"plug","href":"/api/mcp"}]}]}]},{"language":"de","navbar":{"links":[{"href":"mailto:support@chatarmin.com","label":"Support"},{"href":"https://api.armin.cx/docs/v1","label":"API-Referenz"}],"primary":{"type":"button","label":"Dashboard","href":"https://armin.cx/signin"}},"pages":[{"title":"de","href":"/de/api/pagination"}]}]},"basePath":"","title":"Pagination - Chatarmin CX Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}