List conversations | Runtype Documentation

{
  "data": [
    {
      "agentMode": "human",
      "createdAt": "2024-06-10T09:15:00Z",
      "externalParticipantId": "user_987654321",
      "externalThreadId": "thread_123456789",
      "id": "conv_abc123def456",
      "lastMessageAt": "2024-06-12T14:45:30Z",
      "messageCount": 42,
      "participantEmail": "jane.doe@example.com",
      "participantName": "Jane Doe",
      "status": "open",
      "subject": "Issue with account login",
      "surfaceId": "surface_001",
      "takeoverActorId": "agent_78910",
      "takeoverActorType": "support_agent",
      "takeoverAt": "2024-06-11T10:00:00Z",
      "takeoverReason": "Customer requested human assistance",
      "timezone": "America/New_York",
      "updatedAt": "2024-06-12T14:50:00Z"
    }
  ],
  "pagination": {
    "currentOffset": 0,
    "hasMore": true,
    "hasPrev": false,
    "limit": 50,
    "nextCursor": "cursor_abcdef123456",
    "prevCursor": null,
    "currentPage": 1,
    "totalCount": 120,
    "totalPages": 3
  }
}

Get all messaging conversations for the authenticated user with filtering and pagination.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

limitstringOptional

Max results per page (default 50, max 100)

cursorstringOptional

Pagination cursor

surfaceIdstringOptional

Filter by surface ID

statusstringOptional

Filter by status (open, closed, archived, all)

agentModestringOptional

Filter by agent mode (auto, human, all)

searchstringOptional

Search by subject, participant name, or email

Response

Paginated list of conversations

datalist of objects

paginationobject

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/messaging/conversations \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"