---
title: "Read a prospect simulation teaser report"
method: GET
path: "/v1/public/prospect-sim/report/{token}"
tags: ["Prospect Simulation"]
---

# Read a prospect simulation teaser report

`GET /v1/public/prospect-sim/report/{token}`

## Request

- Base URL: `https://api.roark.ai`
- URL: `https://api.roark.ai/v1/public/prospect-sim/report/{token}`
- Auth: HTTP bearer

Public endpoint scoped by the unguessable report token. Returns a truncated teaser once the debrief is ready; the full report is gated behind claiming an account.

## Path parameters

- `token` string, required

## Response `200`

The teaser report (or its pending status)

- object
  - `data` object, required
    - `status` string, required
    - `agentLabel` string, required
    - `prospectName` string, nullable, required
    - `live` object, nullable, required
      - `total` number, required
      - `completed` number, required
      - `activeIndex` number, nullable, required
      - `calls` object[], required
        - `callId` string, required
        - `personaLabel` string, required
        - `state` 'queued' | 'in_progress' | 'completed' | 'failed', required
    - `teaser` object, nullable, required
      - `verdict` string, required
      - `verdictProse` string, required
      - `callCount` number, required
      - `checksPassed` number, required
      - `checksTotal` number, required
      - `scorecard` object[], required
        - `name` string, required
        - `passed` boolean, required
        - `passRatePct` number, nullable, required
      - `summary` object[], required
        - `heading` string, nullable, required
        - `body` string, required
      - `themes` object[], required
        - `title` string, required
        - `severity` string, required
        - `affectedCount` number, required
        - `totalCount` number, required
        - `summary` string, required
      - `lockedThemeCount` number, required
      - `statTiles` object[], required
        - `label` string, required
        - `value` string, required
        - `sub` string, nullable, required
      - `topFinding` object, nullable, required
        - `title` string, required
        - `body` string, required
      - `lockedFindingCount` number, required

## Other responses

- `404`: Not Found
- `500`: Internal Server Error

## Changes

> 188 revisions in range; 1 not diffed.

- **2026-10-11** `7dab5c606fa0`: 1 info
  - added the required property `data/live/calls/items/callId` to the response with the `200` status
- **2026-10-09** `e7b6b5cc7fa6`: 3 info
  - added the required property `data/teaser/lockedThemeCount` to the response with the `200` status
  - added the required property `data/teaser/summary` to the response with the `200` status
  - added the required property `data/teaser/themes` to the response with the `200` status
- **2026-10-02** `e76cbe417402`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/public/prospect-sim/report/:token/get.md)

---

[API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roarkhq/apis/roark-analytics-api/revisions/efc3377249d1?raw)
