List sessions
curl --request GET \
--url https://api.protoface.com/v1/sessions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.protoface.com/v1/sessions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.protoface.com/v1/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [],
"has_more": false,
"object": "list"
}{
"error": {
"code": "transport.unsupported",
"message": "transport.type=pipecat is not supported",
"param": "transport.type",
"request_id": "req_01HXY5K8E7QYG3X8Z6N9R7S0VR",
"type": "invalid_request"
}
}{
"error": {
"code": "transport.unsupported",
"message": "transport.type=pipecat is not supported",
"param": "transport.type",
"request_id": "req_01HXY5K8E7QYG3X8Z6N9R7S0VR",
"type": "invalid_request"
}
}{
"error": {
"code": "transport.unsupported",
"message": "transport.type=pipecat is not supported",
"param": "transport.type",
"request_id": "req_01HXY5K8E7QYG3X8Z6N9R7S0VR",
"type": "invalid_request"
}
}Realtime sessions
List sessions
List sessions for the calling org, newest first. Repeatable status filters OR together; the group aliases active and terminal expand to the underlying status set. created_after / created_before accept ISO-8601 UTC. Paginate with limit + starting_after=<last_session_id>.
List sessions
curl --request GET \
--url https://api.protoface.com/v1/sessions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.protoface.com/v1/sessions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.protoface.com/v1/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [],
"has_more": false,
"object": "list"
}{
"error": {
"code": "transport.unsupported",
"message": "transport.type=pipecat is not supported",
"param": "transport.type",
"request_id": "req_01HXY5K8E7QYG3X8Z6N9R7S0VR",
"type": "invalid_request"
}
}{
"error": {
"code": "transport.unsupported",
"message": "transport.type=pipecat is not supported",
"param": "transport.type",
"request_id": "req_01HXY5K8E7QYG3X8Z6N9R7S0VR",
"type": "invalid_request"
}
}{
"error": {
"code": "transport.unsupported",
"message": "transport.type=pipecat is not supported",
"param": "transport.type",
"request_id": "req_01HXY5K8E7QYG3X8Z6N9R7S0VR",
"type": "invalid_request"
}
}Authorizations
Live API key minted in the dashboard. Pass as Authorization: Bearer sk_live_…. Keys are scoped to a single environment (staging / prod).
Query Parameters
Repeatable filter. Accepts a SessionStatus value or the aliases active / terminal. Multiple values OR together.
Filter to sessions referencing this avatar.
Lower bound, inclusive. ISO-8601 UTC.
Upper bound, exclusive. ISO-8601 UTC.
Page size. Default 20, max 100.
Required range:
1 <= x <= 100Pagination cursor — a sess_… id from a previous page.

