コンテンツにスキップ
nocall.ainocall ドキュメント

通話結果一覧を取得する

GET
/api/v1/call-results
curl --request GET \
  --url 'https://api.nocall.ai/api/v1/call-results?page=1&pageSize=20&sortBy=createdAt&sortOrder=asc' \
  --header 'x-api-key: <x-api-key>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
callTaskId

架電タスクID

string
>= 1 characters

架電タスクID

callId

通話ID

string
>= 1 characters

通話ID

endUserId

エンドユーザーID

string
>= 1 characters

エンドユーザーID

agentId

エージェントID

string
>= 1 characters

エージェントID

status

通話ステータス。複数指定はカンマ区切り（preparing, ringing, in_progress, completed, no_answer, unreachable, failed）

string

通話ステータス。複数指定はカンマ区切り（preparing, ringing, in_progress, completed, no_answer, unreachable, failed）

createdFrom

作成日時の開始（ISO 8601）

string format: date-time

作成日時の開始（ISO 8601）

createdTo

作成日時の終了（ISO 8601）

string format: date-time

作成日時の終了（ISO 8601）

page

ページ番号

integer
default: 1 >= 1

ページ番号

pageSize

1ページあたりの件数（最大500）

integer
default: 20 >= 1 <= 500

1ページあたりの件数（最大500）

sortBy

並び替えに使用するフィールド

string
default: createdAt
Allowed values: createdAt startedAt endedAt durationSeconds

並び替えに使用するフィールド

sortOrder

並び順。ascは昇順、descは降順

string
default: desc
Allowed values: asc desc

並び順。ascは昇順、descは降順

Responses

Section titled “Responses”

200

Section titled “200”

通話結果一覧

Media typeapplication/json

通話結果一覧レスポンス

object
data
required

指定条件に一致した通話結果

Array<object>
object
callId
required

通話を一意に識別するID

string
callTaskId
required

架電タスクID。タスクを伴わない場合はnull

string | null
detailsUrl
required

Nocallコンソールの通話詳細画面URL

string format: uri
agentId
required

通話に使用したエージェントID

string
agentName
required

エージェント名。取得できない場合はnull

string | null
endUserId
required

エンドユーザーID。紐づかない場合はnull

string | null
status
required

現在の通話ステータス

string
Allowed values: preparing ringing in_progress completed no_answer unreachable failed
direction
required

発信・着信などの通話方向

string
Allowed values: inbound outbound web
from
required

発信元

string
to
required

発信先

string
startedAt
required

通話開始日時。未開始の場合はnull

string | null format: date-time
endedAt
required

通話終了日時。未終了の場合はnull

string | null format: date-time
durationSeconds
required

通話時間（秒）。未確定の場合はnull

integer | null
isVoicemail
required

留守番電話と判定されたか

boolean
createdAt
required

通話レコードの作成日時

string format: date-time
updatedAt
required

通話レコードの最終更新日時

string format: date-time
resultAvailable
required

通話結果を取得できるか

boolean
audioAvailable
required

録音音声が保存されているか

boolean
pagination
required

ページネーション情報

object
total
required

条件に一致した総件数

integer
page
required

現在のページ番号

integer
>= 1
pageSize
required

1ページの件数

integer
>= 1 <= 500
totalPages
required

総ページ数

integer
Example
{
  "data": [
    {
      "callId": "call_XXX",
      "callTaskId": "ctt_XXX",
      "detailsUrl": "https://console.nocall.ai/workspace/ws_XXX/project/prj_XXX/call-logs/call_XXX",
      "status": "completed",
      "direction": "outbound",
      "from": "+8150XXXXXXXX",
      "to": "+8190XXXXXXXX",
      "startedAt": "2026-07-08T01:00:00.000Z",
      "endedAt": "2026-07-08T01:03:20.000Z",
      "durationSeconds": 200,
      "isVoicemail": false,
      "createdAt": "2026-07-08T00:59:55.000Z",
      "updatedAt": "2026-07-08T01:03:25.000Z",
      "agentId": "agt_XXX",
      "agentName": "初回架電エージェント",
      "endUserId": "edu_XXX",
      "resultAvailable": true,
      "audioAvailable": true
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "pageSize": 20,
    "totalPages": 1
  }
}

400

Section titled “400”

リクエストが不正です

Media typeapplication/json
Any of:
object
code

機械判定用のエラーコード

string
error
required

エラー内容

string
Example
{
  "success": false
}

401

Section titled “401”

APIキーが未指定または無効です

Media typeapplication/json
object
code

機械判定用のエラーコード

string
error
required

エラー内容

string
Examplegenerated
{
  "code": "example",
  "error": "example"
}

403

Section titled “403”

IP制限などによりアクセスできません

Media typeapplication/json
object
code

機械判定用のエラーコード

string
error
required

エラー内容

string
Examplegenerated
{
  "code": "example",
  "error": "example"
}

404

Section titled “404”

APIキーに紐づくプロジェクトが見つかりません

Media typeapplication/json
object
code

機械判定用のエラーコード

string
error
required

エラー内容

string
Examplegenerated
{
  "code": "example",
  "error": "example"
}

429

Section titled “429”

レート制限を超えました

Media typeapplication/json
object
code

機械判定用のエラーコード

string
error
required

エラー内容

string
Examplegenerated
{
  "code": "example",
  "error": "example"
}

500

Section titled “500”

サーバー内部でエラーが発生しました

Media typeapplication/json
object
code

機械判定用のエラーコード

string
error
required

エラー内容

string
Examplegenerated
{
  "code": "example",
  "error": "example"
}