{ "statusCode": 200, "data": [ { "id": "5f0c1d2e-3a4b-4c5d-8e6f-7a8b9c0d1e2f", "thread_id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901", "channel_id": "chn_w4b4e5x4mp1e0000000000", "channel_name": "WhatsApp Business", "contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012", "contact_name": "Ana Gómez", "contact_phone": "+573001234567", "status": "closed", "started_at": "2026-11-14T15:03:26Z", "ended_at": "2026-11-14T16:10:02Z", "message_count": 12, "user_message_count": 5, "first_response_at": "2026-11-14T15:03:41Z", "is_returning": true, "handled_by": "mixed", "escalated_at": "2026-11-14T15:20:00Z", "escalated_by_type": "user", "analyzed_at": "2026-11-14T16:11:30Z", "analysis": { "session_summary": "The contact asked to reschedule a delivery and was handed to an agent, who confirmed the new date.", "user_sentiment": "Positive", "session_successful": true, "custom_analysis_data": {} } } ], "pagination": { "page": 1, "total_rows": 53, "total_pages": 2 }}
Returns the conversations of a WhatsApp channel that started between two dates, newest first, one page at a time. They are the same conversations as Reports → Sessions in the app.A thread is the whole chat with a contact on a channel and never ends. A conversation is one stretch of that thread: it opens with new activity and closes after a period without messages, so one thread has many conversations. To read the messages of a conversation, call List Thread Messages with its thread_id and session_id set to its id.
Only WhatsApp (WABA) channels have conversations. For any other channel the list is empty.
Headers
string
requerido
Your API key for authentication. An organization key lists every conversation of the channel. A personal key needs the messages.read permission and the channel inside its role’s channels; it lists only the conversations of threads its user can see in the inbox.
First day of the range, YYYY-MM-DD. A conversation is in the range when it started in it.
string
requerido
Last day of the range, included, YYYY-MM-DD. It cannot be before start_date.
string
predeterminado:"UTC"
IANA time zone the two days are read in, e.g. America/Bogota. An unknown zone is read as UTC.
number
predeterminado:"50"
Conversations per page, from 1 to 100.
number
predeterminado:"0"
Number of conversations to skip, up to 10000.
Response
array
Conversations of the page, newest first.
Mostrar Conversation object
string
Unique identifier of the conversation (UUID). Pass it as session_id to List Thread Messages.
string
UUID of the thread the conversation belongs to.
string
ID of the channel.
string
Display name of the channel.
string
UUID of the contact.
string
Full name of the contact.
string
Phone number of the contact.
string
open while the conversation is active, closed once it ended.
string
When the conversation started (ISO 8601).
string
When it closed (ISO 8601). null while it is open.
number
Messages in the conversation.
number
Messages the contact sent.
string
When the first reply to the contact was sent, by the AI agent or a person (ISO 8601), or null.
boolean
true when the contact had an earlier conversation on this channel.
string
Who answered: ai, human, mixed or none. null while the conversation is open, and for conversations that closed before September 7, 2026.
string
When the conversation was handed from the AI agent to a person (ISO 8601), or null.
string
Who made the handoff: agent (the AI agent escalated), user (a person on your team took the conversation over) or system (a rule or automation). null when there was none.
string
When the conversation was analyzed (ISO 8601), or null.
object
The analysis written when the conversation closes, only on channels with conversation analysis turned on; null otherwise.
Mostrar Analysis object
string
Summary of the conversation.
string
Sentiment of the contact: Positive, Neutral or Negative.
boolean
Whether the conversation reached its goal.
object
The custom fields set up for the channel’s analysis.
object
Mostrar Pagination object
number
Page number, from 1.
number
Conversations in the range.
number
Pages at the requested limit.
The conversation does not carry who it was assigned to: read the thread’s assignee with Get Thread, or the sender_id of each message.
Error Codes
400 Bad Request — A parameter is missing or invalid, or end_date is before start_date
401 Unauthorized — Invalid or missing API key
403 Forbidden — The personal key lacks messages.read, or the channel is not among its role’s channels
429 Too Many Requests — Rate limit exceeded, see Rate limits
500 Internal Server Error — Server-side error
Code Examples
curl -X GET "https://api.contactship.ai/v1/conversations?channel_id=chn_w4b4e5x4mp1e0000000000&start_date=2026-11-01&end_date=2026-11-15&timezone=America/Bogota&limit=100" \ -H "x-api-key: your-api-key"
{ "statusCode": 200, "data": [ { "id": "5f0c1d2e-3a4b-4c5d-8e6f-7a8b9c0d1e2f", "thread_id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901", "channel_id": "chn_w4b4e5x4mp1e0000000000", "channel_name": "WhatsApp Business", "contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012", "contact_name": "Ana Gómez", "contact_phone": "+573001234567", "status": "closed", "started_at": "2026-11-14T15:03:26Z", "ended_at": "2026-11-14T16:10:02Z", "message_count": 12, "user_message_count": 5, "first_response_at": "2026-11-14T15:03:41Z", "is_returning": true, "handled_by": "mixed", "escalated_at": "2026-11-14T15:20:00Z", "escalated_by_type": "user", "analyzed_at": "2026-11-14T16:11:30Z", "analysis": { "session_summary": "The contact asked to reschedule a delivery and was handed to an agent, who confirmed the new date.", "user_sentiment": "Positive", "session_successful": true, "custom_analysis_data": {} } } ], "pagination": { "page": 1, "total_rows": 53, "total_pages": 2 }}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"ContactShip Docs","colors":{"primary":"#0252ff","light":"#1E89FF","dark":"#0252ff"},"logo":{"light":"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/logo/Isologotipo.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=1100afd12fc8debe15faade6766a53c7","dark":"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/logo/Isologotipo.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=1100afd12fc8debe15faade6766a53c7"},"favicon":"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/favicon2.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=2522034f500b8c3c60f46aed56daad87","api":{"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.contactship.ai"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"es","default":true,"href":"es/comenzar/que-es-contactship"},{"language":"en","href":"en/get-started/what-is-contactship"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"contactship","hasAudioNarration":false,"actualSubdomain":"contactship","customDomains":["docs.contactship.ai"],"gitSource":{"type":"github","owner":"serranomatias","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afddde1e3a51766e8138724","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"en","tag":"Documentation","count":87},{"language":"es","tag":"Documentación","count":87},{"language":"default","tag":"API Reference","count":52},{"language":"en","tag":"Integrations","count":13},{"language":"es","tag":"Integraciones","count":13},{"language":"default","tag":"Contactos","count":12},{"language":"en","tag":"Use cases","count":12},{"language":"es","tag":"Casos de uso","count":12},{"language":"en","tag":"Voice agents","count":10},{"language":"es","tag":"Agentes de voz","count":10},{"language":"en","tag":"Contacts","count":8},{"language":"en","tag":"Messages","count":8},{"language":"es","tag":"Contactos","count":8},{"language":"es","tag":"Mensajes","count":8},{"language":"en","tag":"Get started","count":7},{"language":"en","tag":"Organization","count":7},{"language":"es","tag":"Comenzar","count":7},{"language":"es","tag":"Organización","count":7},{"language":"default","tag":"Agentes","count":6},{"language":"default","tag":"Canales y conversaciones","count":6},{"language":"default","tag":"Documentación API","count":6},{"language":"en","tag":"Calls","count":6},{"language":"en","tag":"Text agents","count":6},{"language":"es","tag":"Agentes de texto","count":6},{"language":"es","tag":"Llamadas","count":6},{"language":"default","tag":"WhatsApp (WABA)","count":5},{"language":"default","tag":"Etiquetas","count":4},{"language":"default","tag":"Llamadas","count":4},{"language":"default","tag":"Tareas","count":3},{"language":"default","tag":"Eventos","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"globals.css","content":".rounded-image{border-radius:8px}"}],"page":{"pagePath":"api-reference/endpoint/list-conversations","slug":"/api-reference/endpoint/list-conversations","pageMetadata":{"title":"List Conversations","api":"GET /v1/conversations","description":"List the WhatsApp conversations of a channel that started in a date range","href":"/api-reference/endpoint/list-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: \"List the WhatsApp conversations of a channel that started in a date range\"\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`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,Note,ParamField,ResponseField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns the conversations of a WhatsApp channel that started between two dates, newest first, one page at a time. They are the same conversations as `,_jsx(_components.strong,{children:`Reports → Sessions`}),` in the app.`]}),`\n`,_jsxs(_components.p,{children:[`A thread is the whole chat with a contact on a channel and never ends. A conversation is one stretch of that thread: it opens with new activity and closes after a period without messages, so one thread has many conversations. To read the messages of a conversation, call `,_jsx(_components.a,{href:`/api-reference/endpoint/get-thread-messages`,children:`List Thread Messages`}),` with its `,_jsx(_components.code,{children:`thread_id`}),` and `,_jsx(_components.code,{children:`session_id`}),` set to its `,_jsx(_components.code,{children:`id`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Only WhatsApp (`,_jsx(_components.code,{children:`WABA`}),`) channels have conversations. For any other channel the list is empty.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-api-key`,type:`string`,required:true,id:`param-x-api-key`,children:_jsxs(_components.p,{children:[`Your API key for authentication. An organization key lists every conversation of the channel. A personal key needs the `,_jsx(_components.code,{children:`messages.read`}),` permission and the channel inside its role’s channels; it lists only the conversations of threads its user can see in the inbox.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`channel_id`,type:`string`,required:true,id:`param-channel-id`,children:_jsxs(_components.p,{children:[`ID of the WhatsApp channel, from `,_jsx(_components.a,{href:`/api-reference/endpoint/get-channels`,children:`List Channels`}),`.`]})}),`\n`,_jsx(ParamField,{query:`start_date`,type:`string`,required:true,id:`param-start-date`,children:_jsxs(_components.p,{children:[`First day of the range, `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. A conversation is in the range when it started in it.`]})}),`\n`,_jsx(ParamField,{query:`end_date`,type:`string`,required:true,id:`param-end-date`,children:_jsxs(_components.p,{children:[`Last day of the range, included, `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. It cannot be before `,_jsx(_components.code,{children:`start_date`}),`.`]})}),`\n`,_jsx(ParamField,{query:`timezone`,type:`string`,default:`UTC`,id:`param-timezone`,children:_jsxs(_components.p,{children:[`IANA time zone the two days are read in, e.g. `,_jsx(_components.code,{children:`America/Bogota`}),`. An unknown zone is read as UTC.`]})}),`\n`,_jsx(ParamField,{query:`limit`,type:`number`,default:`50`,id:`param-limit`,children:_jsx(_components.p,{children:`Conversations per page, from 1 to 100.`})}),`\n`,_jsx(ParamField,{query:`offset`,type:`number`,default:`0`,id:`param-offset`,children:_jsx(_components.p,{children:`Number of conversations to skip, up to 10000.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`data`,type:`array`,id:`param-data`,children:[_jsx(_components.p,{children:`Conversations of the page, newest first.`}),_jsxs(Expandable,{title:`Conversation object`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsxs(_components.p,{children:[`Unique identifier of the conversation (UUID). Pass it as `,_jsx(_components.code,{children:`session_id`}),` to `,_jsx(_components.a,{href:`/api-reference/endpoint/get-thread-messages`,children:`List Thread Messages`}),`.`]})}),_jsx(ResponseField,{name:`thread_id`,type:`string`,id:`param-thread-id`,children:_jsx(_components.p,{children:`UUID of the thread the conversation belongs to.`})}),_jsx(ResponseField,{name:`channel_id`,type:`string`,id:`param-channel-id-1`,children:_jsx(_components.p,{children:`ID of the channel.`})}),_jsx(ResponseField,{name:`channel_name`,type:`string`,id:`param-channel-name`,children:_jsx(_components.p,{children:`Display name of the channel.`})}),_jsx(ResponseField,{name:`contact_id`,type:`string`,id:`param-contact-id`,children:_jsx(_components.p,{children:`UUID of the contact.`})}),_jsx(ResponseField,{name:`contact_name`,type:`string`,id:`param-contact-name`,children:_jsx(_components.p,{children:`Full name of the contact.`})}),_jsx(ResponseField,{name:`contact_phone`,type:`string`,id:`param-contact-phone`,children:_jsx(_components.p,{children:`Phone number of the contact.`})}),_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`open`}),` while the conversation is active, `,_jsx(_components.code,{children:`closed`}),` once it ended.`]})}),_jsx(ResponseField,{name:`started_at`,type:`string`,id:`param-started-at`,children:_jsx(_components.p,{children:`When the conversation started (ISO 8601).`})}),_jsx(ResponseField,{name:`ended_at`,type:`string`,id:`param-ended-at`,children:_jsxs(_components.p,{children:[`When it closed (ISO 8601). `,_jsx(_components.code,{children:`null`}),` while it is open.`]})}),_jsx(ResponseField,{name:`message_count`,type:`number`,id:`param-message-count`,children:_jsx(_components.p,{children:`Messages in the conversation.`})}),_jsx(ResponseField,{name:`user_message_count`,type:`number`,id:`param-user-message-count`,children:_jsx(_components.p,{children:`Messages the contact sent.`})}),_jsx(ResponseField,{name:`first_response_at`,type:`string`,id:`param-first-response-at`,children:_jsxs(_components.p,{children:[`When the first reply to the contact was sent, by the AI agent or a person (ISO 8601), or `,_jsx(_components.code,{children:`null`}),`.`]})}),_jsx(ResponseField,{name:`is_returning`,type:`boolean`,id:`param-is-returning`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when the contact had an earlier conversation on this channel.`]})}),_jsx(ResponseField,{name:`handled_by`,type:`string`,id:`param-handled-by`,children:_jsxs(_components.p,{children:[`Who answered: `,_jsx(_components.code,{children:`ai`}),`, `,_jsx(_components.code,{children:`human`}),`, `,_jsx(_components.code,{children:`mixed`}),` or `,_jsx(_components.code,{children:`none`}),`. `,_jsx(_components.code,{children:`null`}),` while the conversation is open, and for conversations that closed before September 7, 2026.`]})}),_jsx(ResponseField,{name:`escalated_at`,type:`string`,id:`param-escalated-at`,children:_jsxs(_components.p,{children:[`When the conversation was handed from the AI agent to a person (ISO 8601), or `,_jsx(_components.code,{children:`null`}),`.`]})}),_jsx(ResponseField,{name:`escalated_by_type`,type:`string`,id:`param-escalated-by-type`,children:_jsxs(_components.p,{children:[`Who made the handoff: `,_jsx(_components.code,{children:`agent`}),` (the AI agent escalated), `,_jsx(_components.code,{children:`user`}),` (a person on your team took the conversation over) or `,_jsx(_components.code,{children:`system`}),` (a rule or automation). `,_jsx(_components.code,{children:`null`}),` when there was none.`]})}),_jsx(ResponseField,{name:`analyzed_at`,type:`string`,id:`param-analyzed-at`,children:_jsxs(_components.p,{children:[`When the conversation was analyzed (ISO 8601), or `,_jsx(_components.code,{children:`null`}),`.`]})}),_jsxs(ResponseField,{name:`analysis`,type:`object`,id:`param-analysis`,children:[_jsxs(_components.p,{children:[`The analysis written when the conversation closes, only on channels with conversation analysis turned on; `,_jsx(_components.code,{children:`null`}),` otherwise.`]}),_jsxs(Expandable,{title:`Analysis object`,children:[_jsx(ResponseField,{name:`session_summary`,type:`string`,id:`param-session-summary`,children:_jsx(_components.p,{children:`Summary of the conversation.`})}),_jsx(ResponseField,{name:`user_sentiment`,type:`string`,id:`param-user-sentiment`,children:_jsxs(_components.p,{children:[`Sentiment of the contact: `,_jsx(_components.code,{children:`Positive`}),`, `,_jsx(_components.code,{children:`Neutral`}),` or `,_jsx(_components.code,{children:`Negative`}),`.`]})}),_jsx(ResponseField,{name:`session_successful`,type:`boolean`,id:`param-session-successful`,children:_jsx(_components.p,{children:`Whether the conversation reached its goal.`})}),_jsx(ResponseField,{name:`custom_analysis_data`,type:`object`,id:`param-custom-analysis-data`,children:_jsx(_components.p,{children:`The custom fields set up for the channel’s analysis.`})})]})]})]})]}),`\n`,_jsx(ResponseField,{name:`pagination`,type:`object`,id:`param-pagination`,children:_jsxs(Expandable,{title:`Pagination object`,children:[_jsx(ResponseField,{name:`page`,type:`number`,id:`param-page`,children:_jsx(_components.p,{children:`Page number, from 1.`})}),_jsx(ResponseField,{name:`total_rows`,type:`number`,id:`param-total-rows`,children:_jsx(_components.p,{children:`Conversations in the range.`})}),_jsx(ResponseField,{name:`total_pages`,type:`number`,id:`param-total-pages`,children:_jsxs(_components.p,{children:[`Pages at the requested `,_jsx(_components.code,{children:`limit`}),`.`]})})]})}),`\n`,_jsxs(_components.p,{children:[`The conversation does not carry who it was assigned to: read the thread’s `,_jsx(_components.code,{children:`assignee`}),` with `,_jsx(_components.a,{href:`/api-reference/endpoint/get-thread`,children:`Get Thread`}),`, or the `,_jsx(_components.code,{children:`sender_id`}),` of each message.`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error Codes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`400 Bad Request`}),` — A parameter is missing or invalid, or `,_jsx(_components.code,{children:`end_date`}),` is before `,_jsx(_components.code,{children:`start_date`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401 Unauthorized`}),` — Invalid or missing API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`403 Forbidden`}),` — The personal key lacks `,_jsx(_components.code,{children:`messages.read`}),`, or the channel is not among its role’s channels`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`429 Too Many Requests`}),` — Rate limit exceeded, see `,_jsx(_components.a,{href:`/api-reference/rate-limits`,children:`Rate limits`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500 Internal Server Error`}),` — Server-side error`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`code-examples`,children:`Code Examples`})]})}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","api":"GET /v1/conversations","description":"List the WhatsApp conversations of a channel that started in a date range","href":"/api-reference/endpoint/list-conversations"}}},"mdxSourceWithNoJs":{"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`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,RequestExample,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns the conversations of a WhatsApp channel that started between two dates, newest first, one page at a time. They are the same conversations as `,_jsx(_components.strong,{children:`Reports → Sessions`}),` in the app.`]}),`\n`,_jsxs(_components.p,{children:[`A thread is the whole chat with a contact on a channel and never ends. A conversation is one stretch of that thread: it opens with new activity and closes after a period without messages, so one thread has many conversations. To read the messages of a conversation, call `,_jsx(_components.a,{href:`/api-reference/endpoint/get-thread-messages`,children:`List Thread Messages`}),` with its `,_jsx(_components.code,{children:`thread_id`}),` and `,_jsx(_components.code,{children:`session_id`}),` set to its `,_jsx(_components.code,{children:`id`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Only WhatsApp (`,_jsx(_components.code,{children:`WABA`}),`) channels have conversations. For any other channel the list is empty.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`x-api-key`,type:`string`,required:true,id:`param-x-api-key`,children:_jsxs(_components.p,{children:[`Your API key for authentication. An organization key lists every conversation of the channel. A personal key needs the `,_jsx(_components.code,{children:`messages.read`}),` permission and the channel inside its role’s channels; it lists only the conversations of threads its user can see in the inbox.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`channel_id`,type:`string`,required:true,id:`param-channel-id`,children:_jsxs(_components.p,{children:[`ID of the WhatsApp channel, from `,_jsx(_components.a,{href:`/api-reference/endpoint/get-channels`,children:`List Channels`}),`.`]})}),`\n`,_jsx(ParamField,{query:`start_date`,type:`string`,required:true,id:`param-start-date`,children:_jsxs(_components.p,{children:[`First day of the range, `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. A conversation is in the range when it started in it.`]})}),`\n`,_jsx(ParamField,{query:`end_date`,type:`string`,required:true,id:`param-end-date`,children:_jsxs(_components.p,{children:[`Last day of the range, included, `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`. It cannot be before `,_jsx(_components.code,{children:`start_date`}),`.`]})}),`\n`,_jsx(ParamField,{query:`timezone`,type:`string`,default:`UTC`,id:`param-timezone`,children:_jsxs(_components.p,{children:[`IANA time zone the two days are read in, e.g. `,_jsx(_components.code,{children:`America/Bogota`}),`. An unknown zone is read as UTC.`]})}),`\n`,_jsx(ParamField,{query:`limit`,type:`number`,default:`50`,id:`param-limit`,children:_jsx(_components.p,{children:`Conversations per page, from 1 to 100.`})}),`\n`,_jsx(ParamField,{query:`offset`,type:`number`,default:`0`,id:`param-offset`,children:_jsx(_components.p,{children:`Number of conversations to skip, up to 10000.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`data`,type:`array`,id:`param-data`,children:[_jsx(_components.p,{children:`Conversations of the page, newest first.`}),_jsxs(Expandable,{title:`Conversation object`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsxs(_components.p,{children:[`Unique identifier of the conversation (UUID). Pass it as `,_jsx(_components.code,{children:`session_id`}),` to `,_jsx(_components.a,{href:`/api-reference/endpoint/get-thread-messages`,children:`List Thread Messages`}),`.`]})}),_jsx(ResponseField,{name:`thread_id`,type:`string`,id:`param-thread-id`,children:_jsx(_components.p,{children:`UUID of the thread the conversation belongs to.`})}),_jsx(ResponseField,{name:`channel_id`,type:`string`,id:`param-channel-id-1`,children:_jsx(_components.p,{children:`ID of the channel.`})}),_jsx(ResponseField,{name:`channel_name`,type:`string`,id:`param-channel-name`,children:_jsx(_components.p,{children:`Display name of the channel.`})}),_jsx(ResponseField,{name:`contact_id`,type:`string`,id:`param-contact-id`,children:_jsx(_components.p,{children:`UUID of the contact.`})}),_jsx(ResponseField,{name:`contact_name`,type:`string`,id:`param-contact-name`,children:_jsx(_components.p,{children:`Full name of the contact.`})}),_jsx(ResponseField,{name:`contact_phone`,type:`string`,id:`param-contact-phone`,children:_jsx(_components.p,{children:`Phone number of the contact.`})}),_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`open`}),` while the conversation is active, `,_jsx(_components.code,{children:`closed`}),` once it ended.`]})}),_jsx(ResponseField,{name:`started_at`,type:`string`,id:`param-started-at`,children:_jsx(_components.p,{children:`When the conversation started (ISO 8601).`})}),_jsx(ResponseField,{name:`ended_at`,type:`string`,id:`param-ended-at`,children:_jsxs(_components.p,{children:[`When it closed (ISO 8601). `,_jsx(_components.code,{children:`null`}),` while it is open.`]})}),_jsx(ResponseField,{name:`message_count`,type:`number`,id:`param-message-count`,children:_jsx(_components.p,{children:`Messages in the conversation.`})}),_jsx(ResponseField,{name:`user_message_count`,type:`number`,id:`param-user-message-count`,children:_jsx(_components.p,{children:`Messages the contact sent.`})}),_jsx(ResponseField,{name:`first_response_at`,type:`string`,id:`param-first-response-at`,children:_jsxs(_components.p,{children:[`When the first reply to the contact was sent, by the AI agent or a person (ISO 8601), or `,_jsx(_components.code,{children:`null`}),`.`]})}),_jsx(ResponseField,{name:`is_returning`,type:`boolean`,id:`param-is-returning`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`true`}),` when the contact had an earlier conversation on this channel.`]})}),_jsx(ResponseField,{name:`handled_by`,type:`string`,id:`param-handled-by`,children:_jsxs(_components.p,{children:[`Who answered: `,_jsx(_components.code,{children:`ai`}),`, `,_jsx(_components.code,{children:`human`}),`, `,_jsx(_components.code,{children:`mixed`}),` or `,_jsx(_components.code,{children:`none`}),`. `,_jsx(_components.code,{children:`null`}),` while the conversation is open, and for conversations that closed before September 7, 2026.`]})}),_jsx(ResponseField,{name:`escalated_at`,type:`string`,id:`param-escalated-at`,children:_jsxs(_components.p,{children:[`When the conversation was handed from the AI agent to a person (ISO 8601), or `,_jsx(_components.code,{children:`null`}),`.`]})}),_jsx(ResponseField,{name:`escalated_by_type`,type:`string`,id:`param-escalated-by-type`,children:_jsxs(_components.p,{children:[`Who made the handoff: `,_jsx(_components.code,{children:`agent`}),` (the AI agent escalated), `,_jsx(_components.code,{children:`user`}),` (a person on your team took the conversation over) or `,_jsx(_components.code,{children:`system`}),` (a rule or automation). `,_jsx(_components.code,{children:`null`}),` when there was none.`]})}),_jsx(ResponseField,{name:`analyzed_at`,type:`string`,id:`param-analyzed-at`,children:_jsxs(_components.p,{children:[`When the conversation was analyzed (ISO 8601), or `,_jsx(_components.code,{children:`null`}),`.`]})}),_jsxs(ResponseField,{name:`analysis`,type:`object`,id:`param-analysis`,children:[_jsxs(_components.p,{children:[`The analysis written when the conversation closes, only on channels with conversation analysis turned on; `,_jsx(_components.code,{children:`null`}),` otherwise.`]}),_jsxs(Expandable,{title:`Analysis object`,children:[_jsx(ResponseField,{name:`session_summary`,type:`string`,id:`param-session-summary`,children:_jsx(_components.p,{children:`Summary of the conversation.`})}),_jsx(ResponseField,{name:`user_sentiment`,type:`string`,id:`param-user-sentiment`,children:_jsxs(_components.p,{children:[`Sentiment of the contact: `,_jsx(_components.code,{children:`Positive`}),`, `,_jsx(_components.code,{children:`Neutral`}),` or `,_jsx(_components.code,{children:`Negative`}),`.`]})}),_jsx(ResponseField,{name:`session_successful`,type:`boolean`,id:`param-session-successful`,children:_jsx(_components.p,{children:`Whether the conversation reached its goal.`})}),_jsx(ResponseField,{name:`custom_analysis_data`,type:`object`,id:`param-custom-analysis-data`,children:_jsx(_components.p,{children:`The custom fields set up for the channel’s analysis.`})})]})]})]})]}),`\n`,_jsx(ResponseField,{name:`pagination`,type:`object`,id:`param-pagination`,children:_jsxs(Expandable,{title:`Pagination object`,children:[_jsx(ResponseField,{name:`page`,type:`number`,id:`param-page`,children:_jsx(_components.p,{children:`Page number, from 1.`})}),_jsx(ResponseField,{name:`total_rows`,type:`number`,id:`param-total-rows`,children:_jsx(_components.p,{children:`Conversations in the range.`})}),_jsx(ResponseField,{name:`total_pages`,type:`number`,id:`param-total-pages`,children:_jsxs(_components.p,{children:[`Pages at the requested `,_jsx(_components.code,{children:`limit`}),`.`]})})]})}),`\n`,_jsxs(_components.p,{children:[`The conversation does not carry who it was assigned to: read the thread’s `,_jsx(_components.code,{children:`assignee`}),` with `,_jsx(_components.a,{href:`/api-reference/endpoint/get-thread`,children:`Get Thread`}),`, or the `,_jsx(_components.code,{children:`sender_id`}),` of each message.`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error Codes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`400 Bad Request`}),` — A parameter is missing or invalid, or `,_jsx(_components.code,{children:`end_date`}),` is before `,_jsx(_components.code,{children:`start_date`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`401 Unauthorized`}),` — Invalid or missing API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`403 Forbidden`}),` — The personal key lacks `,_jsx(_components.code,{children:`messages.read`}),`, or the channel is not among its role’s channels`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`429 Too Many Requests`}),` — Rate limit exceeded, see `,_jsx(_components.a,{href:`/api-reference/rate-limits`,children:`Rate limits`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500 Internal Server Error`}),` — Server-side error`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`code-examples`,children:`Code Examples`}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.contactship.ai/v1/conversations?channel_id=chn_w4b4e5x4mp1e0000000000\u0026start_date=2026-11-01\u0026end_date=2026-11-15\u0026timezone=America/Bogota\u0026limit=100\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: your-api-key\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`18`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`18`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` URLSearchParams`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` channel_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'chn_w4b4e5x4mp1e0000000000'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` start_date:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '2026-11-01'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` end_date:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '2026-11-15'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` timezone:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'America/Bogota'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` limit:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '100'`}),_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:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` conversations`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [];`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`for`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`let`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` offset`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`; ; `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`offset`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` +=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 100`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` params`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`set`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'offset'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`String`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`offset`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`));`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`https://api.contactship.ai/v1/conversations?\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`params`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'x-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'your-api-key'`}),_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:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`pagination`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` conversations`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`push`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`...`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--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:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`offset`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` +`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 100`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` >=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` pagination`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`total_rows`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`break`}),_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:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`conversations`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:`length`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" conversations`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`22`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`22`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`params `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'channel_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'chn_w4b4e5x4mp1e0000000000'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'start_date'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'2026-11-01'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'end_date'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'2026-11-15'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'timezone'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'America/Bogota'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'limit'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'offset'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`conversations `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` []`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`while`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` True`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` page `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.contactship.ai/v1/conversations'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'x-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'your-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`params,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ).json()`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` conversations `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`+=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` page[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'data'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` params[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'offset'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`+=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 100`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` params[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'offset'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` page[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'pagination'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'total_rows'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]:`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` break`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`len`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(conversations), `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'conversations'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})})]}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`Example Response`,numberOfLines:`36`,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:`36`,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:` \"statusCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_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`,_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:`\"5f0c1d2e-3a4b-4c5d-8e6f-7a8b9c0d1e2f\"`}),_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:` \"thread_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"thr-b2c3d4e5-f6a7-8901-bcde-f12345678901\"`}),_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_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"chn_w4b4e5x4mp1e0000000000\"`}),_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_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"WhatsApp Business\"`}),_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:` \"contact_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"c1d2e3f4-a5b6-7890-cdef-123456789012\"`}),_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:` \"contact_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Ana Gómez\"`}),_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:` \"contact_phone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+573001234567\"`}),_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:` \"started_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-14T15:03:26Z\"`}),_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:` \"ended_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-14T16:10:02Z\"`}),_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:` \"message_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12`}),_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:` \"user_message_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`}),_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:` \"first_response_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-14T15:03:41Z\"`}),_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:` \"is_returning\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"handled_by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mixed\"`}),_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:` \"escalated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-14T15:20:00Z\"`}),_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:` \"escalated_by_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user\"`}),_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:` \"analyzed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-14T16:11:30Z\"`}),_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:` \"analysis\"`}),_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:` \"session_summary\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The contact asked to reschedule a delivery and was handed to an agent, who confirmed the new date.\"`}),_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:` \"user_sentiment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Positive\"`}),_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:` \"session_successful\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"custom_analysis_data\"`}),_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`,_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:` \"pagination\"`}),_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:` \"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:` \"total_rows\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`53`}),_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_pages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`})]}),`\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`]})})})})]})}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","api":"GET /v1/conversations","description":"List the WhatsApp conversations of a channel that started in a date range","href":"/api-reference/endpoint/list-conversations"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Error Codes","slug":"error-codes","depth":2,"children":[]},{"title":"Code Examples","slug":"code-examples","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","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=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> GET\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.contactship.ai/v1/conversations?channel_id=chn_w4b4e5x4mp1e0000000000\u0026#x26;start_date=2026-11-01\u0026#x26;end_date=2026-11-15\u0026#x26;timezone=America/Bogota\u0026#x26;limit=100\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"x-api-key: your-api-key\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript","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=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"18\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> params\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> new\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> URLSearchParams\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> channel_id:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'chn_w4b4e5x4mp1e0000000000'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> start_date:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '2026-11-01'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> end_date:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '2026-11-15'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> timezone:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'America/Bogota'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> limit:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '100'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> conversations\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> [];\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">for\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">let\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> offset\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\"> 0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">; ; \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">offset\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> +=\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\"> 100\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> params\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">set\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'offset'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">String\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">offset\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">));\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`https://api.contactship.ai/v1/conversations?\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">params\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'x-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'your-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> });\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\">data\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\">pagination\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> } \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> conversations\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">push\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">...\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">data\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> if\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">offset\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> +\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\"> 100\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> >=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> pagination\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">total_rows\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">break\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">;\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">conversations\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#9CDCFE\">length\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> conversations`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","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=\"python\">\u003ccode language=\"python\" numberOfLines=\"22\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">params \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'channel_id'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'chn_w4b4e5x4mp1e0000000000'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'start_date'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'2026-11-01'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'end_date'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'2026-11-15'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'timezone'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'America/Bogota'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'limit'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">100\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'offset'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">conversations \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> []\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">while\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> True\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> page \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.get(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.contactship.ai/v1/conversations'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'x-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'your-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> params\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">params,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ).json()\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> conversations \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">+=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> page[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'data'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> params[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'offset'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">] \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">+=\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\"> 100\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> if\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> params[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'offset'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">] \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">>=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> page[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'pagination'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">][\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'total_rows'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> break\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">len\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(conversations), \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'conversations'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"Example Response","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=\"json\">\u003ccode language=\"json\" numberOfLines=\"36\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"statusCode\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">200\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"5f0c1d2e-3a4b-4c5d-8e6f-7a8b9c0d1e2f\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"thread_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"thr-b2c3d4e5-f6a7-8901-bcde-f12345678901\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"channel_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"chn_w4b4e5x4mp1e0000000000\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"channel_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"WhatsApp Business\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"contact_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"c1d2e3f4-a5b6-7890-cdef-123456789012\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"contact_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Ana Gómez\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"contact_phone\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"+573001234567\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"closed\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"started_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-14T15:03:26Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"ended_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-14T16:10:02Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message_count\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">12\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"user_message_count\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">5\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"first_response_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-14T15:03:41Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"is_returning\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"handled_by\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"mixed\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"escalated_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-14T15:20:00Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"escalated_by_type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"user\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"analyzed_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-14T16:11:30Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"analysis\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"session_summary\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"The contact asked to reschedule a delivery and was handed to an agent, who confirmed the new date.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"user_sentiment\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Positive\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"session_successful\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"custom_analysis_data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {}\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"pagination\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"page\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"total_rows\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">53\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"total_pages\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">2\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"List Conversations","path":"/v1/conversations","method":"get","request":{"security":[],"parameters":{"query":{"channel_id":{"schema":[{"type":"string","description":"ID of the WhatsApp channel, from List Channels .","required":true}]},"start_date":{"schema":[{"type":"string","description":"First day of the range, `YYYY-MM-DD` . A conversation is in the range when it started in it.","required":true}]},"end_date":{"schema":[{"type":"string","description":"Last day of the range, included, `YYYY-MM-DD` . It cannot be before `start_date` .","required":true}]},"timezone":{"schema":[{"type":"string","description":"IANA time zone the two days are read in, e.g. `America/Bogota` . An unknown zone is read as UTC."}]},"limit":{"schema":[{"type":"number","description":"Conversations per page, from 1 to 100."}]},"offset":{"schema":[{"type":"number","description":"Number of conversations to skip, up to 10000."}]}},"header":{"x-api-key":{"schema":[{"type":"string","description":"Your API key for authentication. An organization key lists every conversation of the channel. A personal key needs the `messages.read` permission and the channel inside its role’s channels; it lists only the conversations of threads its user can see in the inbox.","required":true}]}},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data":[{"type":"array","items":[{"type":"object","properties":{"id":[{"type":"string","description":"Unique identifier of the conversation (UUID). Pass it as `session_id` to List Thread Messages ."}],"thread_id":[{"type":"string","description":"UUID of the thread the conversation belongs to."}],"channel_id":[{"type":"string","description":"ID of the channel."}],"channel_name":[{"type":"string","description":"Display name of the channel."}],"contact_id":[{"type":"string","description":"UUID of the contact."}],"contact_name":[{"type":"string","description":"Full name of the contact."}],"contact_phone":[{"type":"string","description":"Phone number of the contact."}],"status":[{"type":"string","description":"`open` while the conversation is active, `closed` once it ended."}],"started_at":[{"type":"string","description":"When the conversation started (ISO 8601)."}],"ended_at":[{"type":"string","description":"When it closed (ISO 8601). `null` while it is open."}],"message_count":[{"type":"number","description":"Messages in the conversation."}],"user_message_count":[{"type":"number","description":"Messages the contact sent."}],"first_response_at":[{"type":"string","description":"When the first reply to the contact was sent, by the AI agent or a person (ISO 8601), or `null` ."}],"is_returning":[{"type":"boolean","description":"`true` when the contact had an earlier conversation on this channel."}],"handled_by":[{"type":"string","description":"Who answered: `ai` , `human` , `mixed` or `none` . `null` while the conversation is open, and for conversations that closed before September 7, 2026."}],"escalated_at":[{"type":"string","description":"When the conversation was handed from the AI agent to a person (ISO 8601), or `null` ."}],"escalated_by_type":[{"type":"string","description":"Who made the handoff: `agent` (the AI agent escalated), `user` (a person on your team took the conversation over) or `system` (a rule or automation). `null` when there was none."}],"analyzed_at":[{"type":"string","description":"When the conversation was analyzed (ISO 8601), or `null` ."}],"analysis":[{"type":"object","properties":{"session_summary":[{"type":"string","description":"Summary of the conversation."}],"user_sentiment":[{"type":"string","description":"Sentiment of the contact: `Positive` , `Neutral` or `Negative` ."}],"session_successful":[{"type":"boolean","description":"Whether the conversation reached its goal."}],"custom_analysis_data":[{"type":"object","properties":{},"description":"The custom fields set up for the channel’s analysis."}]},"description":"The analysis written when the conversation closes, only on channels with conversation analysis turned on; `null` otherwise."}]}}],"description":"Conversations of the page, newest first."}],"pagination":[{"type":"object","properties":{"page":[{"type":"number","description":"Page number, from 1."}],"total_rows":[{"type":"number","description":"Conversations in the range."}],"total_pages":[{"type":"number","description":"Pages at the requested `limit` ."}]}}]}}],"examples":{"example":{"value":{"data":[{"id":"\u003cstring>","thread_id":"\u003cstring>","channel_id":"\u003cstring>","channel_name":"\u003cstring>","contact_id":"\u003cstring>","contact_name":"\u003cstring>","contact_phone":"\u003cstring>","status":"\u003cstring>","started_at":"\u003cstring>","ended_at":"\u003cstring>","message_count":123,"user_message_count":123,"first_response_at":"\u003cstring>","is_returning":true,"handled_by":"\u003cstring>","escalated_at":"\u003cstring>","escalated_by_type":"\u003cstring>","analyzed_at":"\u003cstring>","analysis":{"session_summary":"\u003cstring>","user_sentiment":"\u003cstring>","session_successful":true,"custom_analysis_data":{}}}],"pagination":{"page":123,"total_rows":123,"total_pages":123}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"contactship","siteName":"ContactShip Docs","title":"List Conversations - ContactShip Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/api-reference/endpoint/list-conversations","matchLevel":0},"en":{"href":"/api-reference/endpoint/list-conversations","matchLevel":0}}},"lastModified":"2026-11-18T17:18:29.178Z","originalFileLocation":"api-reference/endpoint/list-conversations.mdx","locale":"es"},"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=\"List the WhatsApp conversations of a channel that started in a date range\">\u003cmeta data-mint-head name=\"application-name\" content=\"ContactShip 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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_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/contactship/t9ds7rwKwjlbXW3P/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Conversations - ContactShip Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the WhatsApp conversations of a channel that started in a date range\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ContactShip Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.contactship.ai/api-reference/endpoint/list-conversations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://contactship.mintlify.site/_mintlify/api/og/v2?division=Canales+y+conversaciones\u0026amp;title=List+Conversations\u0026amp;description=List+the+WhatsApp+conversations+of+a+channel+that+started+in+a+date+range\u0026amp;theme=a06d13b3f4cf8a7c17fe2657\u0026amp;signature=0735205a8410f33667824f7f294011b293738b427979fc1a4253ea30a467b262\">\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 - ContactShip Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the WhatsApp conversations of a channel that started in a date range\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://contactship.mintlify.site/_mintlify/api/og/v2?division=Canales+y+conversaciones\u0026amp;title=List+Conversations\u0026amp;description=List+the+WhatsApp+conversations+of+a+channel+that+started+in+a+date+range\u0026amp;theme=a06d13b3f4cf8a7c17fe2657\u0026amp;signature=0735205a8410f33667824f7f294011b293738b427979fc1a4253ea30a467b262\">\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/contactship/t9ds7rwKwjlbXW3P/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ContactShip Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0252ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.contactship.ai/api-reference/endpoint/list-conversations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/list-conversations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.contactship.ai/#organization\",\"name\":\"ContactShip Docs\",\"url\":\"https://docs.contactship.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/contactship/XJKLcqzvszyHAh2b/logo/Isologotipo.png?fit=max\u0026auto=format\u0026n=XJKLcqzvszyHAh2b\u0026q=85\u0026s=1100afd12fc8debe15faade6766a53c7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.contactship.ai#website\",\"name\":\"ContactShip Docs\",\"url\":\"https://docs.contactship.ai\",\"publisher\":{\"@id\":\"https://docs.contactship.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/list-conversations#webpage\",\"url\":\"https://docs.contactship.ai/api-reference/endpoint/list-conversations\",\"name\":\"List Conversations\",\"description\":\"List the WhatsApp conversations of a channel that started in a date range\",\"dateModified\":\"2026-11-18T17:18:29.178Z\",\"isPartOf\":{\"@id\":\"https://docs.contactship.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/list-conversations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/list-conversations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Canales y conversaciones\",\"item\":\"https://docs.contactship.ai/api-reference/endpoint/get-channels\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Conversations\",\"item\":\"https://docs.contactship.ai/api-reference/endpoint/list-conversations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/list-conversations#apireference\",\"headline\":\"List Conversations\",\"name\":\"List Conversations\",\"description\":\"List the WhatsApp conversations of a channel that started in a date range\",\"url\":\"https://docs.contactship.ai/api-reference/endpoint/list-conversations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.contactship.ai/api-reference/endpoint/list-conversations#webpage\"},\"dateModified\":\"2026-11-18T17:18:29.178Z\",\"publisher\":{\"@id\":\"https://docs.contactship.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.contactship.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ContactShip Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ContactShip Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/list-conversations.md","siteName":"ContactShip Docs","nav":{"global":null,"languages":[{"language":"es","default":true,"tabs":[{"tab":"Documentación","pages":[{"title":"Documentación","href":"/es/comenzar/que-es-contactship"}]},{"tab":"Casos de uso","pages":[{"title":"Casos de uso","href":"/es/casos-de-uso"}]},{"tab":"API Reference","groups":[{"group":"Documentación API","pages":[{"title":"API Introduction","href":"/api-reference/introduction"},{"title":"Rate Limits and Retries","href":"/api-reference/rate-limits"},{"title":"Call webhook payload","href":"/api-reference/webhooks"},{"title":"Inbound context webhook","href":"/api-reference/inbound-webhook"},{"title":"Follow-up closure webhook","href":"/api-reference/follow-up-webhook"},{"title":"HTTP tool execution","href":"/api-reference/tool-execution"}]},{"group":"Voz","pages":[{"title":"Make AI Phone Call","api":"POST /v1/calls/single-phone-call","href":"/api-reference/endpoint/make-ai-phone-call"},{"title":"Call a Contact","api":"POST /v1/calls/single-contact-call","href":"/api-reference/endpoint/make-contact-call"}]},{"group":"WhatsApp (WABA)","pages":[{"title":"Send WhatsApp Message","api":"POST /v1/waba/send","href":"/api-reference/endpoint/waba-send-message"},{"title":"Send WhatsApp Template","api":"POST /v1/waba/send-template","href":"/api-reference/endpoint/waba-send-template"},{"title":"Send WhatsApp Media","api":"POST /v1/waba/send-media","href":"/api-reference/endpoint/waba-send-media"},{"title":"Send WhatsApp Location","api":"POST /v1/waba/send-location","href":"/api-reference/endpoint/waba-send-location"},{"title":"Get WhatsApp Templates","api":"GET /v1/waba/templates","href":"/api-reference/endpoint/waba-get-templates"}]},{"group":"Canales y conversaciones","pages":[{"title":"List Channels","api":"GET /v1/channels","description":"Retrieve all messaging channels for your organization","href":"/api-reference/endpoint/get-channels"},{"title":"List Conversations","api":"GET /v1/conversations","href":"/api-reference/endpoint/list-conversations"},{"title":"Get Thread","api":"GET /v1/thread/{threadId}","description":"Retrieve a conversation thread by its ID","href":"/api-reference/endpoint/get-thread"},{"title":"List Thread Messages","api":"GET /v1/thread/{threadId}/messages","href":"/api-reference/endpoint/get-thread-messages"},{"title":"Update Thread","api":"PUT /v1/thread/{threadId}","href":"/api-reference/endpoint/update-thread"},{"title":"Get Message","api":"GET /v1/messages/{messageId}","href":"/api-reference/endpoint/get-message"}]},{"group":"Organización","pages":[{"title":"Get Credits","api":"GET /v1/credits","href":"/api-reference/endpoint/get-credits"}]},{"group":"Agentes","pages":[{"title":"Create Agent","api":"POST /v1/agents","href":"/api-reference/endpoint/create-agent"},{"title":"Get Agent","api":"GET /v1/agents/{agentId}","href":"/api-reference/endpoint/get-agent"},{"title":"List Agents","api":"GET /v1/agents","href":"/api-reference/endpoint/list-agents"},{"title":"Update Agent","api":"PUT /v1/agents/{agentId}","href":"/api-reference/endpoint/update-agent"},{"title":"Delete Agent","api":"DELETE /v1/agents/{agentId}","href":"/api-reference/endpoint/delete-agent"},{"title":"List Voices","api":"GET /v1/agents/voices","href":"/api-reference/endpoint/list-voices"}]},{"group":"Contactos","pages":[{"title":"Get Contacts","api":"GET /v1/contacts","href":"/api-reference/endpoint/get-contacts"},{"title":"Create Contact","api":"POST /v1/contacts","href":"/api-reference/endpoint/create-contact"},{"title":"Get Contact by Identifier","api":"GET /v1/contacts/{identifier}","href":"/api-reference/endpoint/get-contact-by-identifier"},{"title":"Get Contact Call History","api":"GET /v1/contacts/{contactId}/call-history","href":"/api-reference/endpoint/get-contact-call-history"},{"title":"Find Call History by Phone Number","href":"/api-reference/endpoint/get-contact-call-history-by-phone"},{"title":"Update Contact","api":"PATCH /v1/contacts/{contactId}","href":"/api-reference/endpoint/update-contact"},{"title":"Delete Contact","api":"DELETE /v1/contacts/{contactId}","href":"/api-reference/endpoint/delete-contact"},{"title":"Get Contact Comments","api":"GET /v1/contacts/{contactId}/comments","href":"/api-reference/endpoint/get-contact-comments"},{"title":"Create Contact Comment","api":"POST /v1/comments","href":"/api-reference/endpoint/create-comment"},{"title":"Get Contact Tags","api":"GET /v1/contacts/{contactId}/tags","href":"/api-reference/endpoint/get-contact-tags"},{"title":"Add Tag to Contact","api":"POST /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/add-contact-tag"},{"title":"Remove Tag from Contact","api":"DELETE /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/remove-contact-tag"}]},{"group":"Eventos","pages":[{"title":"Send Events","api":"POST /v1/events","href":"/api-reference/endpoint/send-events"},{"title":"Identify a Session","api":"POST /v1/identify","href":"/api-reference/endpoint/identify"}]},{"group":"Etiquetas","pages":[{"title":"List Tags","api":"GET /v1/tags","href":"/api-reference/endpoint/list-tags"},{"title":"Create Tag","api":"POST /v1/tags","href":"/api-reference/endpoint/create-tag"},{"title":"Update Tag","api":"PATCH /v1/tags/{tagId}","href":"/api-reference/endpoint/update-tag"},{"title":"Delete Tag","api":"DELETE /v1/tags/{tagId}","href":"/api-reference/endpoint/delete-tag"}]},{"group":"Llamadas","pages":[{"title":"List Calls","api":"GET /v1/calls","href":"/api-reference/endpoint/list-calls"},{"title":"Get Call","api":"GET /v1/calls/{callId}","href":"/api-reference/endpoint/get-call"},{"title":"Get Call Status","api":"GET /v1/calls/{callId}/status","href":"/api-reference/endpoint/get-call-status"},{"title":"Stop Call","api":"POST /v1/calls/single-phone-call/{callId}/stop","href":"/api-reference/endpoint/stop-call"}]},{"group":"Tareas","pages":[{"title":"List Tasks","api":"GET /v1/tasks","href":"/api-reference/endpoint/list-tasks"},{"title":"Get Task","api":"GET /v1/tasks/{id}","href":"/api-reference/endpoint/get-task"},{"title":"Create Task","api":"POST /v1/tasks","href":"/api-reference/endpoint/create-task"}]},{"group":"Números de teléfono","pages":[{"title":"List Phone Numbers","api":"GET /v1/phone-numbers","href":"/api-reference/endpoint/get-phone-numbers"}]}]}]},{"language":"en","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/en/get-started/what-is-contactship"}]},{"tab":"Use cases","pages":[{"title":"Use cases","href":"/en/use-cases"}]},{"tab":"API Reference","groups":[{"group":"API documentation","pages":[{"title":"API Introduction","href":"/api-reference/introduction"},{"title":"Rate Limits and Retries","href":"/api-reference/rate-limits"},{"title":"Call webhook payload","href":"/api-reference/webhooks"},{"title":"Inbound context webhook","href":"/api-reference/inbound-webhook"},{"title":"Follow-up closure webhook","href":"/api-reference/follow-up-webhook"},{"title":"HTTP tool execution","href":"/api-reference/tool-execution"}]},{"group":"Voice","pages":[{"title":"Make AI Phone Call","api":"POST /v1/calls/single-phone-call","href":"/api-reference/endpoint/make-ai-phone-call"},{"title":"Call a Contact","api":"POST /v1/calls/single-contact-call","href":"/api-reference/endpoint/make-contact-call"}]},{"group":"WhatsApp (WABA)","pages":[{"title":"Send WhatsApp Message","api":"POST /v1/waba/send","href":"/api-reference/endpoint/waba-send-message"},{"title":"Send WhatsApp Template","api":"POST /v1/waba/send-template","href":"/api-reference/endpoint/waba-send-template"},{"title":"Send WhatsApp Media","api":"POST /v1/waba/send-media","href":"/api-reference/endpoint/waba-send-media"},{"title":"Send WhatsApp Location","api":"POST /v1/waba/send-location","href":"/api-reference/endpoint/waba-send-location"},{"title":"Get WhatsApp Templates","api":"GET /v1/waba/templates","href":"/api-reference/endpoint/waba-get-templates"}]},{"group":"Channels and threads","pages":[{"title":"List Channels","api":"GET /v1/channels","description":"Retrieve all messaging channels for your organization","href":"/api-reference/endpoint/get-channels"},{"title":"List Conversations","api":"GET /v1/conversations","href":"/api-reference/endpoint/list-conversations"},{"title":"Get Thread","api":"GET /v1/thread/{threadId}","description":"Retrieve a conversation thread by its ID","href":"/api-reference/endpoint/get-thread"},{"title":"List Thread Messages","api":"GET /v1/thread/{threadId}/messages","href":"/api-reference/endpoint/get-thread-messages"},{"title":"Update Thread","api":"PUT /v1/thread/{threadId}","href":"/api-reference/endpoint/update-thread"},{"title":"Get Message","api":"GET /v1/messages/{messageId}","href":"/api-reference/endpoint/get-message"}]},{"group":"Organization","pages":[{"title":"Get Credits","api":"GET /v1/credits","href":"/api-reference/endpoint/get-credits"}]},{"group":"Agents","pages":[{"title":"Create Agent","api":"POST /v1/agents","href":"/api-reference/endpoint/create-agent"},{"title":"Get Agent","api":"GET /v1/agents/{agentId}","href":"/api-reference/endpoint/get-agent"},{"title":"List Agents","api":"GET /v1/agents","href":"/api-reference/endpoint/list-agents"},{"title":"Update Agent","api":"PUT /v1/agents/{agentId}","href":"/api-reference/endpoint/update-agent"},{"title":"Delete Agent","api":"DELETE /v1/agents/{agentId}","href":"/api-reference/endpoint/delete-agent"},{"title":"List Voices","api":"GET /v1/agents/voices","href":"/api-reference/endpoint/list-voices"}]},{"group":"Contacts","pages":[{"title":"Get Contacts","api":"GET /v1/contacts","href":"/api-reference/endpoint/get-contacts"},{"title":"Create Contact","api":"POST /v1/contacts","href":"/api-reference/endpoint/create-contact"},{"title":"Get Contact by Identifier","api":"GET /v1/contacts/{identifier}","href":"/api-reference/endpoint/get-contact-by-identifier"},{"title":"Get Contact Call History","api":"GET /v1/contacts/{contactId}/call-history","href":"/api-reference/endpoint/get-contact-call-history"},{"title":"Find Call History by Phone Number","href":"/api-reference/endpoint/get-contact-call-history-by-phone"},{"title":"Update Contact","api":"PATCH /v1/contacts/{contactId}","href":"/api-reference/endpoint/update-contact"},{"title":"Delete Contact","api":"DELETE /v1/contacts/{contactId}","href":"/api-reference/endpoint/delete-contact"},{"title":"Get Contact Comments","api":"GET /v1/contacts/{contactId}/comments","href":"/api-reference/endpoint/get-contact-comments"},{"title":"Create Contact Comment","api":"POST /v1/comments","href":"/api-reference/endpoint/create-comment"},{"title":"Get Contact Tags","api":"GET /v1/contacts/{contactId}/tags","href":"/api-reference/endpoint/get-contact-tags"},{"title":"Add Tag to Contact","api":"POST /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/add-contact-tag"},{"title":"Remove Tag from Contact","api":"DELETE /v1/contacts/{contactId}/tags/{tagId}","href":"/api-reference/endpoint/remove-contact-tag"}]},{"group":"Events","pages":[{"title":"Send Events","api":"POST /v1/events","href":"/api-reference/endpoint/send-events"},{"title":"Identify a Session","api":"POST /v1/identify","href":"/api-reference/endpoint/identify"}]},{"group":"Tags","pages":[{"title":"List Tags","api":"GET /v1/tags","href":"/api-reference/endpoint/list-tags"},{"title":"Create Tag","api":"POST /v1/tags","href":"/api-reference/endpoint/create-tag"},{"title":"Update Tag","api":"PATCH /v1/tags/{tagId}","href":"/api-reference/endpoint/update-tag"},{"title":"Delete Tag","api":"DELETE /v1/tags/{tagId}","href":"/api-reference/endpoint/delete-tag"}]},{"group":"Calls","pages":[{"title":"List Calls","api":"GET /v1/calls","href":"/api-reference/endpoint/list-calls"},{"title":"Get Call","api":"GET /v1/calls/{callId}","href":"/api-reference/endpoint/get-call"},{"title":"Get Call Status","api":"GET /v1/calls/{callId}/status","href":"/api-reference/endpoint/get-call-status"},{"title":"Stop Call","api":"POST /v1/calls/single-phone-call/{callId}/stop","href":"/api-reference/endpoint/stop-call"}]},{"group":"Tasks","pages":[{"title":"List Tasks","api":"GET /v1/tasks","href":"/api-reference/endpoint/list-tasks"},{"title":"Get Task","api":"GET /v1/tasks/{id}","href":"/api-reference/endpoint/get-task"},{"title":"Create Task","api":"POST /v1/tasks","href":"/api-reference/endpoint/create-task"}]},{"group":"Phone numbers","pages":[{"title":"List Phone Numbers","api":"GET /v1/phone-numbers","href":"/api-reference/endpoint/get-phone-numbers"}]}]}]}]},"basePath":"","title":"List Conversations - ContactShip Docs","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"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"]}