> ## Documentation Index > Fetch the complete documentation index at: https://docs.trailercast.io/llms.txt > Use this file to discover all available pages before exploring further. # Decision Room metrics ## OpenAPI ````yaml api-reference/openapi.yaml GET /decision-rooms/{id}/metrics openapi: 3.1.0 info: title: TrailerCast Integration API version: 1.0.0 summary: >- Read-only access to call summaries, prospect engagement and Decision Room metrics, plus signed webhooks. description: > Read-only, workspace-scoped API for pulling the deal signals TrailerCast captures during a sale, and outbound webhooks for near-real-time notification. Start with the guides in this section (Introduction, Quickstart, Authentication, Webhooks); the endpoint pages below are generated from this spec. **Authentication.** Data endpoints take an API key: `Authorization: Bearer tck_live_…`. Management endpoints take an admin session JWT with the `integrations.crm` permission. **Pagination.** Every list is keyset-paginated and ascending: `{ data, nextCursor, hasMore }`. Pass `cursor=` to continue. `limit` 1–500, default 100. **Rate limit.** 300 requests/minute per API key; `429` with `Retry-After` when exceeded. **Versioning.** Breaking changes ship as a new path (`/api/v2`). Additive changes (new fields, event types, parameters) may ship at any time; ignore what you do not recognise. contact: name: TrailerCast url: https://trailercast.io servers: - url: https://{host}/api/v1 variables: host: default: trailercst-backend-production.up.railway.app description: Your TrailerCast API host. - url: http://localhost:5000/api/v1 description: Local development security: - apiKey: [] tags: - name: Status - name: Calls - name: Engagement - name: Decision Rooms - name: Webhook deliveries - name: Management — API keys - name: Management — Webhooks paths: /decision-rooms/{id}/metrics: get: tags: - Decision Rooms summary: Everything that happened in one room, rolled up operationId: getRoomMetrics parameters: - $ref: '#/components/parameters/uuidId' responses: '200': description: The metrics content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/RoomMetrics' '404': $ref: '#/components/responses/NotFound' components: parameters: uuidId: name: id in: path required: true schema: type: string format: uuid schemas: RoomMetrics: type: object properties: room: $ref: '#/components/schemas/Room' engagementScore: type: integer minimum: 0 maximum: 100 description: > Documented heuristic: recency (≤3d 40 · ≤7d 30 · ≤14d 20 · ≤30d 10) + breadth (10 per engaged person, max 30) + depth (best completion % × 0.15 max 15, plus 5 per document opened max 15). totals: type: object properties: events: type: integer engagedPeople: type: integer silentPeople: type: integer lastActivityAt: type: - string - 'null' format: date-time trailerViews: type: integer watchSeconds: type: integer bestCompletionPercent: type: integer docsOpened: type: integer stakeholders: type: array items: $ref: '#/components/schemas/Stakeholder' trailers: type: array items: type: object properties: id: type: string format: uuid title: type: - string - 'null' kind: type: string durationSeconds: type: - integer - 'null' recipients: type: integer views: type: integer watchSeconds: type: integer bestCompletionPercent: type: integer assets: type: array items: type: object properties: id: type: string format: uuid title: type: string category: type: string example: pricing uploadedByProspect: type: boolean libraryAssetId: type: - string - 'null' opens: type: integer uniqueViewers: type: integer totalSeconds: type: integer description: Reading time across all viewers. lastViewedAt: type: - string - 'null' format: date-time viewers: type: array items: type: object properties: distributionId: type: string format: uuid email: type: - string - 'null' format: email name: type: - string - 'null' seconds: type: integer sessions: type: integer lastViewedAt: type: - string - 'null' format: date-time actionPlan: type: object properties: total: type: integer done: type: integer doneByProspect: type: integer overdue: type: integer lastCompletedAt: type: - string - 'null' format: date-time conversation: type: object properties: prospectMessages: type: integer sellerMessages: type: integer lastMessageAt: type: - string - 'null' format: date-time esign: type: object properties: status: oneOf: - $ref: '#/components/schemas/EsignStatus' - type: 'null' documents: type: array items: type: object properties: id: type: string vendor: type: string envelopeId: type: string subject: type: - string - 'null' status: $ref: '#/components/schemas/EsignStatus' recipientCount: type: - integer - 'null' sentAt: type: - string - 'null' format: date-time firstViewedAt: type: - string - 'null' format: date-time lastEventAt: type: - string - 'null' format: date-time completedAt: type: - string - 'null' format: date-time declinedAt: type: - string - 'null' format: date-time Room: type: object required: - id - name - status - owner - createdAt - lastActivityAt properties: id: type: string format: uuid name: type: string description: The prospect company name. slug: type: string status: $ref: '#/components/schemas/RoomStatus' owner: $ref: '#/components/schemas/Owner' primaryContactEmail: type: - string - 'null' format: email expectedCloseDate: type: - string - 'null' format: date description: Calendar date YYYY-MM-DD no time zone.: null dealValueCents: type: - integer - 'null' sourceCallId: type: - string - 'null' format: uuid createdAt: type: string format: date-time lastActivityAt: type: string format: date-time closedAt: type: - string - 'null' format: date-time Stakeholder: type: object properties: email: type: - string - 'null' format: email name: type: - string - 'null' role: type: - string - 'null' title: type: - string - 'null' inCommittee: type: boolean description: Listed in the room's People section. status: type: string enum: - engaged - dormant - silent trailerViews: type: integer trailerCompletes: type: integer watchSeconds: type: integer bestCompletionPercent: type: integer roomVisits: type: integer docOpens: type: integer docsOpened: type: integer mapCheckoffs: type: integer comments: type: integer messages: type: integer forwards: type: integer lastActivityAt: type: - string - 'null' format: date-time EsignStatus: type: string enum: - sent - delivered - viewed - signed_partial - completed - declined - voided Error: type: object required: - error properties: error: type: string description: Human-readable; not stable. code: type: string description: Stable machine code. RoomStatus: type: string enum: - open - won - lost - dormant Owner: type: object properties: id: type: integer example: 42 name: type: - string - 'null' email: type: - string - 'null' format: email responses: NotFound: description: >- Not found — or belongs to another workspace (indistinguishable by design) content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Not found code: NOT_FOUND securitySchemes: apiKey: type: http scheme: bearer bearerFormat: tck_live_… description: Workspace API key minted via POST /api-keys. Read-only. ````