# 콜 플로우 녹음 블럭 파일 다운로드 (/docs/api/calls/getVerbRecording) **GET /v1/accounts/{accountId}/recordings/{callId}/verb/{recordingName}** ```json { "operationId": "getVerbRecording", "summary": "콜 플로우 녹음 블럭 파일 다운로드", "description": "콜 플로우의 녹음 블럭(VoiceML ``)이 남긴 개별 녹음 파일(WAV)을 반환합니다. 통화 전체 녹음과 달리 한 통화에 여러 개일 수 있어 파일 이름으로 지목합니다. 이 URL 은 `callflow.ended` 웹훅과 배치 발신 결과의 녹음 변수 값으로 전달됩니다. URL 자체는 만료되지 않지만 녹음 파일은 90일간 보관되므로, 더 오래 두어야 하면 그 전에 내려받으십시오. 녹음이 없거나 다른 계정의 통화일 경우 404 를 반환합니다.", "tags": [ "Calls" ], "parameters": [ { "name": "accountId", "in": "path", "required": true, "schema": { "type": "string" }, "example": "AC1a2b3c4d" }, { "name": "callId", "in": "path", "required": true, "schema": { "type": "string" }, "example": "CA1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6" }, { "name": "recordingName", "in": "path", "required": true, "description": "녹음 변수 값(URL)의 마지막 경로 조각. `verbrec-{callId}-{timestamp}` 형식입니다.", "schema": { "type": "string" }, "example": "verbrec-CA1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6-1785218466628" } ], "responses": { "200": { "description": "녹음 파일 (WAV) 스트림", "headers": { "Content-Type": { "schema": { "type": "string", "example": "audio/wav" } }, "Content-Disposition": { "schema": { "type": "string", "example": "inline; filename=\"verbrec-CA1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6-1785218466628.wav\"" } } }, "content": { "audio/wav": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "description": "인증 실패 (Bearer 누락/무효)", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "사람이 읽을 수 있는 에러 메시지" }, "code": { "type": "string", "description": "기계 판독용 에러 코드. **분기는 이 값으로 하세요** — `error` 문구는 안내를 다듬으면서\n바뀔 수 있지만 코드는 계약입니다.\n\n같은 상태 코드라도 대응이 갈리는 경우가 있습니다. 예를 들어 발신의 `422` 는\n - `recipient_blocked`: 수신거부 명단에 있는 번호입니다. 재시도하지 말고 명단에서\n 해제해야 발신됩니다.\n - `quota_exceeded`: 플랜 한도를 넘었습니다. 다음 주기에 다시 발신됩니다.\n\n전화번호 정규화 관련:\n - `INVALID_PHONE_NUMBER`: 전화번호 포맷 오류 (한국 번호 형식 아님)\n - `UNSUPPORTED_COUNTRY`: 국제 발신 미지원 (+82 외 국가코드)", "example": "recipient_blocked" }, "ip": { "type": "string", "description": "`overseas_ip_blocked` 일 때만 옵니다. 국외 IP 라고 판정한 요청 IP 입니다.\n해외 리전 클라우드 서버에서 호출한다면 이 값이 그 서버의 공인 IP 이며, 콘솔\n「국외 접속 예외」에서 예외를 신청할 때 이 고정 IP 를 적습니다.", "example": "52.79.213.41" }, "processedAt": { "type": "string", "format": "date-time", "description": "문자 발송 요청을 거부한 서버가 오류 응답을 생성한 시각(UTC). 콘솔은 이 값을 한국 시각으로 표시합니다. 인증·요청 형식 검증 등 발송 서비스 진입 전 오류에는 없을 수 있습니다.", "example": "2026-10-21T04:10:34.303Z" }, "blockers": { "type": "array", "description": "`certificate_not_eligible` 일 때만 옵니다. 발급할 수 없는 번호와 그 이유입니다.", "items": { "type": "object", "description": "번호 하나가 발급되지 않는(또는 안내가 필요한) 이유.\n\n| code | 뜻 | 발급 |\n|---|---|---|\n| `number_not_owned` | 이 계정이 보유한 번호가 아님(반납·재배정 포함) | 막힘 |\n| `number_not_carrier_issued` | 한국AI통신이 개통한 070·대표번호가 아님(모바일 게이트웨이, 타사 번호) | 막힘 |\n| `business_info_incomplete` | 사업자 계정인데(관리번호 제외) 상호·사업자등록번호·대표자명·사업장 주소 중 빈 칸 | 막힘 |\n| `identity_unverified` | 개인 계정 번호 또는 관리번호인데 그 번호에 본인확인 정보가 없음 | 막힘 |\n| `account_restricted` | 이용 제한 계정 | 막힘 |\n| `business_recheck_pending` | 사업자 계정인데 사업자 정보 재확인이 진행 중(통과 전) — 관리번호를 뺀 계정의 모든 번호 | 막힘 |\n| `holder_is_personal` | 개인 명의로 찍힌다는 안내 | 가능 |", "properties": { "number": { "type": "string", "description": "422 응답의 blockers 에만 있다", "example": "07012340002" }, "code": { "type": "string", "enum": [ "number_not_owned", "number_not_carrier_issued", "business_info_incomplete", "identity_unverified", "account_restricted", "business_recheck_pending", "holder_is_personal" ], "example": "number_not_carrier_issued" }, "message": { "type": "string", "example": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다." } }, "required": [ "code", "message" ] } } } } } } }, "403": { "description": "접근 권한 없음", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "사람이 읽을 수 있는 에러 메시지" }, "code": { "type": "string", "description": "기계 판독용 에러 코드. **분기는 이 값으로 하세요** — `error` 문구는 안내를 다듬으면서\n바뀔 수 있지만 코드는 계약입니다.\n\n같은 상태 코드라도 대응이 갈리는 경우가 있습니다. 예를 들어 발신의 `422` 는\n - `recipient_blocked`: 수신거부 명단에 있는 번호입니다. 재시도하지 말고 명단에서\n 해제해야 발신됩니다.\n - `quota_exceeded`: 플랜 한도를 넘었습니다. 다음 주기에 다시 발신됩니다.\n\n전화번호 정규화 관련:\n - `INVALID_PHONE_NUMBER`: 전화번호 포맷 오류 (한국 번호 형식 아님)\n - `UNSUPPORTED_COUNTRY`: 국제 발신 미지원 (+82 외 국가코드)", "example": "recipient_blocked" }, "ip": { "type": "string", "description": "`overseas_ip_blocked` 일 때만 옵니다. 국외 IP 라고 판정한 요청 IP 입니다.\n해외 리전 클라우드 서버에서 호출한다면 이 값이 그 서버의 공인 IP 이며, 콘솔\n「국외 접속 예외」에서 예외를 신청할 때 이 고정 IP 를 적습니다.", "example": "52.79.213.41" }, "processedAt": { "type": "string", "format": "date-time", "description": "문자 발송 요청을 거부한 서버가 오류 응답을 생성한 시각(UTC). 콘솔은 이 값을 한국 시각으로 표시합니다. 인증·요청 형식 검증 등 발송 서비스 진입 전 오류에는 없을 수 있습니다.", "example": "2026-10-21T04:10:34.303Z" }, "blockers": { "type": "array", "description": "`certificate_not_eligible` 일 때만 옵니다. 발급할 수 없는 번호와 그 이유입니다.", "items": { "type": "object", "description": "번호 하나가 발급되지 않는(또는 안내가 필요한) 이유.\n\n| code | 뜻 | 발급 |\n|---|---|---|\n| `number_not_owned` | 이 계정이 보유한 번호가 아님(반납·재배정 포함) | 막힘 |\n| `number_not_carrier_issued` | 한국AI통신이 개통한 070·대표번호가 아님(모바일 게이트웨이, 타사 번호) | 막힘 |\n| `business_info_incomplete` | 사업자 계정인데(관리번호 제외) 상호·사업자등록번호·대표자명·사업장 주소 중 빈 칸 | 막힘 |\n| `identity_unverified` | 개인 계정 번호 또는 관리번호인데 그 번호에 본인확인 정보가 없음 | 막힘 |\n| `account_restricted` | 이용 제한 계정 | 막힘 |\n| `business_recheck_pending` | 사업자 계정인데 사업자 정보 재확인이 진행 중(통과 전) — 관리번호를 뺀 계정의 모든 번호 | 막힘 |\n| `holder_is_personal` | 개인 명의로 찍힌다는 안내 | 가능 |", "properties": { "number": { "type": "string", "description": "422 응답의 blockers 에만 있다", "example": "07012340002" }, "code": { "type": "string", "enum": [ "number_not_owned", "number_not_carrier_issued", "business_info_incomplete", "identity_unverified", "account_restricted", "business_recheck_pending", "holder_is_personal" ], "example": "number_not_carrier_issued" }, "message": { "type": "string", "example": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다." } }, "required": [ "code", "message" ] } } } } } } }, "404": { "description": "콜을 찾을 수 없거나 해당 이름의 녹음이 없음", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "사람이 읽을 수 있는 에러 메시지" }, "code": { "type": "string", "description": "기계 판독용 에러 코드. **분기는 이 값으로 하세요** — `error` 문구는 안내를 다듬으면서\n바뀔 수 있지만 코드는 계약입니다.\n\n같은 상태 코드라도 대응이 갈리는 경우가 있습니다. 예를 들어 발신의 `422` 는\n - `recipient_blocked`: 수신거부 명단에 있는 번호입니다. 재시도하지 말고 명단에서\n 해제해야 발신됩니다.\n - `quota_exceeded`: 플랜 한도를 넘었습니다. 다음 주기에 다시 발신됩니다.\n\n전화번호 정규화 관련:\n - `INVALID_PHONE_NUMBER`: 전화번호 포맷 오류 (한국 번호 형식 아님)\n - `UNSUPPORTED_COUNTRY`: 국제 발신 미지원 (+82 외 국가코드)", "example": "recipient_blocked" }, "ip": { "type": "string", "description": "`overseas_ip_blocked` 일 때만 옵니다. 국외 IP 라고 판정한 요청 IP 입니다.\n해외 리전 클라우드 서버에서 호출한다면 이 값이 그 서버의 공인 IP 이며, 콘솔\n「국외 접속 예외」에서 예외를 신청할 때 이 고정 IP 를 적습니다.", "example": "52.79.213.41" }, "processedAt": { "type": "string", "format": "date-time", "description": "문자 발송 요청을 거부한 서버가 오류 응답을 생성한 시각(UTC). 콘솔은 이 값을 한국 시각으로 표시합니다. 인증·요청 형식 검증 등 발송 서비스 진입 전 오류에는 없을 수 있습니다.", "example": "2026-10-21T04:10:34.303Z" }, "blockers": { "type": "array", "description": "`certificate_not_eligible` 일 때만 옵니다. 발급할 수 없는 번호와 그 이유입니다.", "items": { "type": "object", "description": "번호 하나가 발급되지 않는(또는 안내가 필요한) 이유.\n\n| code | 뜻 | 발급 |\n|---|---|---|\n| `number_not_owned` | 이 계정이 보유한 번호가 아님(반납·재배정 포함) | 막힘 |\n| `number_not_carrier_issued` | 한국AI통신이 개통한 070·대표번호가 아님(모바일 게이트웨이, 타사 번호) | 막힘 |\n| `business_info_incomplete` | 사업자 계정인데(관리번호 제외) 상호·사업자등록번호·대표자명·사업장 주소 중 빈 칸 | 막힘 |\n| `identity_unverified` | 개인 계정 번호 또는 관리번호인데 그 번호에 본인확인 정보가 없음 | 막힘 |\n| `account_restricted` | 이용 제한 계정 | 막힘 |\n| `business_recheck_pending` | 사업자 계정인데 사업자 정보 재확인이 진행 중(통과 전) — 관리번호를 뺀 계정의 모든 번호 | 막힘 |\n| `holder_is_personal` | 개인 명의로 찍힌다는 안내 | 가능 |", "properties": { "number": { "type": "string", "description": "422 응답의 blockers 에만 있다", "example": "07012340002" }, "code": { "type": "string", "enum": [ "number_not_owned", "number_not_carrier_issued", "business_info_incomplete", "identity_unverified", "account_restricted", "business_recheck_pending", "holder_is_personal" ], "example": "number_not_carrier_issued" }, "message": { "type": "string", "example": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다." } }, "required": [ "code", "message" ] } } } } } } }, "500": { "description": "녹음 파일 다운로드 실패 (GCS 오류 등)", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "사람이 읽을 수 있는 에러 메시지" }, "code": { "type": "string", "description": "기계 판독용 에러 코드. **분기는 이 값으로 하세요** — `error` 문구는 안내를 다듬으면서\n바뀔 수 있지만 코드는 계약입니다.\n\n같은 상태 코드라도 대응이 갈리는 경우가 있습니다. 예를 들어 발신의 `422` 는\n - `recipient_blocked`: 수신거부 명단에 있는 번호입니다. 재시도하지 말고 명단에서\n 해제해야 발신됩니다.\n - `quota_exceeded`: 플랜 한도를 넘었습니다. 다음 주기에 다시 발신됩니다.\n\n전화번호 정규화 관련:\n - `INVALID_PHONE_NUMBER`: 전화번호 포맷 오류 (한국 번호 형식 아님)\n - `UNSUPPORTED_COUNTRY`: 국제 발신 미지원 (+82 외 국가코드)", "example": "recipient_blocked" }, "ip": { "type": "string", "description": "`overseas_ip_blocked` 일 때만 옵니다. 국외 IP 라고 판정한 요청 IP 입니다.\n해외 리전 클라우드 서버에서 호출한다면 이 값이 그 서버의 공인 IP 이며, 콘솔\n「국외 접속 예외」에서 예외를 신청할 때 이 고정 IP 를 적습니다.", "example": "52.79.213.41" }, "processedAt": { "type": "string", "format": "date-time", "description": "문자 발송 요청을 거부한 서버가 오류 응답을 생성한 시각(UTC). 콘솔은 이 값을 한국 시각으로 표시합니다. 인증·요청 형식 검증 등 발송 서비스 진입 전 오류에는 없을 수 있습니다.", "example": "2026-10-21T04:10:34.303Z" }, "blockers": { "type": "array", "description": "`certificate_not_eligible` 일 때만 옵니다. 발급할 수 없는 번호와 그 이유입니다.", "items": { "type": "object", "description": "번호 하나가 발급되지 않는(또는 안내가 필요한) 이유.\n\n| code | 뜻 | 발급 |\n|---|---|---|\n| `number_not_owned` | 이 계정이 보유한 번호가 아님(반납·재배정 포함) | 막힘 |\n| `number_not_carrier_issued` | 한국AI통신이 개통한 070·대표번호가 아님(모바일 게이트웨이, 타사 번호) | 막힘 |\n| `business_info_incomplete` | 사업자 계정인데(관리번호 제외) 상호·사업자등록번호·대표자명·사업장 주소 중 빈 칸 | 막힘 |\n| `identity_unverified` | 개인 계정 번호 또는 관리번호인데 그 번호에 본인확인 정보가 없음 | 막힘 |\n| `account_restricted` | 이용 제한 계정 | 막힘 |\n| `business_recheck_pending` | 사업자 계정인데 사업자 정보 재확인이 진행 중(통과 전) — 관리번호를 뺀 계정의 모든 번호 | 막힘 |\n| `holder_is_personal` | 개인 명의로 찍힌다는 안내 | 가능 |", "properties": { "number": { "type": "string", "description": "422 응답의 blockers 에만 있다", "example": "07012340002" }, "code": { "type": "string", "enum": [ "number_not_owned", "number_not_carrier_issued", "business_info_incomplete", "identity_unverified", "account_restricted", "business_recheck_pending", "holder_is_personal" ], "example": "number_not_carrier_issued" }, "message": { "type": "string", "example": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다." } }, "required": [ "code", "message" ] } } } } } } } } } ```