Pull the history when you need it: to build your own chat view, to catch up after your bot restarts, or to debug,
without keeping a copy of every webhook event. Pass a chatId to List Conversation
Messages to read one conversation.
Need email too, search, assignment or replies? Use the Inbox API.
Response shape
The list is in data.data and the pages in data.pagination (totalRecords, currentPage, totalPages, nextPage,
prevPage). pageSize is at most 100.
Permissions
The API key needs the WhatsApp permission. Every call is scoped to the key’s workspace.
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
page
integer
default:1
pageSize
integer
default:20
Up to 100.
Required range: x <= 100
Response
Conversations
data
object
Show child attributes
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Minimo Docs","colors":{"primary":"#000000","light":"#fafafa","dark":"#000000"},"favicon":"https://mintcdn.com/minimo/3CkweOTs_wJBldaS/favicon.svg?fit=max\u0026auto=format\u0026n=3CkweOTs_wJBldaS\u0026q=85\u0026s=741f59ded2f05d51dd8ed745b6b9304d","logo":{"light":"https://mintcdn.com/minimo/_5TQWO7ZAmNbow_0/logo/light.svg?fit=max\u0026auto=format\u0026n=_5TQWO7ZAmNbow_0\u0026q=85\u0026s=770ea7f424284ce6f88684bb97af23f0","dark":"https://mintcdn.com/minimo/_5TQWO7ZAmNbow_0/logo/dark.svg?fit=max\u0026auto=format\u0026n=_5TQWO7ZAmNbow_0\u0026q=85\u0026s=d0eaf24238816ed860e88d67985c7d27"},"api":{"openapi":["api-reference/openApi.yml"]},"navbar":{"links":[{"label":"Support","href":"mailto:info@minimo.it"}],"primary":{"type":"button","label":"Start now for free","href":"https://app.minimo.it"}},"footer":{"socials":{"instagram":"https://instagram.com/thebareminimo","linkedin":"https://www.linkedin.com/company/thebareminimo"}},"integrations":{},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Sito Web","href":"https://minimo.it","icon":"desktop"},{"anchor":"Blog","href":"https://minimo.it/blog","icon":"newspaper"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"minimo","hasAudioNarration":false,"actualSubdomain":"minimo","customDomains":["docs.minimo.it"],"gitSource":{"type":"github","owner":"thebareminimo","repo":"docs-v2","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af9f3ab474f4586a49a888e","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":81},{"language":"default","tag":"Embedded for SaaS","count":44},{"language":"default","tag":"Product","count":22},{"language":"default","tag":"Embedded API","count":21},{"language":"default","tag":"Messaging Channels","count":15},{"language":"default","tag":"Connect a Bot (WhatsApp)","count":14},{"language":"default","tag":"Widgets","count":13},{"language":"default","tag":"Domains","count":12},{"language":"default","tag":"Inbox","count":11},{"language":"default","tag":"Email","count":11}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/whatsapp-transport/conversations","slug":"/api-reference/whatsapp-transport/conversations","pageMetadata":{"title":"List Conversations","description":"WhatsApp conversations of your workspace, newest activity first","openapi":"get /public/v1/whatsapp/conversations","href":"/api-reference/whatsapp-transport/conversations"},"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: \"WhatsApp conversations of your workspace, newest activity first\"\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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Pull the history when you need it: to build your own chat view, to catch up after your bot restarts, or to debug,\nwithout keeping a copy of every webhook event. Pass a `,_jsx(_components.code,{children:`chatId`}),` to `,_jsx(_components.a,{href:`/api-reference/whatsapp-transport/conversation-messages`,children:`List Conversation\nMessages`}),` to read one conversation.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Need email too, search, assignment or replies? Use the `,_jsx(_components.a,{href:`/api-reference/inbox/list-threads`,children:`Inbox API`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response-shape`,children:`Response shape`}),`\n`,_jsxs(_components.p,{children:[`The list is in `,_jsx(_components.code,{children:`data.data`}),` and the pages in `,_jsx(_components.code,{children:`data.pagination`}),` (`,_jsx(_components.code,{children:`totalRecords`}),`, `,_jsx(_components.code,{children:`currentPage`}),`, `,_jsx(_components.code,{children:`totalPages`}),`, `,_jsx(_components.code,{children:`nextPage`}),`,\n`,_jsx(_components.code,{children:`prevPage`}),`). `,_jsx(_components.code,{children:`pageSize`}),` is at most 100.`]}),`\n`,_jsx(Heading,{level:`2`,id:`permissions`,children:`Permissions`}),`\n`,_jsxs(_components.p,{children:[`The API key needs the `,_jsx(_components.strong,{children:`WhatsApp`}),` permission. Every call is scoped to the key’s workspace.`]})]})}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":"List Conversations","description":"WhatsApp conversations of your workspace, newest activity first","openapi":"get /public/v1/whatsapp/conversations","href":"/api-reference/whatsapp-transport/conversations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Response shape","slug":"response-shape","depth":2,"children":[]},{"title":"Permissions","slug":"permissions","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List WhatsApp conversations","operationId":"listWhatsappConversations","description":"WhatsApp conversations of your workspace, newest activity first","parameters":["1874a6a3-24cc-4801-b191-3b5e631b58b6","4d39503a-76d1-4e36-8228-9666e98842e1"],"responses":{"200":"e0a5b72c-4b21-4275-9c73-f0338ec29a30","401":"66c150d0-6f36-4b2a-ba26-13f01c5aef68"},"security":["ef873450-7f4c-4eb4-b089-50966dbca5b3"],"x-codeSamples":[{"label":"CLI","lang":"cURL","source":"curl --request GET \\\n --url 'https://api.minimo.it/public/v1/whatsapp/conversations?page=1\u0026pageSize=20' \\\n --header 'Authorization: Bearer {{BEARER_TOKEN}}'"},{"lang":"JavaScript","source":"const res = await fetch('https://api.minimo.it/public/v1/whatsapp/conversations?page=1\u0026pageSize=20', {\n method: 'GET',\n headers: {\n 'Authorization': 'Bearer {{BEARER_TOKEN}}',\n },\n});\nconst { data } = await res.json();\nconsole.log(data);"},{"lang":"Python","source":"import requests\n\nres = requests.get(\n 'https://api.minimo.it/public/v1/whatsapp/conversations?page=1\u0026pageSize=20',\n headers={'Authorization': 'Bearer {{BEARER_TOKEN}}'},\n)\nprint(res.json())"}],"method":"get","type":"path","servers":["e1513a5e-d967-4b5b-8dd2-02144f8691ad"],"path":"/public/v1/whatsapp/conversations","baseUrlOptions":["https://api.minimo.it"],"title":"List WhatsApp conversations","codeSamples":[{"label":"CLI","lang":"cURL","source":"curl --request GET \\\n --url 'https://api.minimo.it/public/v1/whatsapp/conversations?page=1\u0026pageSize=20' \\\n --header 'Authorization: Bearer {{BEARER_TOKEN}}'"},{"lang":"JavaScript","source":"const res = await fetch('https://api.minimo.it/public/v1/whatsapp/conversations?page=1\u0026pageSize=20', {\n method: 'GET',\n headers: {\n 'Authorization': 'Bearer {{BEARER_TOKEN}}',\n },\n});\nconst { data } = await res.json();\nconsole.log(data);"},{"lang":"Python","source":"import requests\n\nres = requests.get(\n 'https://api.minimo.it/public/v1/whatsapp/conversations?page=1\u0026pageSize=20',\n headers={'Authorization': 'Bearer {{BEARER_TOKEN}}'},\n)\nprint(res.json())"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"1874a6a3-24cc-4801-b191-3b5e631b58b6":{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"isRequired":false,"uniqueKey":"","typeLabel":"integer"}},"4d39503a-76d1-4e36-8228-9666e98842e1":{"name":"pageSize","in":"query","required":false,"description":"Up to 100.","schema":{"type":"integer","default":20,"maximum":100,"isRequired":false,"description":"Up to 100.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"e0a5b72c-4b21-4275-9c73-f0338ec29a30":{"description":"Conversations","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"chatId":{"type":"integer","description":"Pass it to List Conversation Messages.","example":1234,"uniqueKey":"data.data.items.[INDEX].chatId","typeLabel":"integer"},"contact":{"type":"object","properties":{"id":{"type":"integer","example":5678,"uniqueKey":"data.data.items.[INDEX].contact.id","typeLabel":"integer"},"phone":{"oneOf":[{"type":"string","example":"393391234567","uniqueKey":"data.data.items.[INDEX].contact.phone.oneOf.0","typeLabel":"string"},{"type":"null","example":"393391234567","uniqueKey":"data.data.items.[INDEX].contact.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.data.items.[INDEX].contact.phone","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"Full or first name of the contact, else the WhatsApp profile name.","example":"Mario Rossi","uniqueKey":"data.data.items.[INDEX].contact.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Full or first name of the contact, else the WhatsApp profile name.","example":"Mario Rossi","uniqueKey":"data.data.items.[INDEX].contact.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.data.items.[INDEX].contact.name","typeLabel":"string | null"}},"uniqueKey":"data.data.items.[INDEX].contact","typeLabel":"object"},"status":{"type":"string","enum":["open","closed","snoozed"],"uniqueKey":"data.data.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"unreadMessages":{"type":"integer","uniqueKey":"data.data.items.[INDEX].unreadMessages","typeLabel":"integer"},"lastMessage":{"oneOf":[{"type":"object","properties":{"text":{"oneOf":[{"type":"string","uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.text.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.text.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.text","typeLabel":"string | null"},"direction":{"type":"string","enum":["inbound","outbound"],"uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.direction","typeLabel":"enum\u003cstring>"},"timestamp":{"oneOf":[{"type":"integer","description":"Epoch seconds.","uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.timestamp.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Epoch seconds.","uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.timestamp.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.timestamp","typeLabel":"integer | null"},"timestampIso":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.timestampIso.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.timestampIso.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0.timestampIso","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"text":{"oneOf":[{"type":"string"},{"type":"null"}]},"direction":{"type":"string","enum":["inbound","outbound"]},"timestamp":{"oneOf":[{"type":"integer","description":"Epoch seconds."},{"type":"null","description":"Epoch seconds."}]},"timestampIso":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"uniqueKey":"data.data.items.[INDEX].lastMessage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.data.items.[INDEX].lastMessage","typeLabel":"object | null"},"createdAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.data.items.[INDEX].createdAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.data.items.[INDEX].createdAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.data.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time> | null"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.data.items.[INDEX].updatedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.data.items.[INDEX].updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.data.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"data.data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.data","typeLabel":"object[]"},"pagination":{"type":"object","properties":{"currentPage":{"type":"integer","uniqueKey":"data.pagination.currentPage","typeLabel":"integer"},"nextPage":{"oneOf":[{"type":"integer","uniqueKey":"data.pagination.nextPage.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.pagination.nextPage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.pagination.nextPage","typeLabel":"integer | null"},"prevPage":{"oneOf":[{"type":"integer","uniqueKey":"data.pagination.prevPage.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.pagination.prevPage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.pagination.prevPage","typeLabel":"integer | null"},"totalPages":{"type":"integer","uniqueKey":"data.pagination.totalPages","typeLabel":"integer"},"totalRecords":{"type":"integer","uniqueKey":"data.pagination.totalRecords","typeLabel":"integer"}},"uniqueKey":"data.pagination","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"data":[{"chatId":1234,"contact":{"id":5678,"phone":"393391234567","name":"Mario Rossi"},"status":"open","unreadMessages":2,"lastMessage":{"text":"Do you ship to Sicily?","direction":"inbound","timestamp":1794560400,"timestampIso":"2026-11-13T09:00:00.000Z"},"createdAt":"2026-11-01T09:00:00.000Z","updatedAt":"2026-11-13T09:00:00.000Z"}],"pagination":{"totalRecords":42,"currentPage":1,"totalPages":3,"nextPage":2,"prevPage":null}}},"examples":{"Example":{"title":"Example","value":{"data":{"data":[{"chatId":1234,"contact":{"id":5678,"phone":"393391234567","name":"Mario Rossi"},"status":"open","unreadMessages":2,"lastMessage":{"text":"Do you ship to Sicily?","direction":"inbound","timestamp":1794560400,"timestampIso":"2026-11-13T09:00:00.000Z"},"createdAt":"2026-11-01T09:00:00.000Z","updatedAt":"2026-11-13T09:00:00.000Z"}],"pagination":{"totalRecords":42,"currentPage":1,"totalPages":3,"nextPage":2,"prevPage":null}}}}},"exampleType":"examples"}},"exampleType":"examples"},"66c150d0-6f36-4b2a-ba26-13f01c5aef68":{"description":"Missing or invalid API key, or a key without the `WhatsApp` permission.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"ef873450-7f4c-4eb4-b089-50966dbca5b3":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"mn-API_CLIENT_ID-API_KEY","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"e1513a5e-d967-4b5b-8dd2-02144f8691ad":{"url":"https://api.minimo.it"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"mn-API_CLIENT_ID-API_KEY","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openApi.yml"},"subdomain":"minimo","siteName":"Minimo Docs","title":"List Conversations - Minimo Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T16:27:27.358Z","originalFileLocation":"api-reference/whatsapp-transport/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=\"WhatsApp conversations of your workspace, newest activity first\">\u003cmeta data-mint-head name=\"application-name\" content=\"Minimo 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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_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/minimo/CJfiX4gOkuK9_RYe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Conversations - Minimo Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"WhatsApp conversations of your workspace, newest activity first\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Minimo Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.minimo.it/api-reference/whatsapp-transport/conversations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://minimo.mintlify.site/_mintlify/api/og/v2?division=Conversations\u0026amp;title=List+Conversations\u0026amp;description=WhatsApp+conversations+of+your+workspace%2C+newest+activity+first\u0026amp;theme=06602465e78cf5662614cb8c\u0026amp;signature=36c62cd15e64297a6900989ba77f16cbe49d4c1fc0baea3ccea77488dc1bf98e\">\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 - Minimo Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"WhatsApp conversations of your workspace, newest activity first\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://minimo.mintlify.site/_mintlify/api/og/v2?division=Conversations\u0026amp;title=List+Conversations\u0026amp;description=WhatsApp+conversations+of+your+workspace%2C+newest+activity+first\u0026amp;theme=06602465e78cf5662614cb8c\u0026amp;signature=36c62cd15e64297a6900989ba77f16cbe49d4c1fc0baea3ccea77488dc1bf98e\">\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/minimo/CJfiX4gOkuK9_RYe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Minimo Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.minimo.it/api-reference/whatsapp-transport/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/whatsapp-transport/conversations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.minimo.it/#organization\",\"name\":\"Minimo Docs\",\"url\":\"https://docs.minimo.it\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/minimo/_5TQWO7ZAmNbow_0/logo/light.svg?fit=max\u0026auto=format\u0026n=_5TQWO7ZAmNbow_0\u0026q=85\u0026s=770ea7f424284ce6f88684bb97af23f0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.minimo.it#website\",\"name\":\"Minimo Docs\",\"url\":\"https://docs.minimo.it\",\"publisher\":{\"@id\":\"https://docs.minimo.it/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.minimo.it/api-reference/whatsapp-transport/conversations#webpage\",\"url\":\"https://docs.minimo.it/api-reference/whatsapp-transport/conversations\",\"name\":\"List Conversations\",\"description\":\"WhatsApp conversations of your workspace, newest activity first\",\"dateModified\":\"2026-11-13T16:27:27.358Z\",\"isPartOf\":{\"@id\":\"https://docs.minimo.it#website\"},\"breadcrumb\":{\"@id\":\"https://docs.minimo.it/api-reference/whatsapp-transport/conversations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.minimo.it/api-reference/whatsapp-transport/conversations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connect a Bot (WhatsApp)\",\"item\":\"https://docs.minimo.it/api-reference/whatsapp-transport/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Conversations\",\"item\":\"https://docs.minimo.it/api-reference/whatsapp-transport/conversations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.minimo.it/api-reference/whatsapp-transport/conversations#apireference\",\"headline\":\"List Conversations\",\"name\":\"List Conversations\",\"description\":\"WhatsApp conversations of your workspace, newest activity first\",\"url\":\"https://docs.minimo.it/api-reference/whatsapp-transport/conversations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.minimo.it/api-reference/whatsapp-transport/conversations#webpage\"},\"dateModified\":\"2026-11-13T16:27:27.358Z\",\"publisher\":{\"@id\":\"https://docs.minimo.it/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.minimo.it#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Minimo Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Minimo Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/whatsapp-transport/conversations.md","siteName":"Minimo Docs","nav":{"global":{"anchors":[{"anchor":"Sito Web","href":"https://minimo.it","icon":"desktop"},{"anchor":"Blog","href":"https://minimo.it/blog","icon":"newspaper"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Product","pages":[{"title":"Product","href":"/product/introduction"}]},{"tab":"Embedded for SaaS","pages":[{"title":"Embedded for SaaS","href":"/embedded/start-here"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/overview/introduction"},{"title":"Authentication \u0026 API Keys","href":"/api-reference/overview/authentication"},{"title":"API Conventions","href":"/api-reference/overview/conventions"}]},{"group":"Core Data","pages":[{"group":"Contacts","pages":[{"title":"Create or Update Contact","openapi":"post /public/v1/contacts","href":"/api-reference/core-data/contacts/upsert"},{"title":"Get Contact by Email","openapi":"get /public/v1/contacts/by-email/{email}","href":"/api-reference/core-data/contacts/get-by-email"},{"title":"Update Contact by ID","openapi":"put /public/v1/contacts/{id}","href":"/api-reference/core-data/contacts/update-by-id"},{"title":"Opt Out of Marketing","openapi":"post /public/v1/contacts/opt-out","href":"/api-reference/core-data/contacts/opt-out"},{"title":"Delete Contact","openapi":"delete /public/v1/contacts/{id}","href":"/api-reference/core-data/contacts/delete"}]},{"group":"Custom Fields","pages":[{"title":"List Custom Fields","openapi":"get /public/v1/custom-fields","href":"/api-reference/core-data/custom-fields/list"},{"title":"Create Custom Field","openapi":"post /public/v1/custom-fields","href":"/api-reference/core-data/custom-fields/create"}]}]},{"group":"Messaging Channels","pages":[{"group":"Email","pages":[{"title":"Send Email Template","openapi":"post /public/v1/templates/email/send","href":"/api-reference/messaging-channels/email/send-template"},{"title":"Send Transactional Email","openapi":"post /public/v1/transactionals","href":"/api-reference/messaging-channels/email/send-transactional"},{"title":"Create Email Template","href":"/api-reference/messaging-channels/email/create-template"},{"title":"List Email Templates","openapi":"get /public/v1/templates/email","href":"/api-reference/messaging-channels/email/list-templates"},{"title":"Get Email Template Stats","openapi":"get /public/v1/transactionals/{id}/stats","href":"/api-reference/messaging-channels/email/stats"},{"title":"Send One-Shot HTML Email","openapi":"post /public/v1/emails","href":"/api-reference/messaging-channels/email/send-html"},{"title":"Get One-Shot Email Statistics","openapi":"get /public/v1/emails/{id}/stats","href":"/api-reference/messaging-channels/email/html-stats"},{"group":"Scheduled Emails","pages":[{"title":"List Scheduled Emails","openapi":"get /public/v1/transactionals/scheduled","href":"/api-reference/messaging-channels/email/list-scheduled"},{"title":"Get Scheduled Email","openapi":"get /public/v1/transactionals/scheduled/{id}","href":"/api-reference/messaging-channels/email/get-scheduled"},{"title":"Cancel Scheduled Email","openapi":"delete /public/v1/transactionals/scheduled/{id}","href":"/api-reference/messaging-channels/email/cancel-scheduled-email"},{"title":"Cancel Scheduled Emails","openapi":"delete /public/v1/transactionals/scheduled","href":"/api-reference/messaging-channels/email/cancel-scheduled-emails"}]}]},{"group":"WhatsApp","pages":[{"title":"List WhatsApp Senders","openapi":"get /public/v1/templates/whatsapp/senders","href":"/api-reference/messaging-channels/whatsapp/list-senders"},{"title":"Send WhatsApp Template","openapi":"post /public/v1/templates/whatsapp/send","href":"/api-reference/messaging-channels/whatsapp/send-template"},{"title":"List WhatsApp Templates","openapi":"get /public/v1/templates/whatsapp","href":"/api-reference/messaging-channels/whatsapp/list-templates"},{"title":"Inbound \u0026 Webhooks","href":"/api-reference/messaging-channels/whatsapp/inbound-webhooks"}]}]},{"group":"Domains","pages":[{"title":"List Domains","openapi":"get /public/v1/domains","href":"/api-reference/domains/list"},{"title":"Add Domain","openapi":"post /public/v1/domains","href":"/api-reference/domains/add"},{"title":"Get Domain","openapi":"get /public/v1/domains/{id}","href":"/api-reference/domains/get"},{"title":"Verify Domain","openapi":"post /public/v1/domains/{id}/verify","href":"/api-reference/domains/verify"},{"title":"Delete Domain","openapi":"delete /public/v1/domains/{id}","href":"/api-reference/domains/delete"},{"group":"Senders","pages":[{"title":"List Senders","openapi":"get /public/v1/domains/{id}/senders","href":"/api-reference/domains/list-senders"},{"title":"Add Sender","openapi":"post /public/v1/domains/{id}/senders","href":"/api-reference/domains/add-sender"},{"title":"Update Sender","openapi":"patch /public/v1/domains/{id}/senders/{senderId}","href":"/api-reference/domains/update-sender"},{"title":"Delete Sender","openapi":"delete /public/v1/domains/{id}/senders/{senderId}","href":"/api-reference/domains/delete-sender"}]},{"group":"Domain Popup","pages":[{"title":"Update Domain Popup Settings","openapi":"put /public/v1/domains/embed-settings","href":"/api-reference/domains/update-popup-settings"},{"title":"Get Domain Popup Settings","openapi":"get /public/v1/domains/embed-settings","href":"/api-reference/domains/get-popup-settings"},{"title":"Create Domain Popup Session","openapi":"post /public/v1/domains/embed-sessions","href":"/api-reference/domains/create-popup-session"}]}]},{"group":"Embedded API","pages":[{"group":"Widgets","pages":[{"title":"Update Widget Settings","openapi":"put /public/v1/widgets/settings","href":"/api-reference/embedded/widgets/update-settings"},{"title":"Get Widget Settings","openapi":"get /public/v1/widgets/settings","href":"/api-reference/embedded/widgets/get-settings"},{"title":"Create Widget Session","openapi":"post /public/v1/widgets/sessions","href":"/api-reference/embedded/widgets/create-session"},{"title":"Revoke Widget Session","openapi":"delete /public/v1/widgets/sessions/{id}","href":"/api-reference/embedded/widgets/revoke-session"}]},{"group":"Events","pages":[{"title":"Send Event","openapi":"post /public/v1/events","href":"/api-reference/embedded/events/send-event"},{"title":"List Scheduled Sends","openapi":"get /public/v1/scheduled-sends","href":"/api-reference/embedded/events/list-scheduled-sends"},{"title":"Cancel Scheduled Sends","openapi":"delete /public/v1/scheduled-sends","href":"/api-reference/embedded/events/cancel-scheduled-sends"}]},{"group":"Rules","pages":[{"title":"List Default Rules","openapi":"get /public/v1/automation-rules","href":"/api-reference/embedded/rules/list-default-rules"},{"title":"Save Default Rules","openapi":"put /public/v1/automation-rules","href":"/api-reference/embedded/rules/save-default-rules"},{"title":"Delete Default Rule","openapi":"delete /public/v1/automation-rules/{key}","href":"/api-reference/embedded/rules/delete-default-rule"},{"title":"List Tenant Rules","openapi":"get /public/v1/tenants/{tenant}/automations","href":"/api-reference/embedded/rules/list-tenant-rules"},{"title":"Save Tenant Rules","openapi":"put /public/v1/tenants/{tenant}/automations","href":"/api-reference/embedded/rules/save-tenant-rules"},{"title":"Delete Tenant Rule","openapi":"delete /public/v1/tenants/{tenant}/automations/{key}","href":"/api-reference/embedded/rules/delete-tenant-rule"}]},{"group":"Tenants","pages":[{"title":"Get Tenant Profile","openapi":"get /public/v1/tenants/{tenant}","href":"/api-reference/embedded/tenants/get-profile"},{"title":"Save Tenant Profile","openapi":"put /public/v1/tenants/{tenant}","href":"/api-reference/embedded/tenants/save-profile"},{"title":"Record Guest Consent","openapi":"put /public/v1/tenants/{tenant}/subscriptions","href":"/api-reference/embedded/tenants/record-consent"},{"title":"Get Guest Consent","openapi":"get /public/v1/tenants/{tenant}/subscriptions","href":"/api-reference/embedded/tenants/get-consent"},{"title":"Get Tenant Stats","openapi":"get /public/v1/tenants/{tenant}/stats","href":"/api-reference/embedded/tenants/get-stats"},{"title":"Get Tenant Reputation","openapi":"get /public/v1/tenants/{tenant}/reputation","href":"/api-reference/embedded/tenants/get-reputation"},{"title":"Get Marketing Hold","openapi":"get /public/v1/tenants/{tenant}/marketing-hold","href":"/api-reference/embedded/tenants/get-marketing-hold"},{"title":"List Sent Messages","openapi":"get /public/v1/messages/list","href":"/api-reference/embedded/tenants/list-messages"}]}]},{"group":"Inbox","pages":[{"group":"Threads","pages":[{"title":"List Threads","openapi":"get /public/v1/inbox/threads","href":"/api-reference/inbox/list-threads"},{"title":"Search Threads","openapi":"get /public/v1/inbox/threads/search","href":"/api-reference/inbox/search-threads"},{"title":"Get Thread","openapi":"get /public/v1/inbox/threads/{threadId}","href":"/api-reference/inbox/get-thread"},{"title":"Update Thread","openapi":"patch /public/v1/inbox/threads/{threadId}","href":"/api-reference/inbox/update-thread"},{"title":"Turn AI Off or On","openapi":"post /public/v1/inbox/threads/{threadId}/ai","href":"/api-reference/inbox/set-ai"},{"title":"Reply to Thread","openapi":"post /public/v1/inbox/threads/{threadId}/reply","href":"/api-reference/inbox/reply"}]}]},{"group":"Connect a Bot (WhatsApp)","pages":[{"title":"Overview","href":"/api-reference/whatsapp-transport/overview"},{"group":"Messages","pages":[{"title":"Send a Message","openapi":"post /public/v1/templates/whatsapp/send","href":"/api-reference/whatsapp-transport/send"},{"title":"Download Media","openapi":"get /public/v1/media/{id}","href":"/api-reference/whatsapp-transport/media"}]},{"group":"Webhooks","pages":[{"title":"Register Webhook","openapi":"post /public/v1/webhooks/registrations","href":"/api-reference/whatsapp-transport/webhook-register"},{"title":"List Webhooks","openapi":"get /public/v1/webhooks/registrations","href":"/api-reference/whatsapp-transport/webhook-list"},{"title":"Get Webhook","openapi":"get /public/v1/webhooks/registrations/{id}","href":"/api-reference/whatsapp-transport/webhook-get"},{"title":"Update Webhook","openapi":"put /public/v1/webhooks/registrations/{id}","href":"/api-reference/whatsapp-transport/webhook-update"},{"title":"Delete Webhook","openapi":"delete /public/v1/webhooks/registrations/{id}","href":"/api-reference/whatsapp-transport/webhook-delete"},{"title":"Webhook Delivery Logs","openapi":"get /public/v1/webhooks/registrations/{id}/logs","href":"/api-reference/whatsapp-transport/webhook-logs"},{"title":"Webhook Events","description":"What Minimo sends to your webhook, how to verify the signature, retries","href":"/api-reference/whatsapp-transport/webhooks"}]},{"group":"Conversations","pages":[{"title":"List Conversations","openapi":"get /public/v1/whatsapp/conversations","href":"/api-reference/whatsapp-transport/conversations"},{"title":"List Conversation Messages","description":"The WhatsApp messages of one conversation, newest first","openapi":"get /public/v1/whatsapp/conversations/{chatId}/messages","href":"/api-reference/whatsapp-transport/conversation-messages"}]},{"title":"Handle Unsubscribe Requests","href":"/api-reference/whatsapp-transport/opt-out"},{"title":"Notes \u0026 Limits","href":"/api-reference/whatsapp-transport/notes"}]},{"group":"Legacy (Deprecated)","pages":[{"title":"Legacy API (Deprecated)","icon":"triangle-exclamation","href":"/api-reference/legacy/introduction"},{"title":"Send Email (Deprecated)","openapi":"post /api/transactionals","href":"/api-reference/legacy/send-email-deprecated"},{"title":"List Email Transactionals (Deprecated)","href":"/api-reference/legacy/list-email-transactionals-deprecated"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/connect-your-agent"}]}]},"basePath":"","title":"List Conversations - Minimo Docs","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}