Skip to main content
GET
/
v1
/
tags
/
{tag}
/
sessions
Retrieve recent sessions for a specific tag
curl --request GET \
  --url https://api.roundtable.ai/v1/tags/{tag}/sessions \
  --header 'Authorization: Bearer <token>'
{
  "tag": "checkout-flow",
  "sessions": [
    {
      "session_id": "abc123def456",
      "tags": [
        "intake-survey",
        "checkout-flow"
      ],
      "risk_score": 75,
      "risk_explanation": "Multiple bot behaviors detected including programmatic typing and lack of corrections",
      "user_logs": [
        {
          "action": "Navigated to /dashboard",
          "user_time": "Mar 25, 2025 14:30:50",
          "unix_timestamp": 1743055850000
        }
      ],
      "biometric_checks": {
        "agent_behavior": "Not detected",
        "programmatic_typing": "Detected",
        "teleporting_mouse": "Not detected",
        "no_corrections": "Detected",
        "all_pasted": "Unknown",
        "jump_scrolling": "Detected",
        "centered_clicks": "Detected"
      },
      "device_checks": {
        "bot": "Detected",
        "virtual_machine": "Not detected",
        "vpn": "Detected",
        "tor": "Not detected",
        "location_spoofing": "Unknown"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.roundtable.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Use your secret API key as the bearer token

Path Parameters

tag
string
required

The tag to filter sessions by

Response

200 - application/json

Tag sessions retrieved successfully

tag
string

The tag identifier

Example:

"checkout-flow"

sessions
object[]

List of session data