{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ziik.io API docs","colors":{"primary":"#2a79ff","light":"#75a8ff","dark":"#2a79ff"},"logo":{"light":"https://mintcdn.com/ziik/XGBy0jppV3iL5Bou/logo/light.svg?fit=max\u0026auto=format\u0026n=XGBy0jppV3iL5Bou\u0026q=85\u0026s=e9ee9f29e1e2703be68c906ed13771f3","dark":"https://mintcdn.com/ziik/XGBy0jppV3iL5Bou/logo/dark.svg?fit=max\u0026auto=format\u0026n=XGBy0jppV3iL5Bou\u0026q=85\u0026s=c0bee07462dbee0e7b95e3bb8368e26d"},"favicon":"/favicon.ico","navbar":{"links":[{"href":"https://www.ziik.io/contact-us","label":"Support"}]},"footer":{"socials":{}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Contact us","icon":"book-open-cover","href":"https://www.ziik.io/contact-us"},{"anchor":"Helpcenter","icon":"book-open-cover","href":"https://help.ziik.io/"},{"anchor":"Blog","icon":"newspaper","href":"https://www.ziik.io/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ziik","hasAudioNarration":false,"actualSubdomain":"ziik","customDomains":["docs.ziik.io"],"gitSource":{"type":"github","owner":"ziikio","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae943ba79df2a22b14b27ce:success","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"API Reference","count":60},{"language":"default","tag":"Conversations","count":14},{"language":"default","tag":"Users","count":10},{"language":"default","tag":"Docs","count":9},{"language":"default","tag":"Posts","count":8},{"language":"default","tag":"Units","count":7},{"language":"default","tag":"Groups","count":6},{"language":"default","tag":"User types","count":6},{"language":"default","tag":"Recommended reads","count":4},{"language":"default","tag":"User unit memberships","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/units/list-units","slug":"/api-reference/units/list-units","pageMetadata":{"title":"List units","description":"Returns a paginated list of units. Can be filtered by feature, user membership, and search keyword.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units","href":"/api-reference/units/list-units","autogeneratedByOpenApi":true},"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: \"Returns a paginated list of units. Can be filtered by feature, user membership, and search keyword.\"\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":"List units","description":"Returns a paginated list of units. Can be filtered by feature, user membership, and search keyword.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units","href":"/api-reference/units/list-units","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Units"],"summary":"List units","description":"Returns a paginated list of units. Can be filtered by feature, user membership, and search keyword.","operationId":"4fad383f5a5218655d5cc113dc8e9198","parameters":["e7d1ec63-8c86-4822-8ea9-25c60f851d68","58bb74e4-ead8-4a62-a745-6399e3bd15cf","99dfdaf3-4044-40d9-afb6-1bd51f11da3e","d787d17f-bfa3-46f5-a183-4a913fff86fc","adc85877-0979-4654-9712-dc47bfb6e262","7e4621cf-596e-4221-8b44-983c7b94b565"],"responses":{"200":"d116b72b-fd38-489b-b346-71f06678b60d"},"method":"get","type":"path","servers":[],"security":[],"path":"/units","baseUrlOptions":[],"title":"List units","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e7d1ec63-8c86-4822-8ea9-25c60f851d68":{"name":"feature","in":"query","description":"Filter by feature ID","required":false,"schema":{"type":"integer","isRequired":false,"description":"Filter by feature ID","uniqueKey":"","typeLabel":"integer"}},"58bb74e4-ead8-4a62-a745-6399e3bd15cf":{"name":"user","in":"query","description":"Limit results to units related to the current user","required":false,"schema":{"type":"integer","isRequired":false,"description":"Limit results to units related to the current user","uniqueKey":"","typeLabel":"integer"}},"99dfdaf3-4044-40d9-afb6-1bd51f11da3e":{"name":"keyword","in":"query","description":"Search keyword applied to unit name","required":false,"schema":{"type":"string","isRequired":false,"description":"Search keyword applied to unit name","uniqueKey":"","typeLabel":"string"}},"d787d17f-bfa3-46f5-a183-4a913fff86fc":{"name":"full_stats","in":"query","description":"Include extended statistics for each unit","required":false,"schema":{"type":"boolean","isRequired":false,"description":"Include extended statistics for each unit","uniqueKey":"","typeLabel":"boolean"}},"adc85877-0979-4654-9712-dc47bfb6e262":{"name":"limit","in":"query","description":"Pagination size","required":false,"schema":{"type":"integer","isRequired":false,"description":"Pagination size","uniqueKey":"","typeLabel":"integer"}},"7e4621cf-596e-4221-8b44-983c7b94b565":{"name":"page","in":"query","description":"Pagination page number","required":false,"schema":{"type":"integer","isRequired":false,"description":"Pagination page number","uniqueKey":"","typeLabel":"integer"}}},"responses":{"d116b72b-fd38-489b-b346-71f06678b60d":{"description":"A paginated list of units.","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"properties":{"content_type":{"type":"string","example":"unit","uniqueKey":"data.items.[INDEX].content_type","typeLabel":"string"},"id":{"type":"integer","example":1,"uniqueKey":"data.items.[INDEX].id","typeLabel":"integer"},"reference":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].reference.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].reference","typeLabel":"string | null"},"name":{"type":"string","example":"HQ","uniqueKey":"data.items.[INDEX].name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].description","typeLabel":"string | null"},"level":{"description":"Depth in unit tree","type":"integer","uniqueKey":"data.items.[INDEX].level","typeLabel":"integer"},"path":{"description":"Materialized path","type":"string","uniqueKey":"data.items.[INDEX].path","typeLabel":"string"},"unit_type":{"type":"string","example":"unit","uniqueKey":"data.items.[INDEX].unit_type","typeLabel":"string"},"falldown":{"oneOf":[{"description":"From pivot when in context","type":"boolean","uniqueKey":"data.items.[INDEX].falldown.oneOf.0","typeLabel":"boolean"},{"description":"From pivot when in context","type":"null","uniqueKey":"data.items.[INDEX].falldown.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].falldown","typeLabel":"boolean | null"},"features":{"oneOf":[{"type":"array","items":{"type":"object","uniqueKey":"data.items.[INDEX].features.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.items.[INDEX].features.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object"},"uniqueKey":"data.items.[INDEX].features.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].features","typeLabel":"object[] | null"},"departments":{"oneOf":[{"type":"array","items":{"type":"object","uniqueKey":"data.items.[INDEX].departments.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.items.[INDEX].departments.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object"},"uniqueKey":"data.items.[INDEX].departments.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].departments","typeLabel":"object[] | null"},"parent":{"oneOf":[{"description":"Parent unit when loaded","type":"object","uniqueKey":"data.items.[INDEX].parent.oneOf.0","typeLabel":"object"},{"description":"Parent unit when loaded","type":"null","uniqueKey":"data.items.[INDEX].parent.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].parent","typeLabel":"object | null"},"image":{"oneOf":[{"description":"Unit image when loaded","type":"object","uniqueKey":"data.items.[INDEX].image.oneOf.0","typeLabel":"object"},{"description":"Unit image when loaded","type":"null","uniqueKey":"data.items.[INDEX].image.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].image","typeLabel":"object | null"},"children":{"oneOf":[{"type":"array","items":{"type":"object","uniqueKey":"data.items.[INDEX].children.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.items.[INDEX].children.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object"},"uniqueKey":"data.items.[INDEX].children.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].children","typeLabel":"object[] | null"},"addresses":{"description":"Company, delivery, invoicing addresses","type":"object","uniqueKey":"data.items.[INDEX].addresses","typeLabel":"object"},"contact":{"description":"Contact name and phone","type":"object","uniqueKey":"data.items.[INDEX].contact","typeLabel":"object"},"opening_hours":{"description":"Office hours and closed days","type":"object","uniqueKey":"data.items.[INDEX].opening_hours","typeLabel":"object"},"geo":{"properties":{"lat":{"oneOf":[{"type":"number","uniqueKey":"data.items.[INDEX].geo.lat.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.items.[INDEX].geo.lat.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].geo.lat","typeLabel":"number | null"},"lng":{"oneOf":[{"type":"number","uniqueKey":"data.items.[INDEX].geo.lng.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"data.items.[INDEX].geo.lng.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].geo.lng","typeLabel":"number | null"}},"type":"object","uniqueKey":"data.items.[INDEX].geo","typeLabel":"object"},"stats":{"oneOf":[{"properties":{"users":{"type":"integer","uniqueKey":"data.items.[INDEX].stats.oneOf.0.users","typeLabel":"integer"},"children":{"type":"integer","uniqueKey":"data.items.[INDEX].stats.oneOf.0.children","typeLabel":"integer"},"children_total":{"type":"integer","uniqueKey":"data.items.[INDEX].stats.oneOf.0.children_total","typeLabel":"integer"}},"type":"object","uniqueKey":"data.items.[INDEX].stats.oneOf.0","typeLabel":"object"},{"properties":{"users":{"type":"integer"},"children":{"type":"integer"},"children_total":{"type":"integer"}},"type":"null","uniqueKey":"data.items.[INDEX].stats.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].stats","typeLabel":"object | null"},"permissions":{"description":"Permission flags for current user","type":"object","uniqueKey":"data.items.[INDEX].permissions","typeLabel":"object"},"url":{"type":"string","example":"api/units/1","uniqueKey":"data.items.[INDEX].url","typeLabel":"string"}},"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"content_type":"unit","id":1,"reference":"\u003cstring>","name":"HQ","description":"\u003cstring>","level":123,"path":"\u003cstring>","unit_type":"unit","falldown":true,"features":[{}],"departments":[{}],"parent":{},"image":{},"children":[{}],"addresses":{},"contact":{},"opening_hours":{},"geo":{"lat":123,"lng":123},"stats":{"users":123,"children":123,"children_total":123},"permissions":{},"url":"api/units/1"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{}},"originalFileLocation":"openapi.yaml"},"subdomain":"ziik","siteName":"Ziik.io API docs","title":"List units - Ziik.io API docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-23T11:50:49.348Z","originalFileLocation":"api-reference/units/list-units.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=\"Returns a paginated list of units. Can be filtered by feature, user membership, and search keyword.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ziik.io API 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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_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/ziik/CMTUSWplWQMfvgbI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List units - Ziik.io API docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a paginated list of units. Can be filtered by feature, user membership, and search keyword.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ziik.io API docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ziik.io/api-reference/units/list-units\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ziik.mintlify.site/_mintlify/api/og/v2?division=Units\u0026amp;title=List+units\u0026amp;description=Returns+a+paginated+list+of+units.+Can+be+filtered+by+feature%2C+user+membership%2C+and+search+keyword.\u0026amp;theme=db0cf3b191eec410ae9bfc26\u0026amp;signature=9195082cc1b344018fba7ad2acc0090b4addf96d19ec1a6ec3c6a5a2388e4da3\">\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=\"List units - Ziik.io API docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a paginated list of units. Can be filtered by feature, user membership, and search keyword.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ziik.mintlify.site/_mintlify/api/og/v2?division=Units\u0026amp;title=List+units\u0026amp;description=Returns+a+paginated+list+of+units.+Can+be+filtered+by+feature%2C+user+membership%2C+and+search+keyword.\u0026amp;theme=db0cf3b191eec410ae9bfc26\u0026amp;signature=9195082cc1b344018fba7ad2acc0090b4addf96d19ec1a6ec3c6a5a2388e4da3\">\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/ziik/CMTUSWplWQMfvgbI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ziik.io API docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2a79ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ziik.io/api-reference/units/list-units\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/units/list-units.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ziik.io/#organization\",\"name\":\"Ziik.io API docs\",\"url\":\"https://docs.ziik.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ziik/XGBy0jppV3iL5Bou/logo/light.svg?fit=max\u0026auto=format\u0026n=XGBy0jppV3iL5Bou\u0026q=85\u0026s=e9ee9f29e1e2703be68c906ed13771f3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ziik.io#website\",\"name\":\"Ziik.io API docs\",\"url\":\"https://docs.ziik.io\",\"publisher\":{\"@id\":\"https://docs.ziik.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ziik.io/api-reference/units/list-units#webpage\",\"url\":\"https://docs.ziik.io/api-reference/units/list-units\",\"name\":\"List units\",\"description\":\"Returns a paginated list of units. Can be filtered by feature, user membership, and search keyword.\",\"dateModified\":\"2026-03-23T11:50:49.348Z\",\"isPartOf\":{\"@id\":\"https://docs.ziik.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ziik.io/api-reference/units/list-units#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ziik.io/api-reference/units/list-units#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Ziik.io API docs\",\"item\":\"https://docs.ziik.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List units\",\"item\":\"https://docs.ziik.io/api-reference/units/list-units\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ziik.io/api-reference/units/list-units#apireference\",\"headline\":\"List units\",\"name\":\"List units\",\"description\":\"Returns a paginated list of units. Can be filtered by feature, user membership, and search keyword.\",\"url\":\"https://docs.ziik.io/api-reference/units/list-units\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ziik.io/api-reference/units/list-units#webpage\"},\"dateModified\":\"2026-03-23T11:50:49.348Z\",\"publisher\":{\"@id\":\"https://docs.ziik.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ziik.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ziik.io API docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ziik.io API docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/units/list-units.md","siteName":"Ziik.io API docs","nav":{"global":{"anchors":[{"anchor":"Contact us","icon":"book-open-cover","href":"https://www.ziik.io/contact-us"},{"anchor":"Helpcenter","icon":"book-open-cover","href":"https://help.ziik.io/"},{"anchor":"Blog","icon":"newspaper","href":"https://www.ziik.io/blog"}]},"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"API Reference","groups":[{"group":"Auth","pages":[{"title":"Authenticate","deprecated":null,"version":null,"openapi":"/openapi.yaml post /authenticate","href":"/api-reference/auth/authenticate"},{"title":"Renew token","deprecated":null,"version":null,"openapi":"/openapi.yaml post /renew","href":"/api-reference/auth/renew-token"}]},{"group":"Posts","pages":[{"title":"Get multiple posts by ID","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/collection/{contentIDs}","href":"/api-reference/posts/get-multiple-posts-by-id"},{"title":"Get a post","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/{content}","href":"/api-reference/posts/get-a-post"},{"title":"Delete a post","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /content/{content}","href":"/api-reference/posts/delete-a-post"},{"title":"Update a post","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /content/{content}","href":"/api-reference/posts/update-a-post"},{"title":"Create a post","deprecated":null,"version":null,"openapi":"/openapi.yaml post /content","href":"/api-reference/posts/create-a-post"},{"title":"List post IDs by user","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/user/{user}/{type}","href":"/api-reference/posts/list-post-ids-by-user"},{"title":"List global post IDs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/global/{type}/{sorting}","href":"/api-reference/posts/list-global-post-ids"},{"title":"List post IDs by group","deprecated":null,"version":null,"openapi":"/openapi.yaml get /content/group/{group}/{type}/{sorting}","href":"/api-reference/posts/list-post-ids-by-group"}]},{"group":"Counters","pages":[{"title":"Get counters","deprecated":null,"version":null,"openapi":"/openapi.yaml get /counters","href":"/api-reference/counters/get-counters"}]},{"group":"Groups","pages":[{"title":"List groups","deprecated":null,"version":null,"openapi":"/openapi.yaml get /groups","href":"/api-reference/groups/list-groups"},{"title":"Create a group","deprecated":null,"version":null,"openapi":"/openapi.yaml post /groups","href":"/api-reference/groups/create-a-group"},{"title":"Get a group","deprecated":null,"version":null,"openapi":"/openapi.yaml get /groups/{group}","href":"/api-reference/groups/get-a-group"},{"title":"Delete a group","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /groups/{group}","href":"/api-reference/groups/delete-a-group"},{"title":"Update a group","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /groups/{group}","href":"/api-reference/groups/update-a-group"},{"title":"Search groups","deprecated":null,"version":null,"openapi":"/openapi.yaml get /groups/search/{search}","href":"/api-reference/groups/search-groups"}]},{"group":"Languages","pages":[{"title":"List languages","deprecated":null,"version":null,"openapi":"/openapi.yaml get /settings/languages","href":"/api-reference/languages/list-languages"}]},{"group":"Timezones","pages":[{"title":"List timezones","description":"Get list of timezones","deprecated":null,"version":null,"openapi":"/openapi.yaml get /settings/timezones","href":"/api-reference/timezones/list-timezones"}]},{"group":"Units","pages":[{"title":"List units","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units","href":"/api-reference/units/list-units"},{"title":"Create unit","description":"Creates a new unit and returns the created resource.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /units","href":"/api-reference/units/create-unit"},{"title":"List basic units","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units/basic","href":"/api-reference/units/list-basic-units"},{"title":"Get unit by ID","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units/{unit}","href":"/api-reference/units/get-unit-by-id"},{"title":"Delete unit","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /units/{unit}","href":"/api-reference/units/delete-unit"},{"title":"Update unit","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /units/{unit}","href":"/api-reference/units/update-unit"},{"title":"Get unit by reference","deprecated":null,"version":null,"openapi":"/openapi.yaml get /units/reference/{unit}","href":"/api-reference/units/get-unit-by-reference"}]},{"group":"User unit memberships","pages":[{"title":"List user unit memberships","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/{user}/units","href":"/api-reference/user-unit-memberships/list-user-unit-memberships"},{"title":"Add unit membership","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users/{user}/units","href":"/api-reference/user-unit-memberships/add-unit-membership"},{"title":"Remove unit membership","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /users/{user}/units/{unit}","href":"/api-reference/user-unit-memberships/remove-unit-membership"},{"title":"Update unit membership","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /users/{user}/units/{unit}","href":"/api-reference/user-unit-memberships/update-unit-membership"}]},{"group":"Users","pages":[{"title":"Get users","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users","href":"/api-reference/users/get-users"},{"title":"Post users","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users","href":"/api-reference/users/post-users"},{"title":"Get user by ID","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/{userId}","href":"/api-reference/users/get-user-by-id"},{"title":"Get user by reference","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/reference/{reference}","href":"/api-reference/users/get-user-by-reference"},{"title":"Get collection of users by IDs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/collection/{userIDs}","href":"/api-reference/users/get-collection-of-users-by-ids"},{"title":"Delete user","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /users/{user}","href":"/api-reference/users/delete-user"},{"title":"Update user","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /users/{user}","href":"/api-reference/users/update-user"},{"title":"Deactivate user","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users/{user}/deactivate","href":"/api-reference/users/deactivate-user"},{"title":"Reactivate user","deprecated":null,"version":null,"openapi":"/openapi.yaml post /users/{user}/reactivate","href":"/api-reference/users/reactivate-user"},{"title":"User birthdays","deprecated":null,"version":null,"openapi":"/openapi.yaml get /users/birthdays","href":"/api-reference/users/user-birthdays"}]},{"group":"User types","pages":[{"title":"List user types","deprecated":null,"version":null,"openapi":"/openapi.yaml get /usertypes","href":"/api-reference/user-types/list-user-types"},{"title":"Create user type","deprecated":null,"version":null,"openapi":"/openapi.yaml post /usertypes","href":"/api-reference/user-types/create-user-type"},{"title":"List basic user types","deprecated":null,"version":null,"openapi":"/openapi.yaml get /usertypes/basic","href":"/api-reference/user-types/list-basic-user-types"},{"title":"Get user type","deprecated":null,"version":null,"openapi":"/openapi.yaml get /usertypes/{userType}","href":"/api-reference/user-types/get-user-type"},{"title":"Delete user type","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /usertypes/{userType}","href":"/api-reference/user-types/delete-user-type"},{"title":"Update user type","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /usertypes/{userType}","href":"/api-reference/user-types/update-user-type"}]},{"group":"Conversations","pages":[{"title":"List conversations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations","href":"/api-reference/conversations/list-conversations"},{"title":"Create conversation with first message","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations","href":"/api-reference/conversations/create-conversation-with-first-message"},{"title":"Get a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations/{conversation}","href":"/api-reference/conversations/get-a-conversation"},{"title":"Delete a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /conversations/{conversation}","href":"/api-reference/conversations/delete-a-conversation"},{"title":"Update a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /conversations/{conversation}","href":"/api-reference/conversations/update-a-conversation"},{"title":"Create a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/create","href":"/api-reference/conversations/create-a-conversation"},{"title":"Archive a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/{conversation}/archive","href":"/api-reference/conversations/archive-a-conversation"},{"title":"Unarchive a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/{conversation}/unarchive","href":"/api-reference/conversations/unarchive-a-conversation"},{"title":"List messages in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations/{conversation}/messages","href":"/api-reference/conversations/list-messages-in-a-conversation"},{"title":"Create a new message in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/{conversation}/messages","href":"/api-reference/conversations/create-a-new-message-in-a-conversation"},{"title":"Get a single message in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations/{conversation}/messages/{message}","href":"/api-reference/conversations/get-a-single-message-in-a-conversation"},{"title":"Delete a message in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /conversations/{conversation}/messages/{message}","href":"/api-reference/conversations/delete-a-message-in-a-conversation"},{"title":"Update a message in a conversation","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /conversations/{conversation}/messages/{message}","href":"/api-reference/conversations/update-a-message-in-a-conversation"},{"title":"Finalize message update","deprecated":null,"version":null,"openapi":"/openapi.yaml post /conversations/{conversation}/messages/{message}/finalize-update","href":"/api-reference/conversations/finalize-message-update"}]}]}]},"basePath":"","title":"List units - Ziik.io API docs","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}