Voiceflow bearer token
Get turn
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/test-turn/<turnID> \
--header 'Authorization: Bearer <token>'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-turn/<turnID>?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-turn/<turnID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
)
data = response.json()vf test turn get --turn-id <turnID> --project-id <projectID> --environment-alias <environmentAlias>{
"turn": {
"id": "<string>",
"testID": "<string>",
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z",
"type": "user",
"payload": {
"response": "<string>",
"variableStates": "<string>"
}
}
}Returns a single test turn by ID, with the fields that define it. A test turn is one side of a scripted conversation, either what the user says or the agent reply the checks assert on.
GET
/v1/stable/test-turn/{turnID}
Get turn
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/test-turn/<turnID> \
--header 'Authorization: Bearer <token>'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/test-turn/<turnID>?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-turn/<turnID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
)
data = response.json()vf test turn get --turn-id <turnID> --project-id <projectID> --environment-alias <environmentAlias>{
"turn": {
"id": "<string>",
"testID": "<string>",
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z",
"type": "user",
"payload": {
"response": "<string>",
"variableStates": "<string>"
}
}
}Authorizations
Query Parameters
Response
200 - application/jsonReturns one turn: the testID it belongs to, the payload for its type, and, on an agent turn, the checkOrder naming the checks that run against it.
Show child attributes
Option 1
Show child attributes
Option 2
Show child attributes
Option 3
Show child attributes
Show child attributes
Show child attributes
Option 1
string
Option 2
PersonaItem — see its attributes above
Was this page helpful?
Thanks for your feedback.