List Conversations

GET /conversations

Query Parameters

---

limit integer

A limit on the number of conversations to be returned. Limit can range between 1 and 50, and the default is 20.

cursor string (optional)

A cursor for pagination. Use the nextCursor value from the previous response to fetch the next page of results.

context[<key>] string | number (optional)

An optional filter to return only conversations matching the given context key and value. The key is user-defined and should match a key in the context object provided when the conversation was created.
For example: ?context[organisationId]=1 will match conversations where context.organisationId === 1.

---

Request

Node.js

import Inconvo from "@inconvoai/node";

const inconvo = new Inconvo({
  apiKey: process.env.INCONVO_API_KEY
});

const conversations = await inconvo.conversations.list({
  limit: 2,
  context: {
    organisationId: 1
  }
});

console.log(conversations);

Response

{
  "items": [
    {
      "id": "convo_898eb50b-dbe8-4496-9189-1800c0b38e23",
      "title": "Revenue analysis for Q4",
      "createdAt": "2025-07-18T08:05:17.188Z",
      "requestContext": { "organisationId": 1 }
    },
    {
      "id": "convo_0166818f-2e58-40a6-b610-49dc14f908d3",
      "title": "Customer segmentation query",
      "createdAt": "2025-07-10T14:45:11.364Z",
      "requestContext": { "organisationId": 1 }
    }
  ],
  "nextCursor": "convo_0166818f-2e58-40a6-b610-49dc14f908d3"
}

curl -X GET "https://app.inconvo.ai/api/v1/conversations?limit=2&context[organisationId]=1" \
  -H "Authorization: Bearer $INCONVO_API_KEY"

Response

{
  "items": [
    {
      "id": "convo_898eb50b-dbe8-4496-9189-1800c0b38e23",
      "title": "Revenue analysis for Q4",
      "createdAt": "2025-07-18T08:05:17.188Z",
      "requestContext": { "organisationId": 1 }
    },
    {
      "id": "convo_0166818f-2e58-40a6-b610-49dc14f908d3",
      "title": "Customer segmentation query",
      "createdAt": "2025-07-10T14:45:11.364Z",
      "requestContext": { "organisationId": 1 }
    }
  ],
  "nextCursor": "convo_0166818f-2e58-40a6-b610-49dc14f908d3"
}