⚠️ 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 Corpora
Returns details for all corpora
curl --request GET \
--url https://api.ultravox.ai/api/corpora \
--header 'X-API-Key: <api-key>'{
"results": [
{
"corpusId": "<string>",
"created": "2023-11-07T05:31:56Z",
"name": "<string>",
"description": "<string>",
"stats": {
"status": "CORPUS_STATUS_UNSPECIFIED",
"lastUpdated": "2023-11-07T05:31:56Z",
"numChunks": 123,
"numDocs": 123,
"numVectors": 123
}
}
],
"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 unique ID of this corpus.
When this corpus was created.
The name of this corpus.
A description of this corpus.
The current stats for this corpus.
Show child attributes
Show child attributes
The current status of this corpus, indicating whether it is queryable.
CORPUS_STATUS_UNSPECIFIED, CORPUS_STATUS_EMPTY, CORPUS_STATUS_INITIALIZING, CORPUS_STATUS_READY, CORPUS_STATUS_UPDATING The last time the contents of this corpus were updated.
The number of chunks in this corpus. Chunks are subsets of documents.
The number of documents in this corpus.
The number of vectors in this corpus. Vectors are used for semantic search. Multiple vectors may correspond to a single chunk.
"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/corpora \
--header 'X-API-Key: <api-key>'{
"results": [
{
"corpusId": "<string>",
"created": "2023-11-07T05:31:56Z",
"name": "<string>",
"description": "<string>",
"stats": {
"status": "CORPUS_STATUS_UNSPECIFIED",
"lastUpdated": "2023-11-07T05:31:56Z",
"numChunks": 123,
"numDocs": 123,
"numVectors": 123
}
}
],
"next": "http://api.example.org/accounts/?cursor=cD00ODY%3D\"",
"previous": "http://api.example.org/accounts/?cursor=cj0xJnA9NDg3",
"total": 123
}