List conversations
const url = 'https://optlo.com/api/v1/conversations?limit=50&view=open';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://optlo.com/api/v1/conversations?limit=50&view=open' \ --header 'Authorization: Bearer <token>'Requires conversations:read.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Maximum number of resources to return on one page.
Opaque cursor from the preceding page. Bound to workspace, resource and filters; survives key rotation.
Omission includes open and closed. Escalated and unassigned select open conversations.
Return only conversations belonging to this user.
Exclusive modification timestamp.
Response
Section titled “Response”Success
Show child attributes
Resources on this page.
A conversation with a user.
Show child attributes
Unique identifier for the conversation.
Time the conversation was closed. Null while the conversation is open.
User the conversation belongs to.
Show child attributes
Unique identifier for the user.
Whether the conversation has been escalated to an operator.
Time the conversation was created.
Time the conversation was last updated.
Pass this cursor to retrieve the next page. Null when no further page is available. When polling events in ascending order, retain the cursor even on empty pages.
Example
{ "data": [ { "id": "conv_B8kN4pR6xZ2_kR7mP3xB9nQ2vL5z", "user": { "id": "user_kR7mP3xB9nQ2vL5z" }, "closedAt": null, "escalated": false, "createdAt": "2026-10-13T09:10:00.000Z", "updatedAt": "2026-10-13T09:10:00.000Z" } ], "nextCursor": null}