⚠️ SIP Billing Starts November 10, 2025 - See Ultravox Pricing for details.
Overview
Accounts
Agents
Calls, Messages, Stages
- Calls Overview
- GETList Calls
- GETGet Call
- POSTCreate Call
- DELDelete Call
- GETList Call Messages
- GETList Call Tools
- GETGet Call Recording
- GETList Call Stages
- GETGet Call Stage
- GETList Call Stage Messages
- GETList Call Stage Tools
- GETGet Call Stage Message Audio
- GETList Deleted Calls
- GETGet Deleted Call
- GETList Call Events
- GETGet Sip Logs for a call
- POSTSend Data Message to Call
Corpora, Query, Sources
- Corpus Service (RAG) Overview
- GETList Corpora
- POSTCreate Corpus
- GETGet Corpus
- PATCHUpdate Corpus
- DELDelete Corpus
- POSTQuery Corpus
- GETList Corpus Sources
- POSTCreate Corpus Source
- GETGet Corpus Source
- PATCHUpdate Corpus Source
- DELDelete Corpus Source
- GETList Corpus Source Documents
- GETGet Corpus Source Document
- POSTCreate Corpus File Upload
Tools
Voices
Webhooks
SIP Configuration
⚠️ SIP Billing Starts November 10, 2025 - See Ultravox Pricing for details.
List Call Stage Messages
Returns all messages that were exchanged during a specific stage of a call
curl --request GET \
--url https://api.ultravox.ai/api/calls/{call_id}/stages/{call_stage_id}/messages \
--header 'X-API-Key: <api-key>'{
"results": [
{
"role": "MESSAGE_ROLE_UNSPECIFIED",
"text": "<string>",
"invocationId": "<string>",
"toolName": "<string>",
"errorDetails": "<string>",
"medium": "MESSAGE_MEDIUM_UNSPECIFIED",
"callStageMessageIndex": 123,
"callStageId": "<string>",
"callState": {},
"timespan": {
"start": "<string>",
"end": "<string>"
},
"wallClockTimespan": {
"start": "<string>",
"end": "<string>"
}
}
],
"next": "http://api.example.org/accounts/?cursor=cD00ODY%3D\"",
"previous": "http://api.example.org/accounts/?cursor=cj0xJnA9NDg3",
"total": 123
}Authorizations
API key
Query Parameters
The pagination cursor value.
Number of results to return per page.
Response
Show child attributes
Show child attributes
The message's role.
MESSAGE_ROLE_UNSPECIFIED, MESSAGE_ROLE_USER, MESSAGE_ROLE_AGENT, MESSAGE_ROLE_TOOL_CALL, MESSAGE_ROLE_TOOL_RESULT The message text for user and agent messages, tool arguments for tool_call messages, tool results for tool_result messages.
The invocation ID for tool messages. Used to pair tool calls with their results.
The tool name for tool messages.
For failed tool calls, additional debugging information. While the text field is presented to the model so it can respond to failures gracefully, the full details are only exposed via the Ultravox REST API.
The medium of the message.
MESSAGE_MEDIUM_UNSPECIFIED, MESSAGE_MEDIUM_VOICE, MESSAGE_MEDIUM_TEXT The index of the message within the call stage.
The call stage this message appeared in.
If the message updated the call state, the new call state.
The timespan during the call when this message occurred, according to the input audio stream. This is only set for messages that occurred during the call (stage) and not for messages in the call's (call stage's) initial messages.
The timespan during the call when this message occurred, according the wall clock, relative to the call's joined time. This is only set for messages that occurred during the call (stage) and not for messages in the call's (call stage's) initial messages.
"http://api.example.org/accounts/?cursor=cD00ODY%3D\""
"http://api.example.org/accounts/?cursor=cj0xJnA9NDg3"
123
curl --request GET \
--url https://api.ultravox.ai/api/calls/{call_id}/stages/{call_stage_id}/messages \
--header 'X-API-Key: <api-key>'{
"results": [
{
"role": "MESSAGE_ROLE_UNSPECIFIED",
"text": "<string>",
"invocationId": "<string>",
"toolName": "<string>",
"errorDetails": "<string>",
"medium": "MESSAGE_MEDIUM_UNSPECIFIED",
"callStageMessageIndex": 123,
"callStageId": "<string>",
"callState": {},
"timespan": {
"start": "<string>",
"end": "<string>"
},
"wallClockTimespan": {
"start": "<string>",
"end": "<string>"
}
}
],
"next": "http://api.example.org/accounts/?cursor=cD00ODY%3D\"",
"previous": "http://api.example.org/accounts/?cursor=cj0xJnA9NDg3",
"total": 123
}