Returns a paginated list of conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.
GET
/
conversations
List conversations
curl --request GET \ --url https://api.example.com/conversations
{"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.4111","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/conversations/list-conversations","slug":"/api-reference/conversations/list-conversations","pageMetadata":{"title":"List conversations","description":"Returns a paginated list of conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations","href":"/api-reference/conversations/list-conversations","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 conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.\"\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 conversations","description":"Returns a paginated list of conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /conversations","href":"/api-reference/conversations/list-conversations","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Conversations"],"summary":"List conversations","description":"Returns a paginated list of conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.","operationId":"9ce45b2887011980f3b9dc92fec9830e","parameters":["e78ec43f-35b8-4cde-89d3-db0ff55f6a44","27f86306-af97-4536-b576-d8a3c71b39e0","8113b1b8-7fdc-4896-8db2-1e380e8070d5","2fc7dbb2-df1e-46cd-ba5a-054ac51b6ba6","0ac9e9af-341e-4d8d-8710-d3f157458195"],"responses":{"200":"bbd98948-37b5-41e3-9d77-ceba49a3ee11"},"method":"get","type":"path","servers":[],"security":[],"path":"/conversations","baseUrlOptions":[],"title":"List conversations","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e78ec43f-35b8-4cde-89d3-db0ff55f6a44":{"name":"status","in":"query","description":"Filter by conversation status","required":false,"schema":{"type":"string","enum":["normal","archived","unread"],"isRequired":false,"description":"Filter by conversation status","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"27f86306-af97-4536-b576-d8a3c71b39e0":{"name":"keyword","in":"query","description":"Search in conversation title or participant names","required":false,"schema":{"type":"string","isRequired":false,"description":"Search in conversation title or participant names","uniqueKey":"","typeLabel":"string"}},"8113b1b8-7fdc-4896-8db2-1e380e8070d5":{"name":"participants","in":"query","description":"Filter by exact set of participant user IDs (finds or excludes conversations with exactly these users)","required":false,"schema":{"type":"array","items":{"type":"integer","uniqueKey":"items.[INDEX]","typeLabel":"integer"},"isRequired":false,"description":"Filter by exact set of participant user IDs (finds or excludes conversations with exactly these users)","uniqueKey":"","typeLabel":"integer[]"}},"2fc7dbb2-df1e-46cd-ba5a-054ac51b6ba6":{"name":"limit","in":"query","description":"Number of items per page (1–100)","required":false,"schema":{"type":"integer","default":10,"isRequired":false,"description":"Number of items per page (1–100)","uniqueKey":"","typeLabel":"integer"}},"0ac9e9af-341e-4d8d-8710-d3f157458195":{"name":"page","in":"query","description":"Page number for pagination","required":false,"schema":{"type":"integer","isRequired":false,"description":"Page number for pagination","uniqueKey":"","typeLabel":"integer"}}},"responses":{"bbd98948-37b5-41e3-9d77-ceba49a3ee11":{"description":"Paginated list of conversations.","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"properties":{"id":{"type":"integer","example":1,"uniqueKey":"data.items.[INDEX].id","typeLabel":"integer"},"type":{"description":"Conversation type: direct or group","type":"string","example":"direct","uniqueKey":"data.items.[INDEX].type","typeLabel":"string"},"title":{"description":"Conversation title (group only)","type":"string","example":"","uniqueKey":"data.items.[INDEX].title","typeLabel":"string"},"created_at":{"description":"Unix timestamp","type":"integer","format":"int64","uniqueKey":"data.items.[INDEX].created_at","typeLabel":"integer\u003cint64>"},"updated_at":{"description":"Unix timestamp","type":"integer","format":"int64","uniqueKey":"data.items.[INDEX].updated_at","typeLabel":"integer\u003cint64>"},"latest_message":{"oneOf":[{"description":"Latest message in the conversation","type":"object","uniqueKey":"data.items.[INDEX].latest_message.oneOf.0","typeLabel":"object"},{"description":"Latest message in the conversation","type":"null","uniqueKey":"data.items.[INDEX].latest_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].latest_message","typeLabel":"object | null"},"mute_rule":{"oneOf":[{"description":"Mute rule ID or null","type":"integer","uniqueKey":"data.items.[INDEX].mute_rule.oneOf.0","typeLabel":"integer"},{"description":"Mute rule ID or null","type":"null","uniqueKey":"data.items.[INDEX].mute_rule.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].mute_rule","typeLabel":"integer | null"},"unread_message_count":{"type":"integer","example":0,"uniqueKey":"data.items.[INDEX].unread_message_count","typeLabel":"integer"},"participants":{"description":"Conversation participants","type":"array","items":{"properties":{"id":{"type":"integer","example":1,"uniqueKey":"data.items.[INDEX].participants.items.[INDEX].id","typeLabel":"integer"},"first_name":{"type":"string","example":"John","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].first_name","typeLabel":"string"},"last_name":{"type":"string","example":"Doe","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].last_name","typeLabel":"string"},"name":{"type":"string","example":"John Doe","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].name","typeLabel":"string"},"title":{"type":"string","example":"Manager","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].title","typeLabel":"string"},"active":{"type":"boolean","example":true,"uniqueKey":"data.items.[INDEX].participants.items.[INDEX].active","typeLabel":"boolean"},"avatar":{"oneOf":[{"description":"Avatar image or null","type":"object","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].avatar.oneOf.0","typeLabel":"object"},{"description":"Avatar image or null","type":"null","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].avatar.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].participants.items.[INDEX].avatar","typeLabel":"object | null"},"archived_at":{"oneOf":[{"description":"Conversation participant archived timestamp or null","type":"integer","format":"int64","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].archived_at.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"Conversation participant archived timestamp or null","type":"null","format":"int64","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].participants.items.[INDEX].archived_at","typeLabel":"integer\u003cint64> | null"},"participant_type":{"oneOf":[{"description":"Conversation participant type when present","type":"string","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].participant_type.oneOf.0","typeLabel":"string"},{"description":"Conversation participant type when present","type":"null","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].participant_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].participants.items.[INDEX].participant_type","typeLabel":"string | null"},"subtext":{"description":"Short descriptive text combining title/unit/department","type":"string","example":"Manager - HQ (Sales)","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].subtext","typeLabel":"string"},"department":{"oneOf":[{"properties":{"id":{"type":"integer","example":10,"uniqueKey":"data.items.[INDEX].participants.items.[INDEX].department.oneOf.0.id","typeLabel":"integer"},"name":{"type":"string","example":"Sales","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].department.oneOf.0.name","typeLabel":"string"}},"type":"object","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].department.oneOf.0","typeLabel":"object"},{"properties":{"id":{"type":"integer","example":10},"name":{"type":"string","example":"Sales"}},"type":"null","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].department.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].participants.items.[INDEX].department","typeLabel":"object | null"},"unit":{"oneOf":[{"properties":{"id":{"type":"integer","example":5,"uniqueKey":"data.items.[INDEX].participants.items.[INDEX].unit.oneOf.0.id","typeLabel":"integer"},"name":{"type":"string","example":"HQ","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].unit.oneOf.0.name","typeLabel":"string"}},"type":"object","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].unit.oneOf.0","typeLabel":"object"},{"properties":{"id":{"type":"integer","example":5},"name":{"type":"string","example":"HQ"}},"type":"null","uniqueKey":"data.items.[INDEX].participants.items.[INDEX].unit.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].participants.items.[INDEX].unit","typeLabel":"object | null"}},"type":"object","uniqueKey":"data.items.[INDEX].participants.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.items.[INDEX].participants","typeLabel":"object[]"},"publish":{"properties":{"created_at":{"type":"integer","format":"int64","uniqueKey":"data.items.[INDEX].publish.created_at","typeLabel":"integer\u003cint64>"},"updated_at":{"type":"integer","format":"int64","uniqueKey":"data.items.[INDEX].publish.updated_at","typeLabel":"integer\u003cint64>"}},"type":"object","uniqueKey":"data.items.[INDEX].publish","typeLabel":"object"},"archived_at":{"oneOf":[{"description":"When the auth user archived this conversation","type":"integer","format":"int64","uniqueKey":"data.items.[INDEX].archived_at.oneOf.0","typeLabel":"integer\u003cint64>"},{"description":"When the auth user archived this conversation","type":"null","format":"int64","uniqueKey":"data.items.[INDEX].archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].archived_at","typeLabel":"integer\u003cint64> | null"}},"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"id":1,"type":"direct","title":"","created_at":123,"updated_at":123,"latest_message":{},"mute_rule":123,"unread_message_count":0,"participants":[{"id":1,"first_name":"John","last_name":"Doe","name":"John Doe","title":"Manager","active":true,"avatar":{},"archived_at":123,"participant_type":"\u003cstring>","subtext":"Manager - HQ (Sales)","department":{"id":10,"name":"Sales"},"unit":{"id":5,"name":"HQ"}}],"publish":{"created_at":123,"updated_at":123},"archived_at":123}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{}},"originalFileLocation":"openapi.yaml"},"subdomain":"ziik","siteName":"Ziik.io API docs","title":"List conversations - Ziik.io API docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-23T11:50:49.646Z","originalFileLocation":"api-reference/conversations/list-conversations.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 conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.\">\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 conversations - Ziik.io API docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a paginated list of conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.\">\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/conversations/list-conversations\">\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=Conversations\u0026amp;title=List+conversations\u0026amp;description=Returns+a+paginated+list+of+conversations+for+the+authenticated+user.+Can+be+filtered+by+status+%28normal%2C+unread%2C+archived%29%2C+keyword+%28title+or+participant+name%29%2C\u0026amp;theme=db0cf3b191eec410ae9bfc26\u0026amp;signature=1d5d87ad629f9e6f433187c035acf79d72e3a1fa49126815215c9994f71c8693\">\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 conversations - Ziik.io API docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a paginated list of conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ziik.mintlify.site/_mintlify/api/og/v2?division=Conversations\u0026amp;title=List+conversations\u0026amp;description=Returns+a+paginated+list+of+conversations+for+the+authenticated+user.+Can+be+filtered+by+status+%28normal%2C+unread%2C+archived%29%2C+keyword+%28title+or+participant+name%29%2C\u0026amp;theme=db0cf3b191eec410ae9bfc26\u0026amp;signature=1d5d87ad629f9e6f433187c035acf79d72e3a1fa49126815215c9994f71c8693\">\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/conversations/list-conversations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/conversations/list-conversations.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/conversations/list-conversations#webpage\",\"url\":\"https://docs.ziik.io/api-reference/conversations/list-conversations\",\"name\":\"List conversations\",\"description\":\"Returns a paginated list of conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.\",\"dateModified\":\"2026-03-23T11:50:49.646Z\",\"isPartOf\":{\"@id\":\"https://docs.ziik.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ziik.io/api-reference/conversations/list-conversations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ziik.io/api-reference/conversations/list-conversations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Ziik.io API docs\",\"item\":\"https://docs.ziik.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List conversations\",\"item\":\"https://docs.ziik.io/api-reference/conversations/list-conversations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ziik.io/api-reference/conversations/list-conversations#apireference\",\"headline\":\"List conversations\",\"name\":\"List conversations\",\"description\":\"Returns a paginated list of conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.\",\"url\":\"https://docs.ziik.io/api-reference/conversations/list-conversations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ziik.io/api-reference/conversations/list-conversations#webpage\"},\"dateModified\":\"2026-03-23T11:50:49.646Z\",\"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/conversations/list-conversations.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","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","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","description":"Updates an existing user type. Can change name and reference.","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","description":"Creates a new conversation (or uses existing one) with the given recipients and immediately adds the first message. Returns the created message resource.","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 conversations - Ziik.io API docs","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}