> ## Documentation Index > Fetch the complete documentation index at: https://developers.goparlay.io/llms.txt > Use this file to discover all available pages before exploring further. # List calls linked to a deal > Reads only data authorized for the current organization credential and resource permission. ## OpenAPI ````yaml /app-api/openapi.json get /deals/{deal_id}/calls openapi: 3.1.0 info: title: Parlay App API version: '2026-10-23' description: >- Read and act on your organization's Parlay data from your own systems: calls, transcripts, scores, coaching, reps, teams, analytics, deals, playbooks, training, webhooks and exports. Authenticate with an organization API key. servers: - url: https://app.goparlay.io/api/v1 security: - organizationKey: [] tags: - name: Account description: Who the key belongs to, what it can do, and the limits that apply. - name: Calls description: Call history, the change feed, scores, analysis and coaching. - name: Transcripts description: Transcript text, timed segments and transcript search. - name: Comments description: Timestamped coaching comments on calls. - name: Reps and teams description: Your organization, its reps and its teams. - name: Analytics description: Organization, team and rep performance over a reporting window. - name: Deals and CRM description: Deal outcomes, deals, accounts, contacts and pipeline stages. - name: Playbook description: Your playbook, scorecard and trackers. - name: Playlists description: Organization playlists of calls. - name: Training description: Courses, enrollments, progress and certificates. - name: Usage and audit description: Request usage and the organization audit trail. paths: /deals/{deal_id}/calls: get: tags: - Deals and CRM summary: List calls linked to a deal description: >- Reads only data authorized for the current organization credential and resource permission. operationId: read_deal_calls parameters: - name: limit in: query required: false schema: description: Maximum results per page; up to 100. type: integer minimum: 1 maximum: 100 - name: cursor in: query required: false schema: description: >- Opaque cursor from the previous response; keep other filters unchanged. type: string minLength: 1 maxLength: 4096 - name: deal_id in: path required: true schema: type: string pattern: >- ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ responses: '200': description: Successful scoped read. content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string pattern: >- ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ description: Stable Parlay UUID. title: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. recorded_at: anyOf: - type: string - type: 'null' description: >- ISO 8601 timestamp with time-zone offset; null when unavailable. created_at: anyOf: - type: string - type: 'null' description: >- ISO 8601 timestamp with time-zone offset; null when unavailable. updated_at: anyOf: - type: string - type: 'null' description: >- ISO 8601 timestamp with time-zone offset; null when unavailable. duration_seconds: anyOf: - type: number - type: 'null' description: Available numeric measure; null when not measured. type: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. status: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. rep: type: object properties: id: type: string pattern: >- ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ description: Stable Parlay UUID. first_name: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. last_name: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. required: - id - first_name - last_name additionalProperties: false deal_status: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. analysis_version: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. scores: type: object properties: overall: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. clarity: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. objection: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. closing: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. discovery: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. influence: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. persuasiveness: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. question: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. speech: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. required: - overall - clarity - objection - closing - discovery - influence - persuasiveness - question - speech additionalProperties: false summary: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. evaluation: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. action_plan: $ref: '#/components/schemas/Def10' description: >- Persisted structured analysis data; null when unavailable. pillar_feedback: $ref: '#/components/schemas/Def10' description: >- Persisted structured analysis data; null when unavailable. organization_feedback: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. double_down: anyOf: - type: string - type: 'null' description: Available text; null when not recorded. metrics: type: object properties: words_per_minute: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. talk_listen_ratio: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. filler_word_count: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. questions_asked: anyOf: - type: number - type: 'null' description: >- Available numeric measure; null when not measured. required: - words_per_minute - talk_listen_ratio - filler_word_count - questions_asked additionalProperties: false required: - id - title - recorded_at - created_at - updated_at - duration_seconds - type - status - rep - deal_status - analysis_version - scores - summary - evaluation - action_plan - pillar_feedback - organization_feedback - double_down - metrics additionalProperties: false has_more: type: boolean description: Whether another page is available. next_cursor: anyOf: - type: string - type: 'null' description: Opaque cursor; null when no page remains. required: - data - has_more - next_cursor additionalProperties: false '400': description: Invalid query or cursor '401': description: Invalid or expired credential '403': description: Permission required '404': description: Resource unavailable or outside access '409': description: Source changed; restart pagination '429': description: Request budget exceeded '503': description: Service temporarily unavailable components: schemas: Def10: anyOf: - type: string - type: number - type: boolean - type: 'null' - type: array items: $ref: '#/components/schemas/Def10' - type: object propertyNames: type: string additionalProperties: $ref: '#/components/schemas/Def10' securitySchemes: organizationKey: type: http scheme: bearer bearerFormat: pk_org_live__ ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.