GET
/
api
/
accounts
/
me
/
usage
/
calls
cURL
curl --request GET \
  --url https://api.ultravox.ai/api/accounts/me/usage/calls \
  --header 'X-API-Key: <api-key>'
{
  "allTime": {
    "totalCount": 123,
    "duration": "<string>",
    "joinedCount": 123,
    "billedMinutes": 123
  },
  "daily": [
    {
      "totalCount": 123,
      "duration": "<string>",
      "joinedCount": 123,
      "billedMinutes": 123,
      "date": "2023-12-25"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

API key

Query Parameters

​
agentIds
string<uuid>[]

Filter calls by the agent IDs.

​
durationMax
string

Maximum duration of calls

​
durationMin
string

Minimum duration of calls

​
fromDate
string<date>

Start date (inclusive) for filtering calls by creation date

​
metadata
object

Filter calls by metadata. Use metadata.key=value to filter by specific key-value pairs.

​
search
string

The search string used to filter results

Minimum length: 1
​
toDate
string<date>

End date (inclusive) for filtering calls by creation date

​
voiceId
string<uuid>

Filter calls by the associated voice ID

Response

200 - application/json
​
allTime
object
required

All-time call usage

​
daily
object[]
required

Call usage per day