Get Node Test Run

curl --request GET \
  --url https://api.bland.ai/v1/node_tests/run/:id \
  --header 'authorization: <authorization>'

const options = {method: 'GET', headers: {authorization: '<authorization>'}};

fetch('https://api.bland.ai/v1/node_tests/run/:id', 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.bland.ai/v1/node_tests/run/:id",
  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: <authorization>"
  ],
]);

$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.bland.ai/v1/node_tests/run/:id"

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

	req.Header.Add("authorization", "<authorization>")

	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.bland.ai/v1/node_tests/run/:id")

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

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

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

{
  "data": {
    "id": "727a85f1-1959-4ec1-95a4-248a2eecf1ae",
    "org_id": "99a0d526-6910-4f31-92b8-72834d0827fb",
    "created_at": "2025-11-17T14:47:40.174Z",
    "finished_at": "2025-11-17T14:48:11.399Z",
    "status": "COMPLETED",
    "pathway_id": "05f4b269-e79a-4825-b4cd-7778f782bfad",
    "node_id": "a7bbd409-504b-4ba3-a9d1-12f6bc270f58",
    "input": {
      "prompt": "Tell the user how cool they are and also what they think of the month of December",
      "conversations": [
        {
          "id": "b7d1eab7-f9a2-4e4d-b3ac-4e744cf93d2b",
          "type": "call"
        },
        {
          "id": "f9b44639-4de1-48d9-97ed-08b7fcb6eb1c",
          "type": "call"
        },
        {
          "id": "8c361b43-efa2-49e2-84a2-60ede375161b",
          "type": "call"
        },
        {
          "id": "a915cdce-fd3e-4f9f-b0bd-b5f6ee03ef1f",
          "type": "call"
        }
      ]
    },
    "result": [
      {
        "conversation_id": "b7d1eab7-f9a2-4e4d-b3ac-4e744cf93d2b",
        "data": [
          {
            "output": [
              {
                "role": "user",
                "node_id": "4f74e9a9-6d06-4756-8379-4d06220a4bda",
                "content": "I work at a company that makes boats. I'm a boat builder."
              },
              {
                "role": "assistant",
                "node_id": "a7bbd409-504b-4ba3-a9d1-12f6bc270f58",
                "content": "Gotcha. Okay, so, uh, what would you say are your biggest strengths?"
              }
            ],
            "is_original": true,
            "is_permutation": false
          },
          {
            "output": [
              {
                "role": "user",
                "nodeId": "4f74e9a9-6d06-4756-8379-4d06220a4bda",
                "content": "I work at a company that makes boats. I'm a boat builder."
              },
              {
                "role": "assistant",
                "nodeId": "a7bbd409-504b-4ba3-a9d1-12f6bc270f58",
                "content": "Wow, that sounds like a really cool job. That's pretty unique. You must have some interesting stories. Anyways, what would you say are your biggest strengths?"
              }
            ],
            "is_original": false,
            "is_permutation": false
          }
        ],
        "total_generations": 1,
        "generating_new_prompt": false,
        "generating_permutations": false,
      }
      // ...
    ]
  },
  "errors": null
}

GET

node_tests

run

:id

Get Node Test Run

curl --request GET \
  --url https://api.bland.ai/v1/node_tests/run/:id \
  --header 'authorization: <authorization>'

const options = {method: 'GET', headers: {authorization: '<authorization>'}};

fetch('https://api.bland.ai/v1/node_tests/run/:id', 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.bland.ai/v1/node_tests/run/:id",
  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: <authorization>"
  ],
]);

$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.bland.ai/v1/node_tests/run/:id"

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

	req.Header.Add("authorization", "<authorization>")

	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.bland.ai/v1/node_tests/run/:id")

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

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

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

{
  "data": {
    "id": "727a85f1-1959-4ec1-95a4-248a2eecf1ae",
    "org_id": "99a0d526-6910-4f31-92b8-72834d0827fb",
    "created_at": "2025-11-17T14:47:40.174Z",
    "finished_at": "2025-11-17T14:48:11.399Z",
    "status": "COMPLETED",
    "pathway_id": "05f4b269-e79a-4825-b4cd-7778f782bfad",
    "node_id": "a7bbd409-504b-4ba3-a9d1-12f6bc270f58",
    "input": {
      "prompt": "Tell the user how cool they are and also what they think of the month of December",
      "conversations": [
        {
          "id": "b7d1eab7-f9a2-4e4d-b3ac-4e744cf93d2b",
          "type": "call"
        },
        {
          "id": "f9b44639-4de1-48d9-97ed-08b7fcb6eb1c",
          "type": "call"
        },
        {
          "id": "8c361b43-efa2-49e2-84a2-60ede375161b",
          "type": "call"
        },
        {
          "id": "a915cdce-fd3e-4f9f-b0bd-b5f6ee03ef1f",
          "type": "call"
        }
      ]
    },
    "result": [
      {
        "conversation_id": "b7d1eab7-f9a2-4e4d-b3ac-4e744cf93d2b",
        "data": [
          {
            "output": [
              {
                "role": "user",
                "node_id": "4f74e9a9-6d06-4756-8379-4d06220a4bda",
                "content": "I work at a company that makes boats. I'm a boat builder."
              },
              {
                "role": "assistant",
                "node_id": "a7bbd409-504b-4ba3-a9d1-12f6bc270f58",
                "content": "Gotcha. Okay, so, uh, what would you say are your biggest strengths?"
              }
            ],
            "is_original": true,
            "is_permutation": false
          },
          {
            "output": [
              {
                "role": "user",
                "nodeId": "4f74e9a9-6d06-4756-8379-4d06220a4bda",
                "content": "I work at a company that makes boats. I'm a boat builder."
              },
              {
                "role": "assistant",
                "nodeId": "a7bbd409-504b-4ba3-a9d1-12f6bc270f58",
                "content": "Wow, that sounds like a really cool job. That's pretty unique. You must have some interesting stories. Anyways, what would you say are your biggest strengths?"
              }
            ],
            "is_original": false,
            "is_permutation": false
          }
        ],
        "total_generations": 1,
        "generating_new_prompt": false,
        "generating_permutations": false,
      }
      // ...
    ]
  },
  "errors": null
}

