curl --request GET \
--url https://api.bey.dev/v1/usage/sessions \
--header 'x-api-key: <api-key>'import requests
url = "https://api.bey.dev/v1/usage/sessions"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.bey.dev/v1/usage/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"date": "2026-10-01",
"used_seconds": 1830
}
]
}Retrieve Speech-to-Video Session Usage
Retrieve your speech-to-video usage per day.
A session counts on the day it was created, in UTC, once it has ended. The figures are seconds as your plan counts them, and cover every workspace of your organization, so only an API key of the default workspace can read them. Agent conversations and text-to-video are not included.
The days are UTC calendar days, so they do not line up with your billing period; Retrieve Usage gives the usage of your billing period. A range spans at most 366 days and 10,000 sessions; split a busier range into shorter ones.
curl --request GET \
--url https://api.bey.dev/v1/usage/sessions \
--header 'x-api-key: <api-key>'import requests
url = "https://api.bey.dev/v1/usage/sessions"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.bey.dev/v1/usage/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"date": "2026-10-01",
"used_seconds": 1830
}
]
}Authorizations
Your Beyond Presence API Key.
Query Parameters
First day to report, in UTC (YYYY-MM-DD).
Last day to report, in UTC (YYYY-MM-DD).
Response
Successful Response
Speech-to-video usage per day.
Every day of the requested range, oldest first.
Show child attributes
Show child attributes
Was this page helpful?