> This page is optimized for agents. Use the linked Markdown pages and llms.txt indexes for related API content. # List conversations - Product: Reachiz API - Section: Conversations - Snapshot: v1 - Method: `GET` - Path: `/v1/conversations` ## Query parameters ### `limit` Type: `number` Required: no Default: `25` ### `cursor` Type: `string` Required: no ### `account` Type: `number` Required: no ### `campaign` Type: `number` Required: no ### `unread` Type: `string` Required: no Allowed values: `true`, `false` ## Execute with curl ```bash curl "https://prestigious-goldfish-661.convex.site/v1/conversations" \ -H "Authorization: Bearer $REACHIZ_API_KEY" ``` ## Execute with TypeScript ```ts const response = await fetch("https://prestigious-goldfish-661.convex.site/v1/conversations", { method: "GET", headers: { Authorization: `Bearer ${process.env.REACHIZ_API_KEY}`, }, }); const data = await response.json(); ``` ## Responses ### Response `200` Category: success Success #### `application/json` ##### Generated example ```json { "data": [ { "id": 0, "accountId": 0, "type": "linkedin", "correspondent": { "name": "name", "publicId": "publicId", "headline": "headline", "profileUrl": "profileUrl", "imageUrl": "imageUrl" }, "leadId": 0, "campaignId": 0, "unread": true, "archived": true, "starred": true, "replied": true, "lastMessage": { "preview": "preview", "fromMe": true, "at": "at" } } ], "nextCursor": "nextCursor" } ``` ##### Schema ###### object Type: `object` ###### `data` Type: `object[]` Required: yes ###### object Type: `object` ###### `id` Type: `number` Required: yes ###### `accountId` Type: `number` Required: yes ###### `type` Type: `string` Required: yes Allowed values: `linkedin`, `inmail`, `sales_navigator`, `recruiter` ###### `correspondent` Type: `object` Required: yes ###### `name` Type: `string` Required: yes ###### `publicId` Type: `string` Required: yes ###### `headline` Type: `string` Required: yes ###### `profileUrl` Type: `string` Required: yes ###### `imageUrl` Type: `string` Required: yes ###### `leadId` Type: `number` Required: yes ###### number Type: `number` ###### unknown Type: `unknown` ###### `campaignId` Type: `number` Required: yes ###### number Type: `number` ###### unknown Type: `unknown` ###### `unread` Type: `boolean` Required: yes ###### `archived` Type: `boolean` Required: yes ###### `starred` Type: `boolean` Required: yes ###### `replied` Type: `boolean` Required: yes ###### `lastMessage` Type: `object` Required: yes ###### `preview` Type: `string` Required: yes ###### `fromMe` Type: `boolean` Required: yes ###### `at` Type: `string` Format: `date-time` Required: yes ###### `nextCursor` Type: `string` Required: yes ### Response `400` Category: client-error The request is not valid. error.fields lists each problem. #### `application/json` ##### Generated example ```json { "error": { "code": "invalid_request", "message": "message", "requestId": "requestId", "recovery": "recovery", "fields": [ { "path": "path", "message": "message" } ] } } ``` ##### Schema ###### Error Type: `Error` ###### `error` Type: `object` Required: yes ###### `code` Type: `string` Required: yes Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable` ###### `message` Type: `string` Required: yes ###### `requestId` Type: `string` Required: yes ###### `recovery` Type: `string` Required: no What to do next. ###### `fields` Type: `object[]` Required: no ###### object Type: `object` ###### `path` Type: `string` Required: yes ###### `message` Type: `string` Required: yes ### Response `401` Category: client-error The API key is missing or not valid. #### `application/json` ##### Generated example ```json { "error": { "code": "invalid_request", "message": "message", "requestId": "requestId", "recovery": "recovery", "fields": [ { "path": "path", "message": "message" } ] } } ``` ##### Schema ###### Error Type: `Error` ###### `error` Type: `object` Required: yes ###### `code` Type: `string` Required: yes Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable` ###### `message` Type: `string` Required: yes ###### `requestId` Type: `string` Required: yes ###### `recovery` Type: `string` Required: no What to do next. ###### `fields` Type: `object[]` Required: no ###### object Type: `object` ###### `path` Type: `string` Required: yes ###### `message` Type: `string` Required: yes ### Response `403` Category: client-error The key lacks the scope this route needs. #### `application/json` ##### Generated example ```json { "error": { "code": "invalid_request", "message": "message", "requestId": "requestId", "recovery": "recovery", "fields": [ { "path": "path", "message": "message" } ] } } ``` ##### Schema ###### Error Type: `Error` ###### `error` Type: `object` Required: yes ###### `code` Type: `string` Required: yes Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable` ###### `message` Type: `string` Required: yes ###### `requestId` Type: `string` Required: yes ###### `recovery` Type: `string` Required: no What to do next. ###### `fields` Type: `object[]` Required: no ###### object Type: `object` ###### `path` Type: `string` Required: yes ###### `message` Type: `string` Required: yes ### Response `429` Category: client-error Too many requests. #### `application/json` ##### Generated example ```json { "error": { "code": "invalid_request", "message": "message", "requestId": "requestId", "recovery": "recovery", "fields": [ { "path": "path", "message": "message" } ] } } ``` ##### Schema ###### Error Type: `Error` ###### `error` Type: `object` Required: yes ###### `code` Type: `string` Required: yes Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable` ###### `message` Type: `string` Required: yes ###### `requestId` Type: `string` Required: yes ###### `recovery` Type: `string` Required: no What to do next. ###### `fields` Type: `object[]` Required: no ###### object Type: `object` ###### `path` Type: `string` Required: yes ###### `message` Type: `string` Required: yes ### Response `503` Category: server-error The service is busy. Retry with backoff. #### `application/json` ##### Generated example ```json { "error": { "code": "invalid_request", "message": "message", "requestId": "requestId", "recovery": "recovery", "fields": [ { "path": "path", "message": "message" } ] } } ``` ##### Schema ###### Error Type: `Error` ###### `error` Type: `object` Required: yes ###### `code` Type: `string` Required: yes Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable` ###### `message` Type: `string` Required: yes ###### `requestId` Type: `string` Required: yes ###### `recovery` Type: `string` Required: no What to do next. ###### `fields` Type: `object[]` Required: no ###### object Type: `object` ###### `path` Type: `string` Required: yes ###### `message` Type: `string` Required: yes ## Related representations - [Human documentation](/reachiz/sections/conversations/operations/get-v1-conversations/) - [curl Markdown](/reachiz/sections/conversations/operations/get-v1-conversations.md?lang=curl) - [TypeScript Markdown](/reachiz/sections/conversations/operations/get-v1-conversations.md?lang=typescript) - [site llms.txt](/llms.txt) - [product llms.txt](/reachiz/llms.txt) - [snapshot llms.txt](/reachiz/llms.txt)