Retrieve voice AI execution debug bundle API

GET

executions

{execution_id}

debug

cURL

curl --request GET \
  --url https://api.bolna.ai/executions/{execution_id}/debug \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.bolna.ai/executions/{execution_id}/debug', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bolna.ai/executions/{execution_id}/debug",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bolna.ai/executions/{execution_id}/debug"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bolna.ai/executions/{execution_id}/debug")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "unavailable": {
    "progression": "not_available"
  },
  "execution": {},
  "progression": {
    "call_start_at": "<string>",
    "turns": [
      {
        "sequence_id": 123,
        "turn_id": 123,
        "asr_end_to_user_end_ms": 123,
        "llm_start_to_asr_end_ms": 123,
        "llm_duration_ms": 123,
        "tts_start_to_llm_start_ms": 123,
        "tts_start_to_llm_end_ms": 123,
        "agent_speech_to_tts_start_ms": 123,
        "agent_speech_to_tts_first_audio_ms": 123
      }
    ],
    "transcript": [
      {
        "kind": "message",
        "role": "user",
        "text": "<string>",
        "interrupted": true,
        "message_category": "<string>",
        "not_sent_to_agent": true,
        "ts_exact": true,
        "tool_name": "<string>",
        "status": "<string>",
        "response_status_code": 123,
        "tool_latency_ms": 123,
        "label": "<string>",
        "ts": "<string>",
        "ts_ms": 123
      }
    ]
  },
  "logs": [
    {
      "created_at": "<string>",
      "component": "llm",
      "type": "request",
      "provider": "<string>",
      "data": "<string>",
      "data_shared_prefix_chars": 123,
      "latency": 123,
      "tool_name": "<string>",
      "reasoning_content": "<string>",
      "rag_info": {},
      "graph_routing_info": {},
      "status": "<string>"
    }
  ]
}

{
  "message": "include must be a comma-separated subset of execution, progression, logs"
}

{
  "message": "Agent execution not found"
}

Returns what the dashboard’s Debugging view shows for one call, in a single response. Use it when you want to find out why a call was slow, dropped or went off script without stitching together Get execution, the per-turn latency and Get raw logs yourself. The Bolna MCP server uses it for its get_execution_debug tool.

Sections

Section	What’s in it
`execution`	The call’s status and error, provider and numbers, timestamps, duration, cost and usage breakdowns, `telephony_data`, `latency_data`, `context_details`, extractions, `summary`, tool calls, transfers and retries
`progression`	`call_start_at`, the latency analytics for each turn, and the structured transcript: user and agent messages, function calls and call events such as transfers and hangups
`logs`	The pipeline logs for the call (transcriber, LLM, synthesizer and function calls), followed by one `webhook` entry with the call’s webhook deliveries. Webhook deliveries are included for calls from the last 14 days

Pass include to fetch only some sections, for example ?include=execution,logs. Leave it out to get all three. Any other value returns 400.

Reading LLM requests

Every LLM request resends the full prompt and the conversation so far, so in logs each llm request after the first carries only the text it adds. Its data_shared_prefix_chars says how many leading characters it shares with the previous request. To rebuild the full text of each request:

full_requests, previous = [], None
for row in bundle["logs"] or []:
    if row.get("component") == "llm" and row.get("type") == "request":
        text = row["data"]
        if "data_shared_prefix_chars" in row:
            text = previous[: row["data_shared_prefix_chars"]] + text
        full_requests.append(text)
        previous = text

The first request is always whole: it is the exact prompt that ran, with variables filled in. The bundle is trimmed for size. For the full data, use Get execution and Get raw logs.

When a section is missing

One section never fails the whole response. A section that doesn’t exist for this call, or that fails to load, comes back null, and unavailable names it with the reason:

{
  "execution_id": "4c06b4d1-4096-4561-919a-4f94539c8d4a",
  "unavailable": { "progression": "not_available" },
  "execution": { "id": "4c06b4d1-4096-4561-919a-4f94539c8d4a", "status": "completed" },
  "progression": null,
  "logs": []
}

Reason	Meaning
`not_available`	There is no data for this section on this call
`error`	The section failed to load. Retry, or fetch the same data from its own endpoint

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

execution_id

string<uuid>

required

The unique execution_id

Query Parameters

include

string

Comma-separated sections to return, from execution, progression and logs. Omit to return all three. Any other value returns 400.

Example:

"execution,logs"

Response

Debug bundle for the execution

execution_id

string<uuid>

The execution this bundle is for

unavailable

object

Sections that came back null, each with the reason. not_available means there is no data for that section on this call; error means it failed to load.

Show child attributes

Example:

{ "progression": "not_available" }

execution

object | null

The execution, keeping only fields that help debug a call (status, error_message, provider and numbers, timestamps, conversation_duration, total_cost, cost_breakdown, usage_breakdown, telephony_data, latency_data, context_details, extractions, summary, tool_call_logs, transfer_call_data, retries). Empty fields are dropped and the prose transcript is left out. Present only when requested.

progression

object | null

Per-turn latency and the structured transcript. Present only when requested.

Show child attributes

logs

object[] | null

The call's pipeline logs in order, followed by one webhook entry with its webhook deliveries (calls from the last 14 days only). Present only when requested.

Show child attributes

cURL

curl --request GET \
  --url https://api.bolna.ai/executions/{execution_id}/debug \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.bolna.ai/executions/{execution_id}/debug', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bolna.ai/executions/{execution_id}/debug",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bolna.ai/executions/{execution_id}/debug"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bolna.ai/executions/{execution_id}/debug")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "unavailable": {
    "progression": "not_available"
  },
  "execution": {},
  "progression": {
    "call_start_at": "<string>",
    "turns": [
      {
        "sequence_id": 123,
        "turn_id": 123,
        "asr_end_to_user_end_ms": 123,
        "llm_start_to_asr_end_ms": 123,
        "llm_duration_ms": 123,
        "tts_start_to_llm_start_ms": 123,
        "tts_start_to_llm_end_ms": 123,
        "agent_speech_to_tts_start_ms": 123,
        "agent_speech_to_tts_first_audio_ms": 123
      }
    ],
    "transcript": [
      {
        "kind": "message",
        "role": "user",
        "text": "<string>",
        "interrupted": true,
        "message_category": "<string>",
        "not_sent_to_agent": true,
        "ts_exact": true,
        "tool_name": "<string>",
        "status": "<string>",
        "response_status_code": 123,
        "tool_latency_ms": 123,
        "label": "<string>",
        "ts": "<string>",
        "ts_ms": 123
      }
    ]
  },
  "logs": [
    {
      "created_at": "<string>",
      "component": "llm",
      "type": "request",
      "provider": "<string>",
      "data": "<string>",
      "data_shared_prefix_chars": 123,
      "latency": 123,
      "tool_name": "<string>",
      "reasoning_content": "<string>",
      "rag_info": {},
      "graph_routing_info": {},
      "status": "<string>"
    }
  ]
}

{
  "message": "include must be a comma-separated subset of execution, progression, logs"
}

{
  "message": "Agent execution not found"
}

Get started

Voice agents

Telephony

Workflows

Account

Legacy

Retrieve voice AI execution debug bundle API

Sections

Reading LLM requests

When a section is missing

Authorizations

Path Parameters

Query Parameters

Response

​Sections

​Reading LLM requests

​When a section is missing

Authorizations

Path Parameters

Query Parameters

Response

Sections

Reading LLM requests

When a section is missing