> ## 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 in a playlist

> Reads only data authorized for the current organization credential and resource permission.



## OpenAPI

````yaml /app-api/openapi.json get /playlists/{playlist_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:
  /playlists/{playlist_id}/calls:
    get:
      tags:
        - Playlists
      summary: List calls in a playlist
      description: >-
        Reads only data authorized for the current organization credential and
        resource permission.
      operationId: read_playlist_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: playlist_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.
                        position:
                          anyOf:
                            - type: number
                            - type: 'null'
                          description: Available numeric measure; null when not measured.
                        added_at:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: >-
                            ISO 8601 timestamp with time-zone offset; null when
                            unavailable.
                        call:
                          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/Def13'
                              description: >-
                                Persisted structured analysis data; null when
                                unavailable.
                            pillar_feedback:
                              $ref: '#/components/schemas/Def13'
                              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
                      required:
                        - id
                        - position
                        - added_at
                        - call
                      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:
    Def13:
      anyOf:
        - type: string
        - type: number
        - type: boolean
        - type: 'null'
        - type: array
          items:
            $ref: '#/components/schemas/Def13'
        - type: object
          propertyNames:
            type: string
          additionalProperties:
            $ref: '#/components/schemas/Def13'
  securitySchemes:
    organizationKey:
      type: http
      scheme: bearer
      bearerFormat: pk_org_live_<id>_<secret>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.