List conversations

​

Returns a page of conversations for the authenticated account, most recently started first. Use the optional filters to narrow by call id (transport_key), end-user (user_id), medium, status, or start time window. Paginate using the cursor from the previous page's next_cursor.

Required scope: intelligence:read

Query Parameters
  • transport_key
    Type: string · Transport Keynullable

    Filter by call id / transport key.

  • user_id
    Type: string · User Idnullable

    Filter by end-user identifier.

  • medium
    Type: string · Mediumnullable

    Filter by medium, e.g. voice.

  • status
    Type: string · Statusnullable

    Filter by status: open or closed.

  • started_after
    Type: string · Started Afternullable

    ISO 8601 datetime — return only conversations that started after this time.

  • started_before
    Type: string · Started Beforenullable

    ISO 8601 datetime — return only conversations that started before this time.

  • limit
    Type: integer · Limit
    min:  
    1
    max:  
    200

    Page size (default 50, max 200).

  • cursor
    Type: string · Cursornullable

    Opaque keyset cursor from the previous page's next_cursor.

Responses
  • application/json
  • application/json
  • application/json
Request Example for get/conversations
curl https://api.simwood.com/intelligence/v1/conversations \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "conversation_id": "string",
      "medium": "string",
      "status": "string",
      "transport_key": "string",
      "user_id": "string",
      "source_sessions": [
        "string"
      ],
      "configuration_ids": [
        "string"
      ],
      "started_at": "string",
      "ended_at": "string",
      "turn_count": 0,
      "usage": {
        "audio_seconds": 0,
        "operator_results_emitted": 0
      },
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "next_cursor": "string"
}

Successful Response

Simwood API Documentation