{"templateId":"GuidePage","sharedDataIds":{"sidebar":"sidebar-developers/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial","split"]},"type":"markdown"},"seo":{"title":"Pagination","description":"Developer API, partner integration, MCP, SDK, and customer help center.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"pagination","__idx":0},"children":["Pagination"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List queries accept pagination:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Argument"},"children":["Argument"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Int"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Page number (starts at 1)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["perPage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Int"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Items per page"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example variables:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{ \"page\": 1, \"perPage\": 20 }\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List responses include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pagination"]}," object with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalCount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currentPage"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalPages"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hasNextPage"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hasPreviousPage"]},"."]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example","__idx":1},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["perPage"]}," on list queries such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customers"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversations"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"graphql","header":{"controls":{"copy":{}}},"source":"query {\n  customers(page: 2, perPage: 20) {\n    data { _id firstName }\n    pagination {\n      totalCount\n      currentPage\n      hasNextPage\n    }\n  }\n}\n","lang":"graphql"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"graphql","header":{"controls":{"copy":{}}},"source":"query {\n  customers(page: 2, perPage: 20) {\n    data { _id firstName }\n    pagination {\n      totalCount\n      hasNextPage\n    }\n  }\n}\n","lang":"graphql"},"children":[]}]}]},"headings":[{"value":"Pagination","id":"pagination","depth":1},{"value":"Example","id":"example","depth":3}],"frontmatter":{"title":"Pagination","titleTranslationKey":"sidebar.developers.pagination","audience":"developer","status":"published","locales":["en","ar"],"template":"GuidePage","seo":{"title":"Pagination"}},"lastModified":"2026-06-23T09:59:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developers/guides/pagination","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}