Skip to main content
GET
/
v1
/
sessions
List Sessions
curl --request GET \
  --url https://api.bctrl.ai/v1/sessions \
  --header 'Authorization: Bearer <token>'
{
  "sessions": [
    {
      "id": "<string>",
      "hostId": "<string>",
      "status": "<string>"
    }
  ]
}

​
Examples

import { Bctrl } from '@bctrl/sdk';
const bctrl = new Bctrl({ apiKey: process.env.BCTRL_API_KEY! });

const sessions = await bctrl.sessions.list();
for (const s of sessions) {
  console.log(s.id, s.status);
}

​
Response

​
sessions
array
required
Array of session objects.
Response Example
[
  {
    "id": "sess_abc123",
    "hostId": "host_1",
    "status": "active"
  }
]