List Calls

GET/api/v1/calls

범위는 이 API 키의 번호입니다 — 워크스페이스 전체가 아닙니다.

Authorization

numberKey

AuthorizationBearer <token>

번호 API 키. 키가 곧 발신 번호이자 접근 범위다 — 그 번호의 통화만 조회·제어할 수 있다.

In: header

Query Parameters

limit?integer

Range1 <= value <= 200

Default20

Header Parameters

X-Number-Id?string|null

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/calls"

{  "calls": [    {      "counterparty": "01023825815",      "direction": "outbound",      "end_reason": "agent_hangup",      "ended_at": "2026-08-28T10:16:31+09:00",      "id": "3f1c8a52-9d0e-4b77-b3a1-2e5f6c8d9a04",      "instruction": "예약 시간을 목요일 오후 3시로 변경해 달라고 요청해 줘.",      "number_id": "8b21d4e6-77af-4c30-9f5b-1a0c3d2e4f60",      "started_at": "2026-08-28T10:15:04+09:00",      "status": "completed",      "summary": "목요일 오후 3시로 변경을 요청했고 상대가 확인해 주었습니다."    }  ]}

Authorization

Query Parameters

Header Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`