Skip to main content
GET
/
v1
/
node_test
/
run
/
:id
Get Node Test Run
curl --request GET \
  --url https://api.bland.ai/v1/node_test/run/:id \
  --header 'authorization: <authorization>'
{
  "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

id
string
required
The ID of the node test run to retrieve.

Headers

authorization
string
required
Your API key for authentication.

Response

data.id
string
Unique identifier for the node test run.
data.org_id
string
Organization ID that owns this node test run.
data.created_at
string
ISO timestamp when the node test run was created.
data.finished_at
string
ISO timestamp when the node test run finished.
data.status
string
Current status of the node test run. Possible values are “COMPLETED”, “PENDING”, “CANCELLED”, and “ERROR”.
data.pathway_id
string
Identifier of the pathway this node belongs to.
data.node_id
string
Identifier of the node that was tested within the pathway.
data.input
object
Input configuration used for this node test run.
data.input.prompt
string
The instruction or system prompt used when testing the node.
data.input.conversations
array
Array of conversation references used as context for the node test.
data.input.conversations[].id
string
Unique identifier of a conversation used in the test.
data.input.conversations[].type
string
The type of conversation (for example, “call”).
data.result
array
Array of result objects, one per evaluated conversation.
data.result[].conversation_id
string
ID of the conversation this result corresponds to.
data.result[].total_generations
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.
data.result[].data
array
Array of generation batches for this conversation.
data.result[].data[].is_original
boolean
If true, then this result is the original user and agent interaction on the node.
data.result[].data[].is_permutation
boolean
If true, then this result is a generation using a permutation/variant of the original user inputs.
data.result[].data[].output
array
Ordered list of message turns (user/assistant) in this generated interaction.
data.result[].data[].output[].role
string
Role of the message author (“user” or “assistant”).
data.result[].data[].output[].node_id
string
Node identifier associated with this message turn.
data.result[].data[].output[].content
string
Text content of the message.
data.result[].generating_new_prompt
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.
data.result[].generating_permutations
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
}