Skip to main content
GET
cURL
Building AI-powered analysis on top of interaction data? Use the Alpharun MCP server instead of exporting interactions into your own system. It gives AI assistants and agents live, queryable access to interactions, transcripts, and playbook analytics — including semantic transcript search — with no data pipeline to build or keep in sync. This endpoint is best for listing records as part of a system integration, not for bulk-copying your Alpharun data.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

PLAYBOOK_ID
string<uuid>
required

ID of the playbook whose customer interactions to list.

Query Parameters

include_analysis
boolean
default:false

When true, include the analysis and outcome fields in each customer interaction. Defaults to false, in which case both fields are omitted.

cursor
string | null

Pagination cursor returned as next_cursor in a previous response. Omit on the first request.

start_date
string

Inclusive lower bound: only return customer interactions whose last_recorded_at is at or after this time. An ISO 8601 date or date-time, e.g. 2026-10-01 or 2026-10-01T09:00:00-07:00. A value without an offset is interpreted as UTC.

end_date
string

Exclusive upper bound: only return customer interactions whose last_recorded_at is before this time. An ISO 8601 date or date-time, e.g. 2026-11-01 or 2026-11-01T09:00:00-07:00. A value without an offset is interpreted as UTC, so start_date=2026-10-01&end_date=2026-11-01 covers October 2026 in UTC.

Response

List of customer interactions for the playbook

data
object
next_cursor
string | null

Cursor to pass as the cursor query parameter to fetch the next page. null when there are no more results.