Path

string

required

The ID of the node test run to retrieve.

Headers

string

required

Your API key for authentication.

Response

string

Unique identifier for the node test run.

string

Organization ID that owns this node test run.

string

ISO timestamp when the node test run was created.

string

ISO timestamp when the node test run finished.

string

Current status of the node test run. Possible values are “COMPLETED”, “PENDING”, “CANCELLED”, and “ERROR”.

string

Identifier of the pathway this node belongs to.

string

Identifier of the node that was tested within the pathway.

object

Input configuration used for this node test run.

string

The instruction or system prompt used when testing the node.

array

Array of conversation references used as context for the node test.

string

Unique identifier of a conversation used in the test.

string

The type of conversation (for example, “call”).

array

Array of result objects, one per evaluated conversation.

string

ID of the conversation this result corresponds to.

number

Total number of generations produced for this conversation during the test run. For example, if I invoke the test with 5 permutations, then this value will be 6, since we need to generate 5 simulations for the permutations and one generation for the original user messages.

array

Array of generation batches for this conversation.

boolean

If true, then this result is the original user and agent interaction on the node.

boolean

If true, then this result is a generation using a permutation/variant of the original user inputs.

array

Ordered list of message turns (user/assistant) in this generated interaction.

string

Role of the message author (“user” or “assistant”).

string

Node identifier associated with this message turn.

string

Text content of the message.

boolean

An indicator to show if the system is in the process of simulating the agent response with the new prompt and original user inputs.

boolean

An indicator to show if the system is in the process of simulating the agent response with the new prompt and user permutations.

{
  "data": {
    "id": "727a85f1-1959-4ec1-95a4-248a2eecf1ae",
    "org_id": "99a0d526-6910-4f31-92b8-72834d0827fb",
    "created_at": "2025-11-17T14:47:40.174Z",
    "finished_at": "2025-11-17T14:48:11.399Z",
    "status": "COMPLETED",
    "pathway_id": "05f4b269-e79a-4825-b4cd-7778f782bfad",
    "node_id": "a7bbd409-504b-4ba3-a9d1-12f6bc270f58",
    "input": {
      "prompt": "Tell the user how cool they are and also what they think of the month of December",
      "conversations": [
        {
          "id": "b7d1eab7-f9a2-4e4d-b3ac-4e744cf93d2b",
          "type": "call"
        },
        {
          "id": "f9b44639-4de1-48d9-97ed-08b7fcb6eb1c",
          "type": "call"
        },
        {
          "id": "8c361b43-efa2-49e2-84a2-60ede375161b",
          "type": "call"
        },
        {
          "id": "a915cdce-fd3e-4f9f-b0bd-b5f6ee03ef1f",
          "type": "call"
        }
      ]
    },
    "result": [
      {
        "conversation_id": "b7d1eab7-f9a2-4e4d-b3ac-4e744cf93d2b",
        "data": [
          {
            "output": [
              {
                "role": "user",
                "node_id": "4f74e9a9-6d06-4756-8379-4d06220a4bda",
                "content": "I work at a company that makes boats. I'm a boat builder."
              },
              {
                "role": "assistant",
                "node_id": "a7bbd409-504b-4ba3-a9d1-12f6bc270f58",
                "content": "Gotcha. Okay, so, uh, what would you say are your biggest strengths?"
              }
            ],
            "is_original": true,
            "is_permutation": false
          },
          {
            "output": [
              {
                "role": "user",
                "nodeId": "4f74e9a9-6d06-4756-8379-4d06220a4bda",
                "content": "I work at a company that makes boats. I'm a boat builder."
              },
              {
                "role": "assistant",
                "nodeId": "a7bbd409-504b-4ba3-a9d1-12f6bc270f58",
                "content": "Wow, that sounds like a really cool job. That's pretty unique. You must have some interesting stories. Anyways, what would you say are your biggest strengths?"
              }
            ],
            "is_original": false,
            "is_permutation": false
          }
        ],
        "total_generations": 1,
        "generating_new_prompt": false,
        "generating_permutations": false,
      }
      // ...
    ]
  },
  "errors": null
}

Docs for agents: llms.txt

⌘I

Basic Tutorials

Calls

Conversational Pathways

Knowledge Bases

Numbers

Blocked Numbers

Widgets

Tools

Contacts

Memory

Node tests

Agent Testing

Evals

Guard Rails

Web Agents

Live Translation

Custom Twilio Accounts

Batches

Prompts

Account

Organizations

Messaging

SIP Trunks

Custom Dialing Pools

Personas

Citation Schemas

Alarms

Triage

Get Node Test Run

Path

Headers

Response

​Path

​Headers

​Response

Path

Headers

Response