> ## 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. # Get a call ## OpenAPI ````yaml api-reference/openapi.yaml GET /calls/{id} 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/{id}: get: tags: - Calls summary: One call operationId: getCall parameters: - $ref: '#/components/parameters/uuidId' responses: '200': description: The call content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/Call' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' components: parameters: uuidId: name: id in: path required: true schema: type: string format: uuid schemas: 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: 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 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. ````