통화 목록 조회

GET

https://api.claw-ops.com/v1/accounts/:accountId/calls

GET

/v1/accounts/:accountId/calls

curl -G https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/calls \
     -H "Authorization: Bearer <token>" \
     -d batchId=clx1a2b3c4d5e \
     -d direction=outbound \
     -d from=07052358010 \
     -d hangupCause=concurrency_limit_exceeded \
     -d limit=100 \
     -d maxDuration=60 \
     -d minDuration=10 \
     -d number=07012345678 \
     -d page=0 \
     -d pageSize=20 \
     -d page_size=50 \
     -d rootOnly=true \
     --data-urlencode since=2026-08-01T00:00:00Z \
     -d status=completed \
     -d to=01012345678 \
     --data-urlencode until=2026-09-01T00:00:00Z

{
  "data": [
    {
      "callId": "CAabcdef1234567890",
      "status": "queued",
      "to": "01012345678",
      "from": "07052358010",
      "direction": "outbound",
      "duration": 30,
      "accountId": "AC1a2b3c4d",
      "answeredBy": "human",
      "forwardedFrom": "string",
      "callerIdRestricted": false,
      "parentCallId": "CA0123456789abcdef",
      "batchId": "clx1a2b3c4d5e",
      "recordingUrl": "/v1/accounts/AC1a2b3c4d/recordings/CAabcdef1234567890",
      "hangupCause": "invalid_number",
      "hangupCauseQ850": 1,
      "sipResponseCode": 404,
      "hangupSource": "carrier",
      "transferTo": "01012345678",
      "transferStatus": "completed",
      "transferDuration": 60,
      "transferHangupCauseQ850": 16,
      "transferSipResponseCode": 500,
      "transferReasonText": "CS_NORMAL_RELEASE",
      "transfers": [
        {
          "sequence": 1,
          "to": "string",
          "mode": "string",
          "destinationType": "string",
          "status": "string",
          "duration": 1,
          "billable": true,
          "billableDuration": 1,
          "hangupCauseQ850": 1,
          "sipResponseCode": 1,
          "reasonText": "string",
          "startedAt": "2024-01-15T09:30:00Z",
          "answeredAt": "2024-01-15T09:30:00Z",
          "connectedAt": "2024-01-15T09:30:00Z",
          "endedAt": "2024-01-15T09:30:00Z",
          "timeout": 1
        }
      ],
      "dateCreated": "2024-01-15T09:30:00Z",
      "dateUpdated": "2024-01-15T09:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 1,
    "total": 1
  }
}

계정의 통화 로그를 페이지네이션으로 조회합니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Query parameters

statusenumOptional

통화 상태로 필터링. 실패 사유를 더 세분해 조회하려면 hangupCause 를 사용하세요.

fromstring or list of stringsOptional

발신번호로 필터링. 단일 값 또는 배열 (?from=070…&from=070…)

tostring or list of stringsOptional

수신번호로 필터링. 단일 값 또는 배열 (?to=010…&to=010…)

numberstring or list of stringsOptional

관여 번호로 필터링 (from OR to 매칭). 해당 번호가 발신 또는 수신에 포함된 통화를 조회합니다. 단일 값 또는 배열

sincedatetimeOptional

이 시각 이후(포함) 시작된 통화만. ISO 8601.

untildatetimeOptional

이 시각 이전(미포함) 시작된 통화만. ISO 8601. since 와 함께 쓰면 구간이 겹치지 않게 이어붙일 수 있습니다.

minDurationintegerOptional0-2147483647

통화 시간(초) 하한. 이 값 포함.

maxDurationintegerOptional0-2147483647

통화 시간(초) 상한. 이 값 포함. minDuration=0&maxDuration=0 이면 0초 통화만.

hangupCausestring or list of stringsOptional

종료 사유로 필터링. status 가 실패를 한 덩어리로 묶는 것과 달리 왜 끝났는지로 가릅니다 — 채널 초과(concurrency_limit_exceeded)·결번(invalid_number)· 한국AI통신 오류(app_error) 등. 종료 사유 필터는 Calls API를 참고하세요. 단일 값 또는 배열.

directionenumOptional

통화 방향으로 필터링.

Allowed values:

rootOnlybooleanOptional

true 면 다른 통화에서 이어진 통화를 뺍니다. <Dial> 로 나간 통화, 같은 계정 번호로 건 발신이나 전환이 들어온 쪽 통화가 빠집니다.

batchIdstringOptional

이 통화 배치에서 나간 통화만.

pageSizeintegerOptional<=100Defaults to 20

페이지당 항목 수 (최대 100)

page_sizeintegerOptional<=100Deprecated

pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.

limitintegerOptional<=100Deprecated

pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.

pageintegerOptionalDefaults to 0

페이지 번호 (0부터 시작)

Response

통화 목록

datalist of objectsOptional

metaobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error