List Conversations

List conversations with filtering, search, and pagination (AC1, AC7). - Full-text search uses PostgreSQL GIN index on search_vector - Supports filtering by date range, outcome, status, tag - Returns flagged conversations based on automated criteria - Response time target: <500ms (AC8)

List conversations with filtering, search, and pagination (AC1, AC7).

Full-text search uses PostgreSQL GIN index on search_vector
Supports filtering by date range, outcome, status, tag
Returns flagged conversations based on automated criteria
Response time target: <500ms (AC8)

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

start_date?|

Start date filter

end_date?|

End date filter

outcome?|

Outcome filter

status?|

Status filter

search?|

Search term (min 3 chars)

tag?|

Tag filter

flagged_only?boolean

Show flagged only

Defaultfalse

limit?integer

Max results

Default50

Range1 <= value <= 100

offset?integer

Pagination offset

Default0

Range0 <= value

sort_by?string

Sort column

Default"start_time"

sort_order?string

Sort direction

Default"desc"

Response Body

`application/json`

curl -X GET "https://loading/api/v1/conversations"

{
  "conversations": [
    {
      "duration_seconds": 0,
      "end_time": "string",
      "exchange_count": 0,
      "flags": [
        "string"
      ],
      "id": "string",
      "outcome": "string",
      "phone_number": "string",
      "recording_available": true,
      "requester_id": "string",
      "requester_name": "string",
      "start_time": "string",
      "status": "string",
      "tags": [
        "string"
      ]
    }
  ],
  "limit": 0,
  "offset": 0,
  "total": 0
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Authorization

Query Parameters

Response Body

200application/json

422application/json

`application/json`

`application/json`