Skip to main content
POST
/
v2
/
calls
/
list
통화 목록 조회
curl --request POST \
  --url https://client-api.tryvox.co/v2/calls/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filter_criteria": {
    "agent_id": [
      "agent_123"
    ],
    "call_type": [
      "outbound"
    ]
  },
  "limit": 50,
  "sort_order": "descending"
}'
{
  "calls": [
    {
      "agent_id": "<string>",
      "call_id": "<string>",
      "call_type": "web",
      "call_from": "<string>",
      "call_to": "<string>",
      "dynamic_variables": {},
      "metadata": {},
      "disconnection_reason": "user_hangup",
      "start_timestamp": 123,
      "end_timestamp": 123,
      "duration_ms": 123,
      "transcript": [
        {
          "role": "agent",
          "content": "<string>",
          "start_at": 123,
          "end_at": 123
        }
      ],
      "transcript_with_tool_calls": [
        {
          "role": "agent",
          "content": "<string>",
          "start_at": 123,
          "end_at": 123
        }
      ],
      "recording_url": "<string>",
      "call_cost": {
        "total_credits_used": 123,
        "duration_seconds": 123
      },
      "call_analysis": {
        "summary": "<string>",
        "user_sentiment": "positive",
        "custom_analysis_data": [
          {}
        ]
      },
      "opt_out_sensitive_data_storage": false
    }
  ],
  "next_cursor": "<string>",
  "total_count": 0
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

통화 목록 조회를 위한 필터 및 페이징 옵션

filter_criteria
object

반환할 통화에 적용할 필터 조건

sort_order
string
default:descending

정렬 순서: 'ascending' 또는 'descending'

limit
integer
default:50

최대 반환 개수

Required range: 1 <= x <= 500
pagination_key
string | null

다음 페이지 조회를 위한 커서(통화 ID)

Response

Successful Response

통화 목록 조회 응답 모델

calls
CallDataDto · object[]
required

필터 조건에 부합하는 통화 목록

next_cursor
string | null

다음 페이지 조회에 사용할 커서 값

total_count
integer
default:0

필터에 부합하는 전체 통화 수

I