GET /sessions — list call sessions across all agents

Returns session summaries across all agents in your account, ordered by start time (newest first). Use this endpoint to get a cross-agent view of activity, build dashboards, or export session metadata for compliance workflows. To list sessions for a single agent, you can either pass agent_id here or use GET /agents//sessions.

Endpoint

GET /api/v1/sessions

Requires masker_session authentication.

Query parameters

number

default:"25"

Maximum number of sessions to return. Accepted range: 1–100.

string

Pagination cursor from a previous response’s next_cursor. Omit to start from the first page.

string

default:"24h"

Return only sessions that started within this window. Accepts a duration string (1h, 24h, 7d, 30d) or an ISO 8601 UTC timestamp.

string

Filter results to sessions handled by this specific agent. Accepts an agt_* ULID.

string

Filter by session outcome. One of ok, error, or partial. Omit to return sessions of all statuses.

number

default:"0"

Return only sessions with at least this many PHI redactions.

Response fields

object[]

required

Array of session summary objects.

Show session summary fields

string

required

Session ID in sess_* ULID format.

string

required

ID of the agent that handled this session.

string

required

Display name of the agent that handled this session.

string

required

ISO 8601 UTC timestamp when the session started.

string

required

ISO 8601 UTC timestamp when the session ended.

number

required

Total session duration in milliseconds.

string

required

Outcome of the session: ok, error, or partial.

number

required

Total PHI detections redacted during this session.

object

required

Redaction counts per PHI category, e.g. {"PHONE": 1, "NAME": 2, "DOB": 1}.

string

required

The LLM model used for this session, e.g. gpt-4o-mini.

string | null

required

Cursor for the next page. null when you have reached the last page.

Example

curl -H "Cookie: masker_session=ey..." \
  "https://masker-voice.fly.dev/api/v1/sessions?since=24h&limit=50"

Response

{
  "data": [
    {
      "id": "sess_01HYZ...",
      "agent_id": "agt_01HYZ...",
      "agent_name": "appointment-bot-prod",
      "started_at": "2026-05-03T21:14:32Z",
      "ended_at": "2026-05-03T21:14:32.794Z",
      "duration_ms": 794,
      "status": "ok",
      "redaction_count": 4,
      "redactions_by_kind": {"PHONE": 1, "NAME": 2, "DOB": 1},
      "upstream_model": "gpt-4o-mini"
    }
  ],
  "next_cursor": "eyJ..."
}

Errors

Status	Code	Meaning
`401`	`unauthenticated`	Missing or invalid `masker_session` cookie
`422`	`validation_failed`	Bad query parameter value

Overview

Agents

Sessions

Proxy & Webhooks

GET /sessions — list call sessions across all agents

Endpoint

Query parameters

Response fields

Example

Errors

​Endpoint

​Query parameters

​Response fields

​Example

​Errors

Endpoint

Query parameters

Response fields

Example

Errors