Voiceflow bearer token
Transcripts
Review your agent’s past conversations.
See Authentication for credentials and permissions.
Current - 2026/07
Finds recorded conversations matching a filter. Unlike the list calls elsewhere in this API, the body takes take and skip, so results arrive a page at a time.
Authentication
Query parameters
The ID of the project to operate on.
Request body
The maximum number of results to return, used for pagination.
The number of results to skip, used for pagination.
When provided, only transcripts created at or before this ISO 8601 timestamp are returned.
When provided, only transcripts from the draft or published version of the environment are returned. published covers the current release and every past release. Applies within a single environment; the main environment is used when environmentAlias is omitted.
draft, publishedWhen provided, only transcripts from this conversation session are returned.
When provided, only transcripts created at or after this ISO 8601 timestamp are returned.
When provided, only transcripts from the environment with this alias are returned.
When provided, only transcripts from the release with this exact name (e.g. V1.02) are returned, as listed in the releases of the environment. When several releases share the name, transcripts from all of them are returned. Applies within a single environment; the main environment is used when environmentAlias is omitted. Cannot be combined with version: "draft".
Response
Returns the transcripts matching the search, each with its session and user IDs, timestamps, recording URL, and any properties and evaluation results attached to it. The conversation logs are not included.
Legacy - 2026/11
Search transcripts by project ID, one compact row per transcript.
Authentication
Voiceflow bearer token
Query parameters
The ID of the project to operate on.
Request body
Page size, 1 to 50. There is no limit. Page with skip while hasMore is true.
The number of results to skip, used for pagination.
Only transcripts created at or after this day (2026-06-01, from 00:00 UTC) or ISO 8601 timestamp.
Only transcripts created at or before this day (2026-06-30, to 23:59:59.999 UTC) or ISO 8601 timestamp.
When provided, only transcripts from the draft or published version of the environment are returned. published covers the current release and every past release. Applies within a single environment; the main environment is used when environmentAlias is omitted.
draft, publishedWhen provided, only transcripts from this conversation session are returned.
When provided, only transcripts from the environment with this alias are returned.
When provided, only transcripts from the release with this exact name (e.g. V1.02) are returned, as listed in the releases of the environment. When several releases share the name, transcripts from all of them are returned. Applies within a single environment; the main environment is used when environmentAlias is omitted. Cannot be combined with version: "draft".
Response
True when the page is full, so more transcripts may match. Page with skip.
Find a pattern in the dialogue of many transcripts.
Authentication
Voiceflow bearer token
Query parameters
The ID of the project to operate on.
Request body
Regex (case-insensitive) or plain text to find in the dialogue. A pattern may hold one open quantifier (*, +, ?, {n,} or {n,m}), no backreference and no alternation inside a group. Use exact counts such as \d{3}, or put the alternation at the top level: refund|return. Any other pattern runs as plain text, and the result says so.
Transcripts to scan. Leave it out to scan the newest transcripts in the date range.
Lower bound when no transcriptIDs are given: a day or a timestamp.
Upper bound when no transcriptIDs are given: a day or a timestamp.
Only transcripts from this environment, when no transcriptIDs are given.
How many transcripts to scan at most, 1 to 60.
Response
Transcripts scanned.
Transcripts with at least one match.
More transcripts were in the range, or more unique transcriptIDs were given, than were scanned; note says what to do.
Transcripts whose log could not be read.
Given transcriptIDs that do not belong to this project.
The pattern ran as plain text; note says why.
trueCurrent - 2026/07
Returns one recorded conversation, including the turns exchanged and the traces behind them. Set filterConversation to keep only text, speak, and live-agent-handoff traces, plus any types listed in customTraceTypes.
Authentication
Voiceflow bearer token
Path parameters
The ID of the transcript to operate on.
Query parameters
The ID of the project to operate on.
When true, only text, speak, and live-agent-handoff traces are returned. Omit it or set false to return the full log.
Extra trace types to keep when filterConversation is true. Ignored when the filter is off. Accepts one type or an array.
Response
Returns a single transcript along with its logs, which the search operation leaves out, plus its properties, evaluation results, and recording URL.
Legacy - 2026/11
Get a transcript by ID, in the chosen view.
Authentication
Voiceflow bearer token
Path parameters
Query parameters
The ID of the project to operate on.
summary (default): the turns, the tool calls and a turn count. formatted: every turn with the debug traces and the first system prompt of each agent. logs: the raw log entries, which can be very large.
summary, formatted, logsOnly with format: "logs". When enabled, only text, speak and live-agent-handoff traces are returned.
Only with format: "logs". Additional trace types to return when filterConversation is enabled.
Response
Returns the files attached to one transcript that Voiceflow stores, each with a presigned download URL; files referenced only by an external URL are left out. The call is unpaginated: it takes no paging parameters, so one request yields the whole set.
Authentication
Voiceflow bearer token
Path parameters
The ID of the transcript to operate on.
Query parameters
The ID of the project to operate on.
Response
Returns the transcript's stored files, each with a stable ID, MIME type, original filename and size when recorded, a presigned GET URL, and the timestamp after which that URL stops working.
The files attached to the transcript that are stored on Voiceflow.
Searches one recorded conversation's log by entry kind, level, debug kind, turn or text, and returns the matches a page at a time. Use it to find errors or tool calls without reading the whole transcript.
Authentication
Voiceflow bearer token
Path parameters
The ID of the transcript to operate on.
Query parameters
The ID of the project to operate on.
Request body
Keep only entries of these kinds. Omit to keep every kind.
Keep only entries at these levels, for example ["fatal", "error", "warn"] for what went wrong.
Keep only debug entries of these kinds. Setting it leaves out every entry that is not a debug log.
Keep only entries of these turns. Turn 0 holds anything logged before the first input.
Keep only entries whose message or recorded data contains this text, ignoring case. It is plain text, not a regular expression. Separate alternatives with |, as in "timeout|denied", to keep entries that contain any of them.
The most entries to return in one page.
How many matching entries to skip, for paging.
Response
Returns the matching entries for this page, with the number of matches, the whole log's entry counts and token use per model, and the offset to send for the next page.
Entries in the whole log.
The last turn the log reaches.
How many entries of each kind, level and debug kind the whole log holds, before any filter.
Token use per model over the whole log, largest first.
Entries that pass every filter.
The offset of the next page, or null when this page reaches the last match.
True when the page stopped before limit to stay under about 30,000 tokens. Continue from nextOffset.