List tests

curl --request GET \
  --url https://realtime-api.voiceflow.com/v1/stable/test \
  --header 'Authorization: Bearer <token>'

const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();

import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v1/stable/test?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()

{
  "tests": [
    {
      "id": "<string>",
      "name": "<string>",
      "settings": {
        "launchEvent": "<string>",
        "variableStates": []
      },
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "turnOrder": [
        "<string>"
      ]
    }
  ]
}

List tests

Returns every test in the environment. A test is a scripted conversation replayed against the agent. The call takes no paging parameters, so one request yields the whole set.

GET

/v1/stable/test

List tests

curl --request GET \
  --url https://realtime-api.voiceflow.com/v1/stable/test \
  --header 'Authorization: Bearer <token>'

const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();

import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v1/stable/test?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()

{
  "tests": [
    {
      "id": "<string>",
      "name": "<string>",
      "settings": {
        "launchEvent": "<string>",
        "variableStates": []
      },
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "turnOrder": [
        "<string>"
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Voiceflow bearer token

Query Parameters

projectID

string

required

The ID of the project to operate on.

environmentAlias

string

required

The alias of the environment to operate on (e.g. main).

Response

200 - application/json

Returns every test defined on the project's environment, each with its launch settings and a turnOrder listing the IDs of its turns in execution order. The turns themselves are fetched separately.

tests

object[]

required

Show child attributes

string

required

name

string

required

settings

object

required

Show child attributes

launchEvent

string

required

variableStates

object

Show child attributes

Option 1

string

Option 2

Show child attributes

string

required

variableID

string

required

value

string

required

createdAt

string

required

updatedAt

string

required

turnOrder

string[]

required

The IDs of the test's turns, in execution order.

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks

List tests

Authorizations

Query Parameters

Response

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks