> ## 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. # List calls ## OpenAPI ````yaml api-reference/openapi.yaml GET /calls 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: /calls: get: tags: - Calls summary: List completed calls with AI summaries, oldest-updated first operationId: listCalls parameters: - $ref: '#/components/parameters/cursorOpaque' - $ref: '#/components/parameters/limit' - name: updated_since in: query schema: type: string format: date-time description: Only calls updated at or after this instant (ISO-8601). - name: kind in: query schema: type: string enum: - demo - qualifying_call - meeting - name: buyer_space_id in: query schema: type: string format: uuid description: Only calls attached to this Decision Room. - name: has_summary in: query schema: type: string enum: - 'true' description: Only calls with an AI summary. responses: '200': description: A page of calls content: application/json: schema: allOf: - $ref: '#/components/schemas/Page' - type: object properties: data: type: array items: $ref: '#/components/schemas/Call' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' components: parameters: cursorOpaque: name: cursor in: query schema: type: string description: Opaque cursor from a previous nextCursor. Only valid for this endpoint. limit: name: limit in: query schema: type: integer minimum: 1 maximum: 500 default: 100 schemas: Page: type: object required: - data - nextCursor - hasMore properties: data: type: array items: {} nextCursor: type: - string - 'null' description: >- Pass back as `cursor`. Returned even when hasMore is false so you can resume later. Never expires. hasMore: type: boolean Call: type: object required: - id - kind - status - occurredAt - updatedAt - owner - participants - hasSummary properties: id: type: string format: uuid kind: type: string enum: - demo - qualifying_call - meeting title: type: - string - 'null' prospectName: type: - string - 'null' status: type: string example: completed occurredAt: type: string format: date-time completedAt: type: - string - 'null' format: date-time updatedAt: type: string format: date-time description: Bumps when the summary is regenerated. durationSeconds: type: - integer - 'null' owner: $ref: '#/components/schemas/Owner' buyerSpaceId: type: - string - 'null' format: uuid participants: type: array items: $ref: '#/components/schemas/Participant' talkTime: type: - object - 'null' properties: source: type: - string - 'null' enum: - multi_track - diarized_fallback - speaker_timeline - null totalSpeakerSeconds: type: - number - 'null' hasSummary: type: boolean summary: oneOf: - $ref: '#/components/schemas/CallSummary' - type: 'null' deal: type: object description: What a connected HubSpot/Salesforce reported for this call, if any. properties: status: type: - string - 'null' enum: - won - lost - pending - null valueCents: type: - integer - 'null' disqualifiedAt: type: - string - 'null' format: date-time disqualifiedReason: type: - string - 'null' Owner: type: object properties: id: type: integer example: 42 name: type: - string - 'null' email: type: - string - 'null' format: email Participant: type: object properties: name: type: - string - 'null' email: type: - string - 'null' format: email description: Lower-cased. role: type: - string - 'null' description: Rep-entered role free text.: null isHost: type: boolean isInternal: type: boolean description: The seller's side (host self: null or the owner's email domain).: null talkSeconds: type: - number - 'null' talkPercent: type: - number - 'null' sources: type: array items: type: string enum: - calendar - talk_time - attendees CallSummary: type: object description: >- Normalised AI summary. Fields the schema does not produce are null / []. Nothing is invented. properties: schema: type: string enum: - meeting - qualifying_call headline: type: - string - 'null' company: type: - string - 'null' participants: type: array items: type: string description: Free-text names/roles from the AI. keyTakeaways: type: array items: type: string decisions: type: array items: type: string actionItems: type: array items: type: string nextSteps: type: array items: type: string openQuestions: type: array items: type: string painPoints: type: array items: type: string currentState: type: array items: type: string desiredOutcomes: type: array items: type: string decisionCriteria: type: array items: type: string timeline: type: - string - 'null' budgetSignals: type: - string - 'null' qualificationVerdict: type: - string - 'null' enum: - qualified - maybe - not_qualified - null verdictReasoning: type: - string - 'null' contextForNextCall: type: - string - 'null' topics: type: array items: $ref: '#/components/schemas/Topic' Error: type: object required: - error properties: error: type: string description: Human-readable; not stable. code: type: string description: Stable machine code. Topic: type: object properties: label: type: - string - 'null' summary: type: - string - 'null' startSeconds: type: - number - 'null' endSeconds: type: - number - 'null' responses: BadRequest: description: Invalid input content: application/json: schema: $ref: '#/components/schemas/Error' example: error: cursor is not a valid cursor for this endpoint. code: INVALID_CURSOR Unauthorized: description: >- Missing, invalid or revoked API key; or a session token on a data endpoint content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Invalid API key. code: API_KEY_INVALID RateLimited: description: Rate limit exceeded (300/min per key) headers: Retry-After: schema: type: integer description: Seconds to wait content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: http scheme: bearer bearerFormat: tck_live_… description: Workspace API key minted via POST /api-keys. Read-only. ````