Returns all of the organization’s conversations, sorted by latest activity in descending order by default. You can filter by status or by agent, and change the sort criterion. Playground test conversations aren’t included.
GET https://app.chatnorris.ai/api/v2/conversationsAuthorization: Bearer <your_api_key>
Visitor’s name (if captured, for example with the Lead Form)
visitor_email
string | null
Visitor’s email (if captured)
status
string
Status: bot (in progress), handoff (waiting for an agent), open (being handled), closed
channel
string
Channel: web, whatsapp, instagram, telegram, messenger, email or api (conversations created with the API)
created_at
string
Start date (ISO 8601)
updated_at
string
Latest activity (ISO 8601)
To do incremental polling (for example, to sync new conversations to another system), combine created_after with order_by=created_at and save the created_at of the last result as the starting point for the next query.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ChatNorris","description":"Es una plataforma de software (SaaS) diseñada para la creación, entrenamiento e integración de agentes de inteligencia artificial conversacional. Permite a las empresas conectar sus propias fuentes de conocimiento (documentos, bases de datos, sitios web) con modelos de lenguaje avanzado (LLM) para automatizar la atención al cliente, la calificación de leads y el soporte técnico a través de canales como chat web, WhatsApp, Instagram, Email y APIs REST.","colors":{"primary":"#00684a"},"logo":{"light":"https://mintcdn.com/chatnorris/C7dG5iKgOxsklb8M/logo/CHATNORRIS-13.png?fit=max\u0026auto=format\u0026n=C7dG5iKgOxsklb8M\u0026q=85\u0026s=bc796e7ce8bab6310161819831697d8b","dark":"https://mintcdn.com/chatnorris/C7dG5iKgOxsklb8M/logo/CHATNORRIS-12.png?fit=max\u0026auto=format\u0026n=C7dG5iKgOxsklb8M\u0026q=85\u0026s=cabc011ce5678929a66abcdc51275e61","href":"https://chatnorris.ai"},"favicon":"https://mintcdn.com/chatnorris/HfkbgDl7nYoL6O1U/logo/favicon.ico?fit=max\u0026auto=format\u0026n=HfkbgDl7nYoL6O1U\u0026q=85\u0026s=215355408319eecb3f400994c58b4c12","footer":{"socials":{"website":"https://chatnorris.ai/","instagram":"https://instagram.com/chatnorris.ai","youtube":"https://youtube.com/@chatnorris-ai"}},"integrations":{"ga4":{"measurementId":"G-BMDL4EC90N"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"es","default":true,"navbar":{"primary":{"type":"button","label":"Empezar","href":"https://app.chatnorris.ai/register"}},"href":""},{"language":"en","navbar":{"primary":{"type":"button","label":"Get started","href":"https://app.chatnorris.ai/register"}},"href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chatnorris","hasAudioNarration":false,"actualSubdomain":"chatnorris","customDomains":["docs.chatnorris.ai"],"gitSource":{"type":"github","owner":"chatnorris","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"09ab15ba-4b70-4e38-8f4f-14c53b6ded3c","liveDeploymentHistoryId":"6ae67ed462ef36be8862d082","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae67ed462ef36be8862d082"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae67ed462ef36be8862d082","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"es","tag":"API Pública v2","count":23},{"language":"en","tag":"Public API v2","count":23},{"language":"es","tag":"Agentes de IA","count":11},{"language":"en","tag":"AI agents","count":11},{"language":"es","tag":"Agentes","count":7},{"language":"en","tag":"Agents","count":7},{"language":"es","tag":"Base de conocimiento","count":4},{"language":"es","tag":"Conversaciones y Live Chat","count":4},{"language":"es","tag":"Primeros pasos","count":4},{"language":"en","tag":"Knowledge Base","count":4},{"language":"en","tag":"Conversations and live chat","count":4},{"language":"en","tag":"Getting started","count":4},{"language":"es","tag":"Conversaciones","count":3},{"language":"es","tag":"Facturación","count":3},{"language":"es","tag":"Canales","count":3},{"language":"es","tag":"Solución de problemas","count":3},{"language":"en","tag":"Conversations","count":3},{"language":"en","tag":"Billing","count":3},{"language":"en","tag":"Channels","count":3},{"language":"en","tag":"Troubleshooting","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-referencia/conversaciones/listar","slug":"/en/api-referencia/conversaciones/listar","pageMetadata":{"title":"List conversations","description":"Get the paginated list of your organization's conversations.","href":"/en/api-referencia/conversaciones/listar"},"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: \"Get the paginated list of your organization’s conversations.\"\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={code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`list-conversations`,children:`List conversations`}),`\n`,_jsx(_components.p,{children:`Returns all of the organization’s conversations, sorted by latest activity in descending order by default. You can filter by status or by agent, and change the sort criterion. Playground test conversations aren’t included.`}),`\n`,`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Required scope:`}),` `,_jsx(_components.code,{children:`conversations:read`})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Filter by status: `,_jsx(_components.code,{children:`bot`}),`, `,_jsx(_components.code,{children:`handoff`}),`, `,_jsx(_components.code,{children:`open`}),` or `,_jsx(_components.code,{children:`closed`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`chatbot_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Filter by agent`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`created_after`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Only conversations created after this date (ISO 8601, e.g. `,_jsx(_components.code,{children:`2026-09-01T00:00:00Z`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`order_by`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Sort field: `,_jsx(_components.code,{children:`created_at`}),` or `,_jsx(_components.code,{children:`updated_at`}),`. Default: `,_jsx(_components.code,{children:`updated_at`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Page number. Default: `,_jsx(_components.code,{children:`1`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`per_page`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Results per page. Default: `,_jsx(_components.code,{children:`25`}),`, maximum `,_jsx(_components.code,{children:`100`})]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`24`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`24`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"conversations\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"conv_abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"chatbot_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bot_xyz789\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"visitor_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"visitor_001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"visitor_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Juan Pérez\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"visitor_email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"juan@empresa.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"closed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"channel\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"web\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-28T14:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-28T14:35:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"current_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"per_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`25`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`240`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`response-fields`,children:`Response fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Unique ID of the conversation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`chatbot_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`ID of the agent that handled the conversation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visitor_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Visitor identifier (generated automatically)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visitor_name`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Visitor’s name (if captured, for example with the Lead Form)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visitor_email`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Visitor’s email (if captured)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Status: `,_jsx(_components.code,{children:`bot`}),` (in progress), `,_jsx(_components.code,{children:`handoff`}),` (waiting for an agent), `,_jsx(_components.code,{children:`open`}),` (being handled), `,_jsx(_components.code,{children:`closed`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`channel`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Channel: `,_jsx(_components.code,{children:`web`}),`, `,_jsx(_components.code,{children:`whatsapp`}),`, `,_jsx(_components.code,{children:`instagram`}),`, `,_jsx(_components.code,{children:`telegram`}),`, `,_jsx(_components.code,{children:`messenger`}),`, `,_jsx(_components.code,{children:`email`}),` or `,_jsx(_components.code,{children:`api`}),` (conversations created with the API)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`created_at`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Start date (ISO 8601)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updated_at`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Latest activity (ISO 8601)`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`To do incremental polling (for example, to sync new conversations to another system), combine `,_jsx(_components.code,{children:`created_after`}),` with `,_jsx(_components.code,{children:`order_by=created_at`}),` and save the `,_jsx(_components.code,{children:`created_at`}),` of the last result as the starting point for the next query.`]})})]})}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":"Get the paginated list of your organization's conversations.","href":"/en/api-referencia/conversaciones/listar"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,RequestExample,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`list-conversations`,children:`List conversations`}),`\n`,_jsx(_components.p,{children:`Returns all of the organization’s conversations, sorted by latest activity in descending order by default. You can filter by status or by agent, and change the sort criterion. Playground test conversations aren’t included.`}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`GET`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://app.chatnorris.ai/api/v2/conversations`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer \u003cyour_api_key>`})]}),`\n`]})})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Required scope:`}),` `,_jsx(_components.code,{children:`conversations:read`})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Filter by status: `,_jsx(_components.code,{children:`bot`}),`, `,_jsx(_components.code,{children:`handoff`}),`, `,_jsx(_components.code,{children:`open`}),` or `,_jsx(_components.code,{children:`closed`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`chatbot_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Filter by agent`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`created_after`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Only conversations created after this date (ISO 8601, e.g. `,_jsx(_components.code,{children:`2026-09-01T00:00:00Z`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`order_by`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Sort field: `,_jsx(_components.code,{children:`created_at`}),` or `,_jsx(_components.code,{children:`updated_at`}),`. Default: `,_jsx(_components.code,{children:`updated_at`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Page number. Default: `,_jsx(_components.code,{children:`1`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`per_page`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Results per page. Default: `,_jsx(_components.code,{children:`25`}),`, maximum `,_jsx(_components.code,{children:`100`})]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`24`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`24`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"conversations\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"conv_abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"chatbot_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bot_xyz789\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"visitor_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"visitor_001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"visitor_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Juan Pérez\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"visitor_email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"juan@empresa.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"closed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"channel\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"web\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-28T14:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-28T14:35:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"current_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"per_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`25`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`240`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`response-fields`,children:`Response fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Unique ID of the conversation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`chatbot_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`ID of the agent that handled the conversation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visitor_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Visitor identifier (generated automatically)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visitor_name`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Visitor’s name (if captured, for example with the Lead Form)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visitor_email`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Visitor’s email (if captured)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Status: `,_jsx(_components.code,{children:`bot`}),` (in progress), `,_jsx(_components.code,{children:`handoff`}),` (waiting for an agent), `,_jsx(_components.code,{children:`open`}),` (being handled), `,_jsx(_components.code,{children:`closed`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`channel`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Channel: `,_jsx(_components.code,{children:`web`}),`, `,_jsx(_components.code,{children:`whatsapp`}),`, `,_jsx(_components.code,{children:`instagram`}),`, `,_jsx(_components.code,{children:`telegram`}),`, `,_jsx(_components.code,{children:`messenger`}),`, `,_jsx(_components.code,{children:`email`}),` or `,_jsx(_components.code,{children:`api`}),` (conversations created with the API)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`created_at`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Start date (ISO 8601)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updated_at`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Latest activity (ISO 8601)`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`To do incremental polling (for example, to sync new conversations to another system), combine `,_jsx(_components.code,{children:`created_after`}),` with `,_jsx(_components.code,{children:`order_by=created_at`}),` and save the `,_jsx(_components.code,{children:`created_at`}),` of the last result as the starting point for the next query.`]})})]})}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":"Get the paginated list of your organization's conversations.","href":"/en/api-referencia/conversaciones/listar"}}}},"mdxExtracts":{"tableOfContents":[{"title":"List conversations","slug":"list-conversations","depth":1,"children":[]},{"title":"Query parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Response fields","slug":"response-fields","depth":3,"children":[]}]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"http\">\u003ccode language=\"http\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">GET\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> https://app.chatnorris.ai/api/v2/conversations\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">Authorization\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> Bearer \u0026#x3C;your_api_key>\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":[],"subdomain":"chatnorris","siteName":"ChatNorris","title":"List conversations - ChatNorris","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/api-referencia/conversaciones/listar","matchLevel":1},"en":{"href":"/en/api-referencia/conversaciones/listar","matchLevel":0}}},"lastModified":"2026-10-31T23:50:50.175Z","originalFileLocation":"en/api-referencia/conversaciones/listar.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get the paginated list of your organization\u0026#x27;s conversations.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ChatNorris\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chatnorris/HS18VnAMMck2xfaq/_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/chatnorris/HS18VnAMMck2xfaq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chatnorris/HS18VnAMMck2xfaq/_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/chatnorris/HS18VnAMMck2xfaq/_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/chatnorris/HS18VnAMMck2xfaq/_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/chatnorris/HS18VnAMMck2xfaq/_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/chatnorris/HS18VnAMMck2xfaq/_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/chatnorris/HS18VnAMMck2xfaq/_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/chatnorris/HS18VnAMMck2xfaq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List conversations - ChatNorris\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get the paginated list of your organization\u0026#x27;s conversations.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ChatNorris\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chatnorris.mintlify.app/_mintlify/api/og/v2?division=Conversations\u0026amp;title=List+conversations\u0026amp;description=Get+the+paginated+list+of+your+organization%27s+conversations.\u0026amp;theme=7ea039df46d46592821da886\u0026amp;signature=6043fd027078e6762d0ef545b4c4d20bf704837d0ec41d3106d4d2f93c741134\">\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 - ChatNorris\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get the paginated list of your organization\u0026#x27;s conversations.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chatnorris.mintlify.app/_mintlify/api/og/v2?division=Conversations\u0026amp;title=List+conversations\u0026amp;description=Get+the+paginated+list+of+your+organization%27s+conversations.\u0026amp;theme=7ea039df46d46592821da886\u0026amp;signature=6043fd027078e6762d0ef545b4c4d20bf704837d0ec41d3106d4d2f93c741134\">\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/chatnorris/HS18VnAMMck2xfaq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ChatNorris\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00684a\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/api-referencia/conversaciones/listar.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.chatnorris.ai/api-referencia/conversaciones/listar\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.chatnorris.ai/api-referencia/conversaciones/listar\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.chatnorris.ai/#organization\",\"name\":\"ChatNorris\",\"url\":\"https://docs.chatnorris.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chatnorris/C7dG5iKgOxsklb8M/logo/CHATNORRIS-13.png?fit=max\u0026auto=format\u0026n=C7dG5iKgOxsklb8M\u0026q=85\u0026s=bc796e7ce8bab6310161819831697d8b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.chatnorris.ai#website\",\"name\":\"ChatNorris\",\"url\":\"https://docs.chatnorris.ai\",\"publisher\":{\"@id\":\"https://docs.chatnorris.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar#webpage\",\"url\":\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar\",\"name\":\"List conversations\",\"description\":\"Get the paginated list of your organization's conversations.\",\"dateModified\":\"2026-10-31T23:50:50.175Z\",\"isPartOf\":{\"@id\":\"https://docs.chatnorris.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Public API v2\",\"item\":\"https://docs.chatnorris.ai/en/api-referencia/introduccion\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List conversations\",\"item\":\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar#article\",\"headline\":\"List conversations\",\"name\":\"List conversations\",\"description\":\"Get the paginated list of your organization's conversations.\",\"url\":\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar\",\"mainEntityOfPage\":{\"@id\":\"https://docs.chatnorris.ai/en/api-referencia/conversaciones/listar#webpage\"},\"dateModified\":\"2026-10-31T23:50:50.175Z\",\"publisher\":{\"@id\":\"https://docs.chatnorris.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.chatnorris.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ChatNorris\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ChatNorris","nav":{"global":null,"languages":[{"language":"es","default":true,"navbar":{"primary":{"type":"button","label":"Empezar","href":"https://app.chatnorris.ai/register"}},"pages":[{"title":"es","href":"/api-referencia/conversaciones/listar"}]},{"language":"en","navbar":{"primary":{"type":"button","label":"Get started","href":"https://app.chatnorris.ai/register"}},"groups":[{"group":"Getting started","pages":[{"title":"ChatNorris Help Center","href":"/en"},{"title":"Welcome to ChatNorris","href":"/en/primeros-pasos/bienvenida"},{"title":"Create your account","href":"/en/primeros-pasos/crear-cuenta"},{"title":"First use","href":"/en/primeros-pasos/primer-uso"}]},{"group":"AI agents","pages":[{"title":"AI agents","href":"/en/guias/chatbots"},{"title":"Create an agent — step-by-step wizard","href":"/en/guias/crear-agente-wizard"},{"title":"AI models and credits","href":"/en/guias/modelos-ia-creditos"},{"title":"Knowledge Base","href":"/en/guias/knowledge-base"},{"title":"Integrations","href":"/en/guias/integraciones"},{"title":"Pipedrive","sidebarTitle":"Pipedrive","icon":"handshake","href":"/en/guias/pipedrive"},{"title":"Jumpseller","sidebarTitle":"Jumpseller","icon":"bag-shopping","href":"/en/guias/jumpseller"},{"title":"Laudus","sidebarTitle":"Laudus","icon":"building","href":"/en/guias/laudus"},{"title":"Google Sheets","sidebarTitle":"Google Sheets","icon":"table","href":"/en/guias/google-sheets"},{"title":"Agent actions","href":"/en/guias/acciones"},{"title":"Advanced agent settings","href":"/en/guias/configuracion-avanzada-agente"}]},{"group":"Web widget","pages":[{"title":"Install the widget on your website","href":"/en/guias/widget-instalacion"},{"title":"Customize the widget","href":"/en/guias/widget-personalizacion"}]},{"group":"Channels","pages":[{"title":"Connect messaging channels","href":"/en/guias/canales-whatsapp-instagram"},{"title":"Connect the Email channel","href":"/en/guias/canal-email"},{"title":"Reply to Google reviews","href":"/en/guias/canal-google-reviews"}]},{"group":"Conversations and live chat","pages":[{"title":"Conversations","href":"/en/guias/conversaciones"},{"title":"Live chat and handoff to an agent","href":"/en/guias/chat-en-vivo-handoff"},{"title":"ChatNorris Inbox (mobile app)","href":"/en/guias/chatnorris-inbox"},{"title":"Notifications","href":"/en/guias/notificaciones"}]},{"group":"Campaigns","pages":[{"title":"Campaigns","href":"/en/guias/campanas"}]},{"group":"Leads and analytics","pages":[{"title":"Leads","href":"/en/guias/leads"},{"title":"Analytics","href":"/en/guias/analytics"}]},{"group":"Team","pages":[{"title":"Manage your team","href":"/en/guias/equipo"}]},{"group":"Account and settings","pages":[{"title":"Manage your account","href":"/en/cuenta-y-facturacion/gestionar-cuenta"},{"title":"Partner program","href":"/en/cuenta-y-facturacion/programa-de-partners"}]},{"group":"Billing","pages":[{"title":"Billing and payments","href":"/en/cuenta-y-facturacion/facturacion-y-pagos"},{"title":"Add-ons","href":"/en/cuenta-y-facturacion/addons"},{"title":"Invoices","href":"/en/cuenta-y-facturacion/facturas"}]},{"group":"Troubleshooting","pages":[{"title":"The agent doesn't reply","href":"/en/solucion-de-problemas/chatbot-no-responde"},{"title":"A channel won't connect","href":"/en/solucion-de-problemas/canal-no-conecta"},{"title":"Credit limit reached","href":"/en/solucion-de-problemas/limite-mensajes-alcanzado"}]},{"group":"FAQ","pages":[{"title":"Frequently asked questions","href":"/en/faq/preguntas-frecuentes"}]},{"group":"Glossary","pages":[{"title":"Glossary of terms","href":"/en/glosario/terminos"}]},{"group":"Public API v2","pages":[{"title":"Introduction to the API","href":"/en/api-referencia/introduccion"},{"title":"Project","href":"/en/api-referencia/proyecto"},{"group":"Agents","pages":[{"title":"List agents","href":"/en/api-referencia/agentes/listar"},{"title":"Create agent","href":"/en/api-referencia/agentes/crear"},{"title":"Get agent","href":"/en/api-referencia/agentes/obtener"},{"title":"Update agent","href":"/en/api-referencia/agentes/actualizar"},{"title":"Delete agent","href":"/en/api-referencia/agentes/eliminar"},{"title":"Send message (Chat)","href":"/en/api-referencia/agentes/chat"},{"title":"Upload attachment","href":"/en/api-referencia/agentes/adjuntos"}]},{"group":"Knowledge Base","pages":[{"title":"List sources","href":"/en/api-referencia/knowledge/listar"},{"title":"Add source","href":"/en/api-referencia/knowledge/agregar"},{"title":"Delete source","href":"/en/api-referencia/knowledge/eliminar"},{"title":"Re-sync source","description":"Reprocess a knowledge base source to update its content.","href":"/en/api-referencia/knowledge/resync"}]},{"group":"Conversations","pages":[{"title":"List conversations","href":"/en/api-referencia/conversaciones/listar"},{"title":"Get conversation","description":"Retrieve a conversation's details by its ID.","href":"/en/api-referencia/conversaciones/obtener"},{"title":"List messages","href":"/en/api-referencia/conversaciones/mensajes"}]},{"group":"Leads","pages":[{"title":"List leads","href":"/en/api-referencia/leads/listar"},{"title":"Get lead","href":"/en/api-referencia/leads/obtener"}]},{"group":"Automation (Zapier and n8n)","pages":[{"title":"Zapier","href":"/en/api-referencia/zapier"},{"title":"n8n","href":"/en/api-referencia/n8n"}]},{"title":"Channels","href":"/en/api-referencia/canales"},{"title":"Members","href":"/en/api-referencia/miembros"},{"title":"Usage","href":"/en/api-referencia/uso"}]}]}]},"basePath":"","title":"List conversations - ChatNorris","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["2b790eda92"],"chunks":["ApiExamples-D5rWArI6.js","utils-DDTCYAF2.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","cloneDeep-izs3Hzxb.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js"]}